Al usar una herramienta web con una salida de entidad normal, la salida se genera en el servidor y se vuelve a enviar al cliente como entidad. El servicio de entidades de salida reside en el ArcGIS Data Store de su servidor de alojamiento y le permite servir datos de entidades de salida y tablas no espaciales a través de la red en lugar de guardar el resultado en una unidad local. Además, de esta manera se ahorra la sobrecarga de devolver los datos resultantes al cliente, lo que mejora la eficiencia de una herramienta web si el resultado de la entidad de salida es grande. También hace que sus datos estén disponibles para varios clientes como clientes web, aplicaciones de escritorio y aplicaciones de campo.
Creación
Para usar esta entidad, la salida debe ser una tabla o clase de entidad.
No es necesario cambiar nada al diseñar su herramienta web, independientemente de si la salida es opcional o necesaria.
Publicación
Para compartir una herramienta web con un servicio de entidades de salida, se deben cumplir los siguientes requisitos de software:
- ArcGIS Pro 2.3 o versiones posteriores
- ArcGIS Server y Portal for ArcGIS 10.7 o versiones posteriores
- ArcGIS Server debe estar federado con Portal for ArcGIS
- Portal for ArcGIS debe tener un servidor de alojamiento
Tras ejecutar la herramienta, configure los siguientes ajustes en el cuadro de diálogo Compartir como una herramienta web:
- Tan solo puede compartir la herramienta web con grupos de su portal o ArcGIS Enterprise. No comparta su herramienta web con Todos, puesto que podría haber problemas de permisos cuando se utilice la herramienta.
- Defina el Modo de ejecución como Asíncrono.
- Deje desactivada la opción Muestra la salida en la capa de imágenes del mapa.
- Cantidad máxima de registros que devolvió el servidor no tiene ningún efecto en el servicio de entidades de salida.
Nota:
Cuando se utiliza la función de Python arcpy.CreateGPSDDraft para publicar una herramienta web, server_type se debe especificar como MY_HOSTED_SERVICES.
Uso
Al usar una herramienta web con una salida de tabla o entidad, dispone de otro parámetro de entrada opcional denominado Nombre de servicio de entidades de salida al final de la lista de parámetros. Dicho parámetro se genera automáticamente durante el proceso de publicación. No se puede eliminar ni cambiar el nombre. Para usar correctamente una herramienta web con este parámetro, proporcione un nombre de servicio que cumpla los siguientes requisitos:
- El nombre del servicio de entidades de salida debe ser único en todos los servicios alojados de su portal, puesto que los servicios de entidades de salida residirán en la carpeta alojada de su portal.
- El nombre solo puede contener caracteres alfanuméricos o guiones bajos y debe tener 120 caracteres o menos.
- El usuario del portal debe tener privilegios para crear un servicio de entidades de salida. Los únicos roles con este privilegio son Publicador y Administrador. En el caso de los usuarios del portal con un rol personalizado, dicho rol debe tener los privilegios Miembros/Visualizar, Contenido/Publicar capas de entidades alojadas y, por último, Contenido y análisis/Análisis de entidades estándar.
Al usar la herramienta web con un servicio de entidades de salida, todas las entidades de salida se copian en el data store del servidor de alojamiento, independientemente de dónde se encuentra el resultado original en el servidor.
Nota:
Al publicar una herramienta web en un sitio de ArcGIS Server federado con su portal, es necesario ejecutar un comando allowconnection en su servidor de alojamiento. De lo contrario, los resultados no se pueden copiar en su servidor de alojamiento.
Tras ejecutar la herramienta web, el servidor proporciona una URL al servicio de entidades resultante. Si usa la herramienta web en ArcGIS Pro, el resultado se agrega como una capa con una URL de servicio a la tabla de contenido. Si usa la herramienta web desde un extremo REST, el resultado es una representación JSON de la URL.
Nota:
El parámetro Nombre de servicio de entidades de salida es opcional. Si deja el Nombre de servicio de entidades de salida en blanco y usa una herramienta web, se genera una tabla o entidad de salida normal.
Las propiedades del parámetro de salida originales afectan a la forma en que se renderiza el servicio de entidades. A continuación se muestran escenarios habituales:
- Varias salidas: cuando hay varios parámetros de entidades de salida, cada resultado de salida se agrega como una capa al servicio de entidades de salida, sin embargo, tan solo hay un servicio de entidades de salida cuando se ejecuta una herramienta web.
- Salida vacía: si el resultado de un parámetro de salida está vacío al ejecutar la herramienta web, se genera una capa con entidades vacías y se agrega al servicio.
- Salida opcional y derivada: si el tipo de parámetro de salida es opcional o derivado, existe la posibilidad de que la salida no se genere al ejecutar la herramienta web. En este caso, no se agrega ninguna capa al servicio.
- Salida con varios valores: ejecutar una herramienta web que tiene una salida con varios valores no admite ningún servicio de entidades de salida.
- Simbologías: si la simbología se define para la salida de la herramienta, el servicio de entidades de salida mantiene esa simbología. Si no se determina ninguna simbología al crear la herramienta, se usa la simbología predeterminada.