Utilizar las propiedades del servicio WMS disponibles

En este tema se explican las propiedades disponibles cuando se utiliza un archivo de recursos generado por el sistema para los servicios WMS.

Acceder a las propiedades del servicio WMS en ArcGIS Server Manager

Puede completar o modificar las propiedades de un servicio WMS en ArcGIS Server Manager. Para ello, siga estos pasos:

1. Abra ArcGIS Server Manager e inicie sesión. Si necesita ayuda con este paso, consulte Iniciar sesión en Manager.
2. Haga clic en Servicios > Administrar servicios.
3. En el módulo Administrar servicios, busque su servicio y haga clic en Editar. Si no encuentra su servicio en la lista, es posible que esté en una subcarpeta bajo la carpeta Sitio (raíz).
4. En el módulo Editar, haga clic en Capacidades.
5. En la lista de capacidades, haga clic en WMS y verifique que WMS está habilitado.
6. En la lista de Configuración de WMS, elija Introducir propiedades del servicio a continuación.
7. Complete o modifique las propiedades del servicio WMS.
8. Haga clic en Guardar y reiniciar. Las ediciones del servicio se aplican inmediatamente.

Las propiedades del servicio WMS

En la siguiente tabla se enumeran las propiedades disponibles para los servicios WMS e incluye una descripción de cada una:

