Configuración de la herramienta web y del servicio de geoprocesamiento
Cuando se comparte una herramienta como herramienta web o un servicio de geoprocesamiento, la configuración de propiedades define como los consumen las aplicaciones cliente. Los parámetros de la herramienta más habituales y que se cambian con más frecuencia se pueden definir al compartir. Los ajustes menos habituales se pueden modificar en ArcGIS Server Manager después de compartir la herramienta. Algunas propiedades de servicio avanzadas solo se pueden configurar en la API REST del administrador de ArcGIS Server.
Configuración en ArcGIS Pro
Las subsecciones siguientes describen las opciones disponibles al compartir una herramienta web o un servicio de geoprocesamiento en ArcGIS Pro, incluida la creación de una definición de servicio conectado o sin conexión.
Configuración en la pestaña General
En la pestaña General, que es la pestaña predeterminada cada vez que se inicia el panel de uso compartido, se encuentran disponibles los siguientes ajustes. Muchos parámetros se pueden modificar en ArcGIS Server Manager después de compartir la herramienta web, o en la página de elementos de la herramienta web en el portal.
Nombre
El nombre de la herramienta web que se compartirá con su portal. Este nombre debe ser único en el portal y no puede contener espacios ni caracteres especiales. Este parámetro se hereda de los metadatos de la herramienta.
Resumen y Etiquetas
El resumen y las etiquetas que ayudan a describir el documento y permiten la búsqueda de la herramienta web. Estos parámetros se heredan de los metadatos de la herramienta.
Puede utilizar el menú desplegable Etiquetas para seleccionar las etiquetas existentes. El máximo es de 128 etiquetas.
Categoría
La categoría del elemento de herramienta web. Esta configuración no está disponible para los servicios de geoprocesamiento publicados en un ArcGIS Server independiente.
Versión
La versión de ArcGIS Enterprise o ArcGIS Server con la que se compartirá la herramienta. Este parámetro solo está habilitado al guardar una definición de servicio sin conexión para una herramienta web.
Datos, herramientas y scripts
Opciones para configurar el comportamiento de consolidación y publicación de los datos, herramientas y scripts.
Incluir datos, cajas de herramientas y scripts en la definición del servicio: determina si todos los datos, cajas de herramientas y scripts referenciados se incluyen en la definición del servicio. Cuando esta opción está marcada, ciertos ajustes de consolidación se bloquean automáticamente en los estados marcado o desmarcado. Para la mayoría de los flujos de trabajo, mantenga esta opción seleccionada a menos que tenga escenarios de uso compartido avanzados para su herramienta web o servicio de geoprocesamiento. Esta opción está habilitada de forma predeterminada.
Datos sin URL: controla si los datos se copian en el servidor (pasan a ser estáticos) o si la herramienta web sigue haciendo referencia a ellos. Una entrada coincidente en el data store del servidor se debe configurar para que los datos utilicen la opción Referencia a datos registrados. Si el data store del servidor no configura los datos, estos se copiarán durante la publicación. Esto solo es aplicable al publicar o sobrescribir como herramienta web o al guardar como definición de servicio conectado. Al guardar el resultado como una definición de servicio sin conexión, asegúrese de que se pueda hacer referencia a todos los datos del parámetro cuando se utilice la opción Datos de referencia, ya que no hay alternativa para copiar los datos si el data store del servidor no define los datos. Cuando desmarcas la opción Incluir datos, cajas de herramientas y scripts en la definición del servicio, no podrás copiar ningún dato y esta opción se bloqueará en el estado Referencia a datos registrados. La opción predeterminada es Referencia de datos registrados.
Datos de URL: controla si los datos a los que hace referencia una URL se dejan tal cual durante la publicación o se convierten a otro tipo de datos descargándolos de la URL. Esta configuración determina si ArcGIS Pro publica el servicio utilizando la referencia URL original o recupera y transforma los datos en el momento de la publicación. Esta opción está disponible en ArcGIS Pro 3.2 y versiones posteriores. Los datos de URL hacen referencia a la URL de tipos diferentes de capas web o servicios. Solo se pueden configurar capas de entidades, servicios de entidades y subcapas de entidades de capas de imágenes web. Cuando se activa la casilla de verificación Convertir capa de entidades, la capa o servicio de entidades del parámetro o datos del proyecto se convierten en una clase de entidad durante la publicación. Si se desactiva, se conservará la URL de la capa de entidades. No existe la opción de convertir la URL de las capas de imágenes web, y la URL de la capa de imágenes web siempre se conservará tal cual durante la publicación. Cuando desmarca la opción Incluir datos, cajas de herramientas y scripts en la definición del servicio, no podrá convertir ningún dato de la URL y esta opción se bloqueará en el estado desmarcado. Esta opción está habilitada de forma predeterminada.
Opciones de consolidación: obtenga más información sobre el uso de las opciones de consolidación
Ubicación
Especifica dónde se creará el elemento de la herramienta web o el servicio de geoprocesamiento.
Las opciones de los elementos de la herramienta web publicados en ArcGIS Enterprise son los siguientes:
Carpeta: seleccione o cree una carpeta del portal donde se creará el elemento de la herramienta web. La configuración predeterminada es la raíz del portal.
Servidor y carpeta: en el caso del servidor, las herramientas web se deben compartir con un portal con uno o varios servidores federados. Si el portal tiene más de un servidor federado, elija el servidor en el cual se publicará la herramienta web. En el caso de la carpeta, seleccione una carpeta existente o cree una en el sitio de ArcGIS Server. El valor predeterminado es la carpeta raíz del sitio de ArcGIS Server.
La opción para los servicios de geoprocesamiento publicados en sitios de ArcGIS Server independientes es la siguiente:
- Carpeta: seleccione o cree la carpeta de servidor en la que se creará el elemento del servicio de geoprocesamiento. El valor predeterminado es la carpeta raíz del servidor.
Compartir con
Disponible para herramientas web publicadas en ArcGIS Enterprise solamente, especifique con quién y con qué grupos se compartirá la herramienta web. Una herramienta web siempre se comparte con Mi contenido. Compartir una herramienta web con Todos hace que el elemento sea público, cualquiera que tenga acceso al sitio web del portal puede encontrarlo y usarlo, y los propietarios de grupos pueden incluirlo en el contenido de su grupo. Compartir una herramienta web con ArcGIS Enterprise hace que la herramienta web se comparta con todos los miembros del portal que tengan acceso a un elemento. Puede optar por compartirla con cualquier grupo al que pertenezca.
Configuración en la pestaña Configuración
Las opciones Cargar, Validar, Modo de ejecución, Ver salida en capa de imagen de mapa, Nivel de mensaje y Número máximo de registros devueltos están disponibles en la subpestaña Configurar capacidades y parámetros del servicio.
Los ajustes Número de instancias, Tiempo de espera del servicio: tiempo máximo de uso, Tiempo de espera del servicio: tiempo máximo de espera y Tiempo de espera del servicio: tiempo máximo de inactividad están disponibles en la subpestaña Configurar agrupación. Consulte Ajustar y configurar servicios para más consideraciones a la hora de especificar estos ajustes.
Cargar
Especifica si un cliente puede cargar un archivo en el servidor para utilizarlo como entrada para la herramienta web. La operación de carga la utilizan principalmente los clientes web que necesitan un modo de enviar un archivo al servidor para su procesamiento. Una vez que se completa la carga, la operación devuelve un Id. único para el archivo que la aplicación web puede transferir a la herramienta web.
El valor predeterminado no está activado.
Validar
Habilita la operación de validación para todas las tareas de la herramienta web o servicio de geoprocesamiento. Esta operación permite a los clientes utilizar la operación de validación antes de ejecutar la herramienta. Independientemente del modo de ejecución, la operación de validación solo admite llamadas síncronas. Los clientes que realicen una solicitud de validación deben esperar hasta obtener la respuesta de validación.
El valor predeterminado no está activado.
Modo de ejecución
Especifica cómo el cliente (la aplicación que utiliza la herramienta web) interactúa con la herramienta web y obtiene la salida. Cuando una herramienta web se define como Sincrónica, el cliente espera que la tarea finalice. Normalmente, un servicio sincrónico se ejecuta con rapidez (en unos segundos). Cuando se establece como Asíncrona, el servicio suele tardar más en ejecutarse y el cliente debe comprobar periódicamente el servidor para determinar si el servicio ha finalizado y, en caso afirmativo, obtener el resultado. Una aplicación web con un servicio asíncrono debe tener lógica implementada para verificar el estado y administrar el resultado una vez finalizada la ejecución.
El valor predeterminado es Asíncrono.
Muestra la salida en la capa de imágenes del mapa
Al publicar una herramienta web o un servicio de geoprocesamiento, puede ver la salida como una imagen de mapa. La imagen de mapa se crea en el servidor y se transporta de nuevo al cliente como una imagen (un archivo .tiff con información de estilos). La simbología, el etiquetado, la transparencia y otras propiedades de la imagen de mapa son las mismas que las de la capa de salida de la sesión de ArcGIS Pro cuando se publicó originalmente. Plantéese lo siguiente al utilizar este parámetro:
Si la herramienta genera un gran número de entidades que el cliente debe simbolizar y dibujar, será más rápido para el cliente recibir una imagen de mapa.
Por razones de distribución de datos, no desea enviar al cliente ninguna entidad, solo una imagen de mapa.
El resultado de la herramienta es un dataset no transportable, como una red o una topología. La única forma de enviar la salida al cliente es usar una imagen de mapa.
Nota:
Una imagen de mapa de salida solo se puede usar cuando el parámetro Modo de ejecución de la herramienta web se ha definido como Asíncrono. Este parámetro no se admite al publicar una herramienta web en Kubernetes.
El valor predeterminado no está activado.
Nivel del mensaje
Devuelve mensajes de los siguientes niveles al cliente que ha ejecutado la herramienta web de la forma siguiente:
Ninguno: no se devuelven mensajes de geoprocesamiento al cliente, solo una indicación de si la operación se realizó correctamente o si falló. Esta es la opción predeterminada.
Error: solo se devuelven al cliente los mensajes de la herramienta que indican un error.
Advertencia: se devuelven al cliente todos los mensajes de advertencia y de error de la herramienta.
Info: se devuelven al cliente todos los mensajes de operación de la herramienta.
Precaución:
Los mensajes, independientemente de su nivel, pueden contener rutas y nombres de dataset, lo que puede suponer un riesgo de seguridad. El nivel Info es detallado y normalmente contiene referencias a rutas y nombres de dataset. En general, devuelve mensajes en el nivel Info o Advertencia en entornos de desarrollo y prueba, y utiliza el nivel Ninguno o Error en un entorno de producción.
El valor predeterminado es Ninguno.
Cantidad máxima de registros devueltos
El número máximo de resultados que el servicio puede devolver a un cliente. Establecer este valor en un número elevado significa que el servidor SIG puede manejar el envío de muchos registros o entidades individuales al cliente. Para que no se devuelva ninguna entidad, establezca este valor en 0 (cero). Esta propiedad no surtirá efecto cuando se active el parámetro Agregar parámetro de servicio de entidad de salida opcional.
El valor predeterminado es 1000.
Número de instancias
El número mínimo y máximo de instancias del servicio de geoprocesamiento que pueden ejecutarse en cada equipo de servidor para ArcGIS Enterprise o el pod gp-server-sync para ArcGIS Enterprise en Kubernetes en un momento dado.
Límites de tiempo del servicio - Tiempo máximo de uso
La cantidad máxima de tiempo, en segundos, que un servicio se puede utilizar. Es posible que deba aumentar el valor predeterminado de 600 segundos (10 minutos) para tareas de geoprocesamiento que duren mucho tiempo. Alternativamente, puede reducir este tiempo para garantizar que un cliente no abusará de sus servicios.
Límites de tiempo del servicio - Tiempo máximo de espera
La cantidad máxima de tiempo, en segundos, que el cliente debe esperar para conectarse con una instancia antes de que caduque. Cuando todas las instancias están ocupadas procesando solicitudes, las solicitudes posteriores están a la cola. Si el tiempo de espera se acaba antes de que esté disponible una instancia, la tarea fallará. El valor predeterminado es 60 segundos (1 minuto).
Límites de tiempo del servicio - Tiempo máximo de inactividad
La cantidad máxima de tiempo, en segundos, que una instancia seguirá activa antes de que tenga lugar el acortamiento de grupo Cualquier instancia por encima de la cantidad mínima de instancias que no se han utilizado será cerrada unan vez que se haya terminado el valor máximo de inactividad.
Configuración en la pestaña Contenido
Los ajustes descritos abajo solo se pueden modificar en el momento de la publicación de una herramienta web o un servicio de geoprocesamiento. Para cambiar cualquiera de estos para una herramienta publicada o un servicio de geoprocesamiento, debe crear uno nuevo o sobrescribir el existente. Para configurar las propiedades de cada herramienta individualmente, haga clic en el botón Editar 
situado junto al nombre de la herramienta y las propiedades de la herramienta seleccionada estarán disponibles para su configuración en la vista de herramientas. Para la primera herramienta, o la única herramienta de su caja de herramientas, las propiedades de la herramienta se mostrarán de forma predeterminada sin necesidad de hacer clic en el botón Editar. Para agregar más herramientas, utilice el botón Agregar herramienta.
Configuraciones predeterminadas
Las opciones Agregar parámetro opcional de servicio de entidades de salida, Agregar imagen de salida opcional y Eliminar todos los valores predeterminados configuradas en esta sección se aplicarán a todas las herramientas. No verá Agregar parámetro opcional de servicio de entidades de salida ni Agregar imagen de salida opcional si ninguna de sus herramientas tiene parámetros de salida de entidades o ráster. También puede configurar estos dos ajustes para la función o el parámetro de salida ráster de cada herramienta individual. Para eliminar los valores predeterminados de parámetros individuales, configure Eliminar valor predeterminado de un parámetro.
- Agregar parámetro opcional de servicio de entidades de salida
Un parámetro de entrada opcional que especifica si todas las salidas de entidades se pueden guardar como un servicio de entidades alojado cuando se utiliza la herramienta web. Este parámetro solo se admite cuando se publica como herramienta web con modo de ejecución asíncrona publicada en ArcGIS Enterprise. Por lo demás, no está disponible para su configuración. El parámetro está seleccionado de forma predeterminada.
Más información sobre el uso de herramientas web con un servicio de entidades de salida
- Agregar parámetro opcional de servicio de imágenes de salida
Parámetro de entrada opcional que especifica si todas las salidas ráster se pueden guardar como servicios de imagen al utilizar la herramienta web o el servicio de geoprocesamiento.
- Eliminar todos los valores predeterminados
A partir de ArcGIS Pro 3.3, cuando esté activado, se eliminarán todos los valores predeterminados utilizados al ejecutar la herramienta, y se activará automáticamente la casilla de verificación Eliminar valor predeterminado en la configuración de parámetros de la herramienta que se mostró anteriormente. El valor predeterminado no está activado.
Agregar herramienta
Para agregar herramientas del historial de geoprocesamiento a una herramienta web o un servicio de geoprocesamiento existentes, haga clic en el botón Agregar herramienta 
de la pestaña Contenido. Para eliminar herramientas, haga clic en el nombre de la herramienta y seleccione Eliminar o bien haga clic en el icono de la papelera.
Nombre de la herramienta
El nombre de la herramienta. De forma predeterminada, se basa en los metadatos de la herramienta.
Descripción de la herramienta
La descripción de la herramienta. La descripción no se hereda de los metadatos de la herramienta. Si está en blanco, proporcione una descripción y se quedará cada vez que comparta desde el historial.
Nombre y Descripción de un parámetro
El nombre y la descripción del parámetro. Ambas propiedades heredan el nombre del parámetro y la descripción de los metadatos de la herramienta. La modificación de estas propiedades no afectará a los metadatos originales de la herramienta.
Tipo de parámetro
El tipo de parámetro define si el cliente debe proporcionar un valor para que la herramienta se ejecute correctamente. En la pestaña Contenido solo se pueden cambiar los parámetros opcionales por los requeridos. Para cambiar un parámetro requerido para que sea opcional, cierre el panel Compartir, edite las propiedades de la herramienta y vuelva a ejecutar la herramienta para crear un nuevo resultado.
Mantener el tipo de datos como Compuesto
Esta propiedad solo está disponible cuando el parámetro es un tipo de dato compuesto. Especifica si el parámetro se publicará como tipo de dato compuesto (activado). El valor predeterminado no está activado.
Modo de entrada de un parámetro
Especifica cómo introducirán los clientes las entidades en la tarea.
Valor definido por el usuario: el cliente proporciona un valor para el parámetro.
Lista de opciones: se proporciona una lista de cadenas de caracteres (la lista de opciones) y el cliente debe elegir una o varias de las cadenas de la lista de opciones. Según el tipo de datos de la entrada, las cadenas de caracteres pueden ser los nombres de capas o simples opciones de palabras clave.
Constante: se utilizará el valor que proporcionado para el parámetro cuando creó el resultado. Dado que el valor es constante, el cliente no puede cambiarlo, por lo que no será un parámetro de tarea cuando se publique el servicio.
Modo mixto: definido por el usuario y lista de opciones: solo disponible para los parámetros Compuesto o Tabla de valores. Configure el modo de entrada para cada tipo de datos de compuesto, o cada tipo de datos para cada columna de la tabla de valores. Si algún tipo de datos no admite la lista de opciones, solo estará disponible para la configuración la opción Valor definido por el usuario.
Convertir tipo de dato a cadena de caracteres de un parámetro
Esta propiedad solo se aplica al tipo de datos de unidad de área. Especifica si la unidad de área se convertirá al tipo de datos de cadena de caracteres (activado) o se publicará como unidad de área (desactivado). El valor predeterminado no está activado.
Eliminar valor predeterminado de un parámetro
A partir de ArcGIS Pro 3.3, cuando esté activado, el valor predeterminado utilizado al ejecutar la herramienta se eliminará durante el proceso de publicación. El valor predeterminado no está activado.
Valor predeterminado de un parámetro
El valor de parámetro que se especifica al ejecutar la herramienta es el que determina el valor predeterminado de la herramienta. Para agregar o modificar el valor predeterminado de un parámetro, ejecute de nuevo la herramienta con el parámetro correspondiente.
Utilizar solo capas predeterminadas de un parámetro
Esta propiedad solo se aplica al modo de entrada de lista de opciones. Especifica si solo la opción que se utiliza al ejecutar la herramienta se marcarán en la vista de lista bajo esta casilla (activada). El valor predeterminado no está activado.
Tipo de geometría de parámetro
Esta propiedad se aplica solo a las entidades. El tipo de geometría proviene de las entidades de entrada y salida que se utilizan para crear el resultado. No se puede modificar en la pestaña Contenido. Vuelva a ejecutar la herramienta utilizando entidades del tipo de geometría especificado y compartir el resultado creado por esa operación.
Esquema de un parámetro
Esta propiedad se aplica solo a entidades y tablas. El esquema es una lista de los campos (atributos) que el cliente debe suministrar cuando se construyen las entidades de entrada a la herramienta. Dicha lista de campos es la misma que la capa o el dataset que se utilizaron como entrada o salida para la herramienta que creó el resultado.
Configuración de ArcGIS Server Manager
La configuración de los parámetros de las subsecciones siguientes se puede modificar en ArcGIS Server Manager después de publicar el servicio, excepto en ArcGIS Enterprise Manager para ArcGIS Enterprise on Kubernetes.
Nota:
Si se modifica cualquiera de los siguientes ajustes, se reinicia el servicio.
Parámetros
Dispone de los siguientes ajustes de parámetros:
|
El parámetro |
Descripción |
|---|---|
|
Clúster |
El servicio clúster se ejecutará bajo. Este ajuste solo se puede modificar si ArcGIS Server participa en un clúster. |
|
Directorios |
Los directorios utilizados por el servidor para escribir archivos al ejecutar la herramienta. |
Capacidades
Dispone de los siguientes ajustes de parámetros de funcionalidad:
|
El parámetro |
Descripción |
|---|---|
|
WPS |
Habilita las capacidades de WPS en servicios de geoprocesamiento y permite que otros clientes se conecten y consuman herramientas mediante protocolos OGC estándar. |
Procesos
Dispone de los siguientes ajustes de parámetros de procesos:
|
El parámetro |
Descripción |
|---|---|
|
Reciclaje |
Controla con qué frecuencia y cuándo se recicla un servicio. De manera predeterminada, se realiza una vez cada 24 horas a partir de medianoche. Los servicios de geoprocesamiento solo se ejecutan con un alto grado de aislamiento, a diferencia de otros tipos de servicios que se pueden ejecutar con un aislamiento alto o bajo. |
Configuración de elementos de Portal for ArcGIS
A partir de ArcGIS Enterprise 12.0, puede administrar muchos ajustes en la página de elementos de su elemento de herramienta web en Portal. Consulte Administrar herramientas web para saber qué ajustes puede actualizar después de publicar su herramienta.