CreateGISServerConnectionFile

描述

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

说明

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

相关函数：

• CreateMapSDDraft
• CreateGPSDDraft
• CreateImageSDDraft
• CreateGeocodeSDDraft

语法

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 —空间数据服务器服务器类型 旧版本： 如果您正在使用 SPATIAL_DATA_SERVER server_type，则自 ArcGIS 10.2.1 for Desktop 起，仅支持 USE_GIS_SERVICES connection_type。ARCGIS_SERVER server_type 支持所有 connection_type。 (默认值为 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)