Propiedad	Descripción
Nombre	El tipo de servicio de OGC. ArcGIS Server completa automáticamente esta propiedad y no debe modificarse.
Título	El nombre del mapa o servicio de imágenes que se utilizó para crear el servicio WMS. ArcGIS Server completa automáticamente esta propiedad y no debe modificarse.
Resumen	Una descripción narrativa que proporciona información adicional sobre el servicio WMS. Por ejemplo: WMS service maintained by Acme Corporation. Contact: [e-mail]. High-quality map showing eagle nests and possible nesting locations.
Palabras clave	Una lista de palabras clave o frases de palabras clave que describen el servicio WMS que ayuda en la búsqueda de catálogo. Por ejemplo: map, bird, eagle, nest, site
Recurso online	La propiedad OnlineResource enumera la dirección URL del servicio WMS. Es necesario para que un cliente WMS se comunique correctamente con el servicio WMS. ArcGIS Server completa automáticamente esta propiedad y no debe modificarse.
Persona de contacto	La principal persona de contacto para el servicio WMS. Por ejemplo: John Smith
Cargo de contacto	La posición de la persona de contacto para el servicio WMS. Por ejemplo: IT Analyst
Organización de contacto	La organización que creó el servicio WMS. Por ejemplo: NASA
Tipo de dirección	El tipo de dirección que utilizó la organización que creó el servicio WMS. Por ejemplo: postal
Dirección	La dirección de la organización que creó el servicio WMS. Por ejemplo: 380 New York Street
Ciudad	La ciudad en la que se encuentra la organización que creó el servicio WMS. Por ejemplo: Redlands
StateorProvince	El estado en el que se encuentra la organización que creó el servicio WMS. Por ejemplo: California
Código postal	El código postal en el que se encuentra la organización que creó el servicio WMS. Por ejemplo: 92373
País	El país en el que se encuentra la organización que creó el servicio WMS. Por ejemplo: USA
Teléfono de voz de contacto	El número de teléfono en el que se puede localizar a la principal persona de contacto para el servicio WMS. Por ejemplo: [phone]
Teléfono de fax de contacto	El número de fax en el que se puede localizar a la principal persona de contacto para el servicio WMS. Por ejemplo: [phone]
Dirección de correo electrónico de contacto	La dirección de correo electrónico por medio de la cual se puede localizar a la principal persona de contacto para el servicio WMS. Por ejemplo: [e-mail]
Cuotas	Texto que describe las cuotas impuestas a la hora de acceder a un servicio WMS. Por ejemplo: none
Restricciones de acceso	Texto que describe las restricciones y prerrequisitos legales para acceder y utilizar el servicio WMS. For internal use only. Do not distribute.
Ruta SLD o dirección URL	SLD le permite publicar varios estilos para cada capa WMS. Si está vinculando un archivo SLD con el servicio WMS actual, tendrá que introducir la ruta SLD o la propiedad de la URL, el recurso compartido de red o la ubicación física de un archivo XML de SLD. La cuenta de ArcGIS Server debe tener acceso a la ubicación con el fin de que ArcGIS Server pueda leer correctamente el archivo XML de SLD. Para obtener más información sobre SLD, consulte Utilizar Descriptores de capa con estilo con servicios WMS.
Sistemas de referencia espacial adicionales	Esta propiedad se puede utilizar para agregar sistemas de referencia espacial a los servicios WMS. De manera predeterminada, los servicios WMS solo enumeran dos sistemas de referencia espacial: EPSG:4326 (o CSR:84 para WMS 1.3.0) y la referencia espacial del servicio de mapas en el que está habilitado WMS. Para enumerar los sistemas de referencia espacial adicionales, separare los sistemas de referencia espacial con una coma (,). Por ejemplo, EPSG:4267,EPSG:4269,EPSG:102113. El espacio de nombre EPSG (por ejemplo, EPSG) y el Id. de EPSG (por ejemplo, 4267) deben estar separados por dos puntos (:) o el servidor ignorará la referencia espacial.
Sistemas de referencia espacial personalizados	La propiedad listCustomCRS le permite definir una proyección personalizada o una representación de texto conocido (WKT) de una proyección en un servicio WMS. Esto significa que los responsables de publicación y los consumidores de WMS pueden hacer lo siguiente: Asignar Id. a proyecciones personalizadas y notificarlas a través del archivo de recursos de WMS. Sobrescribir una proyección existente con una cadena de caracteres WKT. Solicitar un mapa en una proyección particular especificando directamente el texto conocido.
Identificar tolerancia (píxeles)	Esta propiedad le permite definir una tolerancia (en píxeles) en la que la operación GetFeatureInfo devolverá una información de entidad al cliente al hacer clic en la pantalla. Por ejemplo, si define una tolerancia de píxel de 10 para su WMS, la información se devolverá al cliente si hace clic dentro de los 10 píxeles que rodean a la entidad en la pantalla.
Utilizar nombres de capa del documento de mapa	Por defecto, esta opción está desactivada, lo que significa que las capas en el servicio WMS se representarán con enteros basados en cero, lo que indicará su posición en la tabla de contenido de arriba a abajo. A partir de la versión 10.8, no hay restricciones para los caracteres que se pueden usar en un nombre de capa, y el servidor WMS generará un identificador único para el nombre cuando sea necesario. Nota: El nombre asignado por el servidor no afectará al título. El servidor WMS asignará un nombre único mediante la sustitución de caracteres (reemplazando caracteres con un guión bajo) y agregando un sufijo numérico. Esto ocurrirá en los siguientes casos: Un mapa contiene dos o más capas con el mismo nombre. Un nombre de capa comienza con un número. Un nombre de capa contiene espacios o caracteres especiales, incluidos ?,&,=,+,`,#,%,^,{},[],<>,,,|," Nota: El número de sufijo es un valor calculado basado en la cadena de caracteres original y no es aleatorio. Como tal, permanecerá igual mientras no se modifique el nombre de la capa. Por ejemplo, si hay dos capas denominadas Capa "1" y Capa [1], ambas se convertirán en Capa__1_. Para diferenciarlas, se agregaría un número único como sufijo a la cadena de caracteres modificada. En este ejemplo, los nombres de capa modificados serían Capa__1_1234 y Capa__1_1256, respectivamente.
Forzar el cambio de aspecto del mapa según el ancho y la altura	Esta propiedad determina si se cambia el aspecto del mapa. Por defecto, esta opción está desactivada, lo que significa que los píxeles que representa el área del mapa se extienden para ajustarla a la altura y ancho solicitados por los clientes WMS. Si esta opción esta activada, el porcentaje de la altura y ancho de píxel permanecerá igual. Cuando se solicita un mapa en toda su extensión, es posible que este no cubra toda el área de visualización.
Asignar un identificador de nombre a una capa	De manera predeterminada, los servicios WMS no asignan un <Nombre> a las capas de grupo. La propiedad namedLayersMode le permite controlar el modo de asignar un identificador de nombre a las capas de un servicio WMS. Si la propiedad se establece en allLayers, el identificador de nombre se asigna tanto a las capas de grupo como a sus subcapas. Si se establece en subLayers o se deja sin especificar, el identificador de nombre únicamente se asigna a las subcapas de una capa de grupo. Significa que los clientes no pueden incluir una capa de grupo en una solicitud GetMap; deben especificar cada subcapa individual dentro de la capa de grupo.

Establecer propiedades en el Directorio de administrador

La mayoría de propiedades se pueden configurar mediante ArcGIS Server Manager. Si una propiedad no se puede modificar con Manager, se puede modificar o agregar con el Directorio de administrador de ArcGIS Server.

Para editar propiedades con el directorio, siga estos pasos:

1. Abra el Directorio de administrador en un navegador e inicie sesión. La dirección URL típica al directorio es https://gisserver.domain.com:6443/arcgis/admin/.
2. Haga clic en Servicios.
3. En la página Carpeta, haga clic en el nombre del servicio de mapas con WMS habilitado que desee editar. Si no encuentra su servicio en la lista, es posible que esté en una subcarpeta bajo la carpeta raíz.
4. En la página del servicio, desplácese a la parte inferior y haga clic en editar.
5. En el cuadro de diálogo Propiedades del servicio, busque la sección "typeName": "WMSServer".
6. En la sección Propiedades, agregue las propiedades y especifique los parámetros deseados, por ejemplo:

   "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",
   }

7. Haga clic en Guardar cambios.

Las propiedades se agregan a su WMS.

Caracteres especiales en las propiedades de servicio

No se pueden incluir los siguientes caracteres en ninguna de las propiedades de servicio: &, <, >, « y '. Si necesita utilizar uno de estos caracteres, debe sustituir la secuencia de escape adecuada en la siguiente tabla:

Carácter	Sustitución de caracteres
&	&
<	&lt;
>	&gt;
"	&quot;
'	&apos;

Utilizar archivos de recursos externos con servicios WMS

Cada servicio de WMS expone metadatos a nivel de servicio, a través de su archivo de recursos. El archivo de recursos es la respuesta XML que los clientes reciben al hacer una solicitud GetCapabilities en el servicio. Configurar archivos de recursos externos le permite hacer lo siguiente:

• Agregar metadatos acerca del servicio.
• Agregar metadatos acerca de las capas.
• Personalizar la información de la leyenda de las capas.

Para usar archivos de recursos externos con los servicios WMS, debe crear los archivos y configurarlos para el uso con los servicios WMS. Las secciones siguientes describen este proceso.

Nota:

Al utilizar archivos de recursos externos en el servicio WMS, deberá validar estos archivos frente al esquema DTD o XML de OGC. También asume el trabajo de realizar todas las sincronizaciones entre los archivos de recursos y el documento de mapa de origen a partir del que se publica el servicio WMS.

Crear archivos de recursos externos

Para configurar un servicio WMS de modo que utilice archivos de recursos externos, debe preparar al menos un archivo de recursos WMS. Puede crear el archivo desde cero, pero normalmente es más sencillo utilizar como plantilla un archivo de recursos generado por el sistema.

Por defecto, los archivos de recursos generados por el sistema se crean automáticamente cada vez que se envía una solicitud GetCapabilities de WMS al servicio. Para utilizar un archivo de recursos generado por el sistema como una plantilla, debe enviar manualmente la solicitud GetCapabilities y guardar la respuesta como XML. Si desea que el servicio WMS sea compatible con versiones distintas del protocolo WMS, por ejemplo: 1.0.0, 1.1.0, 1.1.1 y 1.3.0, debe tener un archivo de recursos para cada versión de WMS que desee compatibilizar.

Siga estos pasos para crear archivos de recursos externos para el servicio WMS:

1. Si no lo ha hecho aún, publique un mapa o un servicio de imágenes y habilite el recurso WMS. Para obtener más información, consulte Servicios WMS.
2. En un navegador web, proporcione la URL del servicio WMS. La URL presenta el siguiente formato:

   https://gisserver.domain.com:6443/arcgis/services/folder/service/service type(can be MapServer or ImageServer)/WMSServer

3. Incorpore ?service=wms&request=GetCapabilities&version=1.0.0 al final de la URL del servicio y pulse Intro. El XML que se muestra en el navegador es el archivo de recursos de la versión 1.0.0 de WMS para su servicio.
4. Guarde los resultados como un archivo .xml. El nombre del archivo debe seguir el formato <prefijo><versión de WMS>.xml. Por ejemplo, cuando guarde el archivo .xml resultante en una versión WMS 1.0.0 de la solicitud GetCapabilities, el archivo debe usar un prefijo común (como Roads) seguido por los tres dígitos del número de la versión de WMS (100). El archivo resultante es Roads100.xml.
5. Repita los pasos 3 y 4 para cada versión de WMS que desee usar, por ejemplo, 1.1.0, 1.1.1 y 1.3.0.
6. Configure y personalice la información de metadatos de las capas de WMS en cada archivo de recursos.
7. Mueva todos los archivos de recursos a una carpeta común accesible a través de HTTP. Normalmente, será un directorio virtual del servidor web de su organización.

Configurar un servicio WMS para utilizar archivos de recursos externos en ArcGIS Server Manager

Para configurar el servicio WMS de modo que use archivos de recursos externos, debe actualizar el servicio WMS para que haga referencia a la dirección URL de los archivos de recursos en ArcGIS Server Manager.

1. Inicie ArcGIS Server Manager e inicie sesión como administrador de ArcGIS Server. Si necesita ayuda con este paso, consulte Iniciar sesión en ArcGIS Server Manager.
2. Haga clic en Servicios > Administrar servicios.
3. En el módulo Administrar servicios, busque su servicio y haga clic en Editar. Si no encuentra su servicio en la lista, es posible que esté en una subcarpeta bajo la carpeta Sitio (raíz).
4. En el módulo Editar, haga clic en Capacidades.
5. En la lista de recursos, haga clic en WMS.
6. En la lista Configuración de WMS, elija Utilizar archivos de recursos externos.
7. En el cuadro de texto Especificar la ubicación y prefijo, escriba la URL de la carpeta en la que ha colocado los archivos de recursos y el prefijo común que ha utilizado para ellos. Por ejemplo, si la URL de la carpeta que contiene los archivos es https://webserver.domain.com/arcgis/WMS/services y el prefijo común que ha utilizado es Roads, la URL que debe escribir en el cuadro de texto Especificar la ubicación y prefijo es https://webserver.domain.com/arcgis/WMS/services/Roads.
8. Haga clic en Guardar y reiniciar.