Puede extender los servicios de mapas e imágenes publicados desde ArcGIS Pro con extensiones de objeto de servidor (SOE) e interceptores de objetos del servidor (SOI). Las SOE permiten crear operaciones de servicio para ampliar la funcionalidad base de los servicios, mientas que los SOI permiten interceptar solicitudes y respuestas correspondientes a las operaciones incorporadas de un servicio.
Las SOE y los SOI se pueden desarrollar mediante el uso de ArcGIS Enterprise SDK y ambos se encapsulan en archivos .soe. Pueden agregarse a su organización y gestionarse desde ArcGIS Enterprise Manager. Una vez que se agregan a la organizaicón, las SOE y los SOI pueden habilitarse en servicios de imágenes o mapas cuando publique desde ArcGIS Pro o en capas de imágenes de mapa desde la página de detalles del elemento.
Agregar una extensión
Para agregar una extensión a una organización, necesita el archivo .soe que creó el desarrollador de la extensión. El archivo puede contener una o varias extensiones.
Una vez que tenga el archivo, siga estos pasos:
-
Inicie sesión en ArcGIS Enterprise Manager como administrador.
Nota:
Las organizaciones pueden elegir habilitar a los publicadores para que implementen extensiones. Consulte Cambiar los privilegios de publicación del servicio de geoprocesamiento y de la extensión del servicio para obtener más información.
- Haga clic en el botón Extensiones de la barra lateral.
Aparece la página de extensiones.
- Haga clic en Agregar extensión.
- Haga clic en Elegir archivo y elija un archivo .soe para agregarlo a su organización.
- Haga clic en Agregar extensión.
El archivo .soe se agrega a la organización.
Como ya ha agregado la extensión a su organización, debe habilitar la función SOE o SOI en el servicio de imágenes o mapas deseado.
Habilitar SOE
Una vez que se agrega un SOE a su organización, puede habilitar la función en un servicio de imágenes o mapas. Las SOE pueden habilitarse en capas de imágenes de mapa desde la página de detalles del elemento.
Para habilitar una SOE desde la página de detalles de un elemento, realice los pasos siguientes:
- Inicie sesión en una organización como propietario de un elemento con privilegios de publicación o como administrador.
- Abra la página de detalles del elemento de la capa de imágenes de mapa.
- Haga clic en Configuración.
- Desplácese hasta la sección Capa de imágenes de mapa y expanda el encabezado Extensiones.
- Expanda el encabezado Extensiones de objeto de servidor (SOE).
Aparece la lista de SOE que se han agregado a su organización.
- Active el botón de alternancia situado junto al SOE que desee habilitar en el servicio.
- Expanda el encabezado correspondiente a la SOE que ha habilitado.
Aparecen las operaciones y propiedades del SOE. Estas han sido creadas de manera opcional por el desarrollador de la extensión y le proporcionan un grado más preciso de control sobre lo que los usuarios pueden hacer con las SOE.
- Si procede, seleccione las operaciones que desea permitir.
- Si procede, edite las propiedades disponibles.
- Haga clic en Guardar para aplicar los cambios.
La SOE ahora está habilitada en el servicio. Para deshabilitarla, desactive el botón de alternancia situado junto a la SOE y haga clic en Guardar.
Activar SOI
Una vez que se agrega un SOI a su organización, puede habilitar la función en un servicio de imágenes o mapas. Los SOI pueden habilitarse en capas de imágenes de mapa desde la página de detalles del elemento.
Activar más de un SOI se llama encadenamiento. Al encadenar, debe especificar el orden en el que se ejecutarán los SOI en el servicio.
Para habilitar un SOI desde la página de detalles de un elemento, realice los pasos siguientes:
- Inicie sesión en una organización como propietario de un elemento con privilegios de publicación o como administrador.
- Abra la página de detalles del elemento de la capa de imágenes de mapa.
- Haga clic en Configuración.
- Desplácese hasta la sección Capa de imágenes de mapa y expanda el encabezado Extensiones.
- Expanda el encabezado Interceptores de objetos del servidor (SOI).
Aparece la lista de SOI que se han agregado a su organización.
- Active el botón de alternancia situado junto al SOI que desee habilitar en el servicio.
- Si habilita varios SOI, utilice la funcionalidad de arrastre y colocación para especificar el orden en el que los SOI se ejecutarán en la cadena.
El primer SOI de la lista se ejecutará en primer lugar.
Sugerencia:
Vuelva a este cuadro de diálogo en cualquier momento para modificar la lista de SOI activados y cambiar el orden de ejecución en la cadena.
- Expanda el encabezado correspondiente al SOI que ha habilitado.
Aparecen las operaciones y propiedades del SOI. Estas han sido creadas de manera opcional por el desarrollador de la extensión y le proporcionan un grado más preciso de control sobre lo que los usuarios pueden hacer con los SOI.
- Si procede, seleccione las operaciones que desea permitir.
- Si procede, edite las propiedades disponibles.
- Haga clic en Guardar para aplicar los cambios.
Los SOI ahora están habilitados en el servicio. Para deshabilitarla, desactive el botón de alternancia situado junto al SOI y haga clic en Guardar.
Configurar ajustes de depuración
Para permitir la depuración, ArcGIS Enterprise Manager permite alterar el comportamiento de la extensión. Puede suspender el inicio del servicio para que pueda adjuntar su depurador al proceso del servicio antes de llamar a los métodos de inicialización de la extensión. También puede especificar un rango de puertos que utilizará cuando depure el servicio.
Para acceder a estas opciones de configuración de depuración en Enterprise Manager, siga estos pasos:
- Inicie sesión en ArcGIS Enterprise Manager como administrador.
- Haga clic en el botón Servicios de la barra lateral.
Aparece la página de servicios.
- Localice el nombre de un servicio registrado en una SOE y haga clic en él.
- Seleccione la pestaña Avanzado y habilite el modo de depuración.
La configuración de depuración de extensiones aparece cuando se habilita el modo de depuración.
- De manera opcional, habilite Suspender el servicio al inicio y especifique el número de segundos que debería retrasarse el inicio del servicio.
- De manera opcional, puede especificar un rango de puertos que se va a utilizar durante la depuración.
- Haga clic en Guardar.
Eliminar una extensión
Cuando elimina una extensión en ArcGIS Enterprise Manager, la extensión se elimina de su organización. Si la extensión se registra en un servicio, al eliminarla también se dará de baja del servicio.
Para eliminar una extensión, siga estos pasos:
- Inicie sesión en ArcGIS Enterprise Manager como administrador.
- Haga clic en el botón Extensiones de la barra lateral.
Aparece la página de extensiones.
- Haga clic en el botón Más opciones
de la extensión que desee eliminar y en Eliminar. - Haga clic de nuevo en Eliminar para confirmar.
La extensión se da de baja del servicio y se elimina de la organización.
Actualizar una extensión
Puede actualizar una extensión que se ha agregado a la organización agregando su archivo .soe actualizado.
Para actualizar la extensión, siga estos pasos:
- Inicie sesión en ArcGIS Enterprise Manager como administrador.
- Haga clic en el botón Extensiones de la barra lateral.
Aparece la página de extensiones.
- Haga clic en el botón Más opciones de la extensión que desee actualizar y en Actualizar.
- Haga clic en Elegir archivo y seleccione la versión actualizada del archivo .soe.
El nombre de archivo debe coincidir con el nombre del archivo .soe original.
- Haga clic en Actualizar extensión.
La extensión se actualiza con el archivo .soe nuevo.