本主题将对使用系统生成的功能文件时可用的 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 的发布者和使用者都可以进行以下操作:
|
识别容差(像素) | 此属性可让您定义在客户端单击屏幕时 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。
- 单击保存并重新启动。