ArcMap

CreateGISServerConnectionFile

描述

此函数创建可连接到 GIS 服务器的连接文件。

讨论

此函数创建可连接到 ArcGIS Server 或 Spatial Data Server 的连接文件。该连接文件随后可用于发布 GIS 服务。例如，CreateGISServerConnectionFile 可以同 CreateMapSDDraft、过渡服务和上传服务定义一起使用使地图发布过程达到完全自动化。

相关函数：

语法

CreateGISServerConnectionFile (connection_type, out_folder_path, out_name, server_url, server_type, {use_arcgis_desktop_staging_folder}, {staging_folder_path}, {username}, {password}, {save_username_password})
参数说明数据类型
connection_type

用于表示连接类型的字符串。可以创建一个连接以使用、发布或管理 GIS 服务。

  • USE_GIS_SERVICES —使用 GIS 服务。
  • PUBLISH_GIS_SERVICES —发布 GIS 服务。
  • ADMINISTER_GIS_SERVICES —管理 GIS 服务。
String
out_folder_path

将存储 .ags 文件的文件夹路径。输入 GIS 服务器的值可将 .ags 文件放置于目录窗口的 GIS 服务器节点中。

String
out_name

.ags 文件的名称。输出文件扩展名必须以 .ags 结尾。

String
server_url

表示服务器 URL 的字符串。

String
server_type

表示服务器类型的字符串。

  • ARCGIS_SERVER —ArcGIS Server 服务器类型
  • SPATIAL_DATA_SERVER —空间数据服务器服务器类型

(默认值为 ARCGIS_SERVER)

String
use_arcgis_desktop_staging_folder

此布尔值用于确定是否使用 ArcGIS Desktop 的过渡文件夹。如果设置为 true，则无需输入 staging_folder_path，因为将使用 ArcGIS Desktop 的过渡文件夹。仅当 connection_type 为 PUBLISH_GIS_SERVICES 或 ADMINISTER_GIS_SERVICES 时，才会使用此参数。

(默认值为 True)

Boolean
staging_folder_path

表示过渡文件夹路径的字符串。如果要使用此连接创建和保存服务定义，可选择服务定义文件在磁盘上的过渡位置。默认情况下，它们将过渡保存在本地计算机上的文件夹中。如果此参数设置为 None，则将使用 ArcGIS Desktop 的过渡文件夹。仅当 connection_type 为 PUBLISH_GIS_SERVICES 或 ADMINISTER_GIS_SERVICES 时，才会使用此参数。

String
username

用于表示 GIS 服务器用户名的字符串。

String
password

用于表示 GIS 服务器密码的字符串。

String
save_username_password

此布尔值用于表示 GIS 服务器的用户名和密码是否将保存在连接文件中。

  • SAVE_USERNAME — 在连接文件中保存用户名和密码。
  • DO_NOT_SAVE_USERNAME — 不在连接文件中保存用户名和密码。

(默认值为 True)

Boolean

代码示例

CreateGISServerConnectionFile 示例 1

以下脚本可在用户定义的文件夹中创建 ArcGIS Server 管理连接文件。

import arcpy
outdir = 'C:/Project'
out_folder_path = outdir
out_name = 'test.ags'
server_url = 'http://MyServer:6080/arcgis/admin'
use_arcgis_desktop_staging_folder = False
staging_folder_path = outdir
username = 'admin'
password = 'admin'
    
arcpy.mapping.CreateGISServerConnectionFile("ADMINISTER_GIS_SERVICES",
                                            out_folder_path,
                                            out_name,
                                            server_url,
                                            "ARCGIS_SERVER",
                                            use_arcgis_desktop_staging_folder,
                                            staging_folder_path,
                                            username,
                                            password,
                                            "SAVE_USERNAME")
CreateGISServerConnectionFile 示例 2

以下脚本可在目录窗口的 GIS 服务器节点中创建 ArcGIS Server 用户连接文件。

import arcpy
out_folder_path = 'GIS Servers'
out_name = 'test.ags'
server_url = 'http://MyServer:6080/arcgis/services'
   
arcpy.mapping.CreateGISServerConnectionFile("USE_GIS_SERVICES",
                                            out_folder_path,
                                            out_name,
                                            server_url,
                                            "ARCGIS_SERVER",
                                            username='admin',
                                            password='admin',
                                            save_username_password=True)