使用 WMS 服务可用属性—ArcGIS Server

本主题将对使用系统生成的功能文件时可用的 WMS 服务属性进行介绍。

在 Manager 中访问 WMS 服务属性

您可以在 ArcGIS Server Manager 中填充或修改 WMS 服务属性。为此，请执行以下步骤：

打开 Manager 并登录。如需此步骤的帮助，请参阅登录 Manager。
单击服务 > 管理服务。
在管理服务模块中，找到您的服务并单击编辑。如果列表中未显示该服务，那么其可能位于站点（根）文件夹下的某一子文件夹内。
在编辑模块中，单击功能。
在功能列表中，单击 WMS 确保 WMS 项被启用。
在 WMS 配置列表中，选择在下方输入服务属性。
填充或修改 WMS 服务属性。
单击保存并重新启动。将立即应用对服务执行的编辑操作。

WMS 服务属性

下表列出了 WMS 服务的所有可用属性以及各属性的描述信息：


属性	描述
名称	OGC 服务类型。本属性由 ArcGIS Server 自动填充，且无法进行修改。
标题	用于创建 WMS 服务的地图或影像服务的名称。本属性由 ArcGIS Server 自动填充，且无法进行修改。
摘要	用于提供有关 WMS 服务附加信息的叙述性描述。例如： WMS service maintained by Acme Corporation. Contact: webmaster@wmt.acme.com. High-quality map showing eagle nests and possible nesting locations.
关键字	用于描述 WMS 服务的关键字或关键词组列表，有助于进行目录搜索。例如： map, bird, eagle, nest, site
在线资源	OnlineResource 属性用于列出 WMS 服务的 URL。要使 WMS 客户端与 WMS 服务正确通信，此为必需项。本属性由 ArcGIS Server 自动填充，且无法进行修改。
联系人	WMS 服务的主要联系人。例如： John Smith
联系人职位	WMS 服务联系人的职位。例如： IT Analyst
联系方组织	WMS 服务的创建组织。例如： NASA
地址类型	WMS 服务的创建组织使用的地址类型。例如： postal
Address	WMS 服务的创建组织的地址。例如： 380 New York Street
City	创建 WMS 服务的组织所在的城市。例如： Redlands
州或省	创建 WMS 服务的组织所在的州。例如： California
邮政编码	创建 WMS 服务的组织所在地的邮政编码。例如： 92373
国家/地区	创建 WMS 服务的组织所在的国家/地区。例如： USA
用于联系的语音电话	可以联系到 WMS 服务主要联系人的电话号码。例如： +1 909 793-2853
联系方式传真电话	可以联系到 WMS 服务主要联系人的传真号码。例如： +1 123 456-7890
联系人电子邮件地址	可以联系到 WMS 服务主要联系人的电子邮件地址。例如： user@host.com
费用	用于在访问 WMS 服务时描述要承担的费用的文本。例如： none
访问限制	用于描述有关访问和使用 WMS 服务时所受的限制和法律先决条件的文本信息。 For internal use only. Do not distribute.
SLD 路径或 URL	SLD 允许为每个 WMS 图层发布多个样式。如果要将 SLD 文件绑定到当前 WMS 服务，需要输入 SLD XML 文件的 SLD 路径或 URL 属性、网络共享或物理位置。要使 ArcGIS Server 正确读取 SLD XML 文件，ArcGIS Server 帐户必须具有该位置的访问权限。要了解 SLD 的详细信息，请参阅对 WMS 服务使用“样式化图层描述符”。
附加空间参考系统	此属性可用于将空间参考系统添加至 WMS 服务。默认情况下，WMS 服务只列出两种空间参考系统：EPSG:4326（对于 WMS 1.3.0 则为 CSR:84）和启用 WMS 的地图服务的空间参考。要列出其他空间参考系统，使用逗号 (,) 分隔空间参考系统。例如，EPSG:4267,EPSG:4269,EPSG:102113。 EPSG 命名空间（如 EPSG）和 EPSG ID（如 4267）必须用冒号 (:) 分隔，否则，服务器将忽略空间参考。
自定义空间参考系统	listCustomCRS 属性可用于在 WMS 服务中定义自定义投影或投影的熟知文本 (WKT) 表示。这意味着 WMS 的发布者和使用者都可以进行以下操作：将 ID 分配给自定义投影并通过 WMS 功能文件公布。使用 WKT 字符串覆盖现有投影。通过直接指定熟知文本请求采用特定投影的地图。
识别容差（像素）	此属性可让您定义在客户端单击屏幕时 GetFeatureInfo 操作为其返回要素信息的容差（以像素为单位）。例如，如果将 WMS 的像素容差定义为 10，则只要在屏幕上的 10 个要素像素内单击就会将信息返回给客户端。
使用地图文档中的图层名称	默认情况下，此选项为未选中状态，意味着将使用从零开始的整数表示 WMS 服务中的图层，即按照从上到下的顺序指示这些图层在内容列表中的位置。从 10.8 版本开始，不再限制可用于图层名称的字符数，WMS 服务器将在必要时为名称生成唯一标识符。注：服务器分配的名称不会影响标题。 WMS 服务器将通过字符替代（将字符替换为下划线）以及添加数值后缀分配唯一名称。这适用于以下情况：地图包含两个或多个同名图层。图层名称的开头为数字。图层名称包含空格或特殊字符，包括 ?,&,=,+,`,#,%,^,{},[],<>,,,\|," 注：后缀编号是基于原始字符串计算的值，不是随机数。同样，只要未修改图层名称，该数字就会保持不变。例如，如果存在名为 Layer "1" 和 Layer [1] 的两个图层，则这两个图层都将转换为 Layer__1_。要区分这两个图层，需要将唯一编号作为后缀附加到修改后的字符串。在此示例中，修改后的图层名称将分别为 Layer__1_1234 和 Layer__1_1256。
基于宽和高强制地图重新调整纵横比	此属性用于确定是否遵循地图尺寸显示。默认情况下，此选项为未选中状态，意味着表示地图区域的像素会经过拉伸，以符合 WMS 客户端请求的高度和宽度。如果选中此选项，则像素高度和宽度比将保持不变。请求显示整个地图范围时，可能不会填满整个视图区域。
为图层分配名称标识符	默认情况下，WMS 服务不为图层组分配 <名称>。 namedLayersMode 属性可用于控制如何为 WMS 服务中的图层分配名称标识符。如果将该属性设置为 allLayers，则将为图层组及其子图层分配名称标识符。如果将其设置为 subLayers 或未指定，则仅为图层组的子图层分配名称标识符。这意味着客户端不能在 GetMap 请求中包含图层组，但必须在图层组中指定每个单独的子图层。

在 Administrator Directory 中设置属性

可以使用 ArcGIS Server Manager 配置大多数属性。如果无法使用 Manager 修改属性，则可以使用 ArcGIS Server Administrator Directory 对其进行修改或添加。

要使用该目录编辑属性，请执行以下步骤：

在浏览器中打开管理员目录并登录。该目录的典型 URL 是 https://gisserver.domain.com:6443/arcgis/admin/。
单击服务。
在文件夹页面中，单击要编辑的已启用 WMS 的地图服务的名称。如果列表中未显示该服务，则其可能位于根文件夹下的子文件夹中。
在服务页面上，滚动至底部并单击编辑。
在服务属性对话框中，找到"typeName": "WMSServer"部分。

在属性部分中，添加属性，然后指定所需的参数，例如：

"properties": {
   "name": "SampleWorldCities",
   "title": "WMS",
   "abstract": "",
   "keyword": "",
   "onlineResource": "",
   "contactPerson": "",
   "contactPosition": "",
   "contactOrganization": "",
   "address": "",
   "addressType": "",
   "city": "",
   "stateOrProvince": "",
   "postCode": "",
   "country": "",
   "contactVoiceTelephone": "",
   "contactFacsimileTelephone": "",
   "contactElectronicMailAddress": "",
   "fees": "",
   "accessConstraints": "",

   "customGetCapabilities": "false",
   "pathToCustomGetCapabilitiesFiles": "",

   "pathToCustomSLDFile": "",
   "listSupportedCRS": "",
   "listCustomCRS": "",
   "identifyToleranceInPixel": "10",
   "inheritLayerNames": "false",
   "reaspect": "true",
   "namedLayersMode": "subLayers",
}

单击保存编辑。

这些属性将添加至 WMS。

服务属性中的特殊字符

以下字符不能包含在任何服务属性中：&、<、>、"、'。如果您需要使用这些字符之一，则必须从下表中替换适当的转义序列：


字符	字符替换
&	&
<	<
>	>
”	"
'	'

对 WMS 服务应用外部功能文件

每个 WMS 服务都可通过其功能文件提供服务级别的元数据信息。功能文件是客户端在对服务发送 GetCapabilities 请求时所接收到的 XML 响应。配置外部功能文件可帮助您灵活执行以下操作：

添加有关此服务的元数据。
添加有关每个图层的元数据。
自定义每个图层的图例信息。

要将外部功能文件与 WMS 服务结合使用，需要创建该文件，然后对其进行配置以结合 WMS 服务使用。以下部分描述了此过程。

注：

对 WMS 服务使用外部功能文件时，您需要验证您的功能文件是否符合 OGC 的 DTD 或 XML 模式。还需要对功能文件和发布 WMS 服务所使用的源地图文档执行同步。

创建外部功能文件

要配置 WMS 服务以对其使用外部功能文件，您必须至少准备好一个 WMS 功能文件。您可以从头创建这一文件，但是通常情况下，使用系统生成的功能文件作为模板会更加容易。

默认情况下，每次向服务发送 WMS GetCapabilities 请求时都会自动创建系统生成的功能文件。要将系统生成的功能文件用作模板，您需要手动发送 GetCapabilities 请求并将响应另存为 XML 文件。如果希望您的 WMS 服务支持不同版本的 WMS 协议（例如，1.0.0、1.1.0、1.1.1 和 1.3.0），那么要支持的每个 WMS 版本必须有一个对应的功能文件。

完成以下步骤为 WMS 服务创建外部功能文件：

如果您尚未执行此操作，则发布地图或影像服务并启用 WMS 功能。有关详细信息，请参阅 WMS 服务。
在 web 浏览器中，提供 WMS 服务的 URL。 URL 的格式如下：
https://gisserver.domain.com:6443/arcgis/services/folder/service/service type(can be MapServer or ImageServer)/WMSServer
将 ?service=wms&request=GetCapabilities&version=1.0.0 追加至服务 URL 的末尾并按 Enter 键。浏览器中显示的 XML 文件是 WMS 版本 1.0.0 的服务功能文件。
将结果另存为 .xml 文件。文件名必须采用以下格式：<前缀><WMS 版本>.xml。例如，保存 WMS 版本 1.0.0 的 GetCapabilities 请求的 .xml 结果文件时，该文件必须使用通用前缀（例如 Roads），后跟三位数的 WMS 版本号 (100)。生成的文件为 Roads100.xml。
针对每个要支持的 WMS 版本（如版本 1.1.0、1.1.1 和 1.3.0）重复步骤 3 和 4。
在每个功能文件中配置和自定义 WMS 图层的元数据信息。
将所有功能文件移至可通过 HTTP 进行访问的通用文件夹中。通常，这将是您组织的 Web 服务器上的虚拟目录。

在 ArcGIS Server Manager 中配置 WMS 服务以使用外部功能文件

要配置 WMS 服务以对其使用外部功能文件，您需要更新 WMS 服务才能在 ArcGIS Server Manager 中引用功能文件的 URL。

启动 ArcGIS Server Manager 并以 ArcGIS Server 管理员身份进行登录。如需此步骤的帮助，请参阅登录到 ArcGIS Server Manager。
单击服务 > 管理服务。
在管理服务模块中，找到您的服务并单击编辑。如果列表中未显示该服务，那么其可能位于站点（根）文件夹下的某一子文件夹内。
在编辑模块中，单击功能。
在功能列表中，单击 WMS。
在 WMS 配置列表中，选择使用外部功能文件。
在指定位置和前缀文本框中，指定放置功能文件的文件夹的 URL，和用于该文件的通用前缀。例如，如果包含文件的文件夹的 URL 为 https://webserver.domain.com/arcgis/WMS/services 并且使用的通用前缀为 Roads，则在指定位置和前缀文本框中指定的 URL 为 https://webserver.domain.com/arcgis/WMS/services/Roads。
单击保存并重新启动。

有关此主题的反馈?