Crear webhooks

Como administrador de una organización, puede configurar webhooks para que se notifique en su implementación de ArcGIS Enterprise cuando se produzcan eventos específicos. En las siguientes secciones se describe cómo configurar los webhooks de servicios y de organización.

Requisitos previos a crear webhooks

Considere lo siguiente antes de crear webhooks:

• Para utilizar webhooks de organización, su organización debe utilizar una versión de ArcGIS Enterprise a partir de la 10.7. Para utilizar webhooks de servicio, su organización debe utilizar una versión de ArcGIS Enterprise de la 11.0 en adelante.
• Debe ser administrador o tener asignado el rol de administrador predeterminado para crear y administrar webhooks de organización.
• Debe tener asignados los privilegios de administrador de Actualizar, Eliminar, Seguridad e infraestructura o Servidores; o tener asignado el rol de administrador predeterminado para crear y administrar webhooks de servicios.
• Los receptores de webhook se deben configurar para que se comuniquen a través de HTTPS. Existen algunas opciones que son compatibles con los receptores, como receptores de servicios web de terceros (Microsoft Power Automate, Zapier e IFFT), servicios web personalizados, ArcGIS Notebook Server y ArcGIS Workflow Manager. Para obtener ejemplos de cómo crear servicios web personalizados o empezar a utilizar receptores de terceros, consulte el repositorio de webhooks. Para obtener más información sobre la creación de webhooks de Notebook Server y Workflow Manager, consulte Automatizar flujos de trabajo con ArcGIS Notebooks y Crear trabajos con webhooks, respectivamente.
• Para configurar webhooks para un servicio de entidades, el servicio debe incluir la funcionalidad de edición y tener habilitado el rastreo de cambios sin sincronización.
• Para configurar webhooks para un servicio de geoprocesamiento, el servicio debe ser asíncrono.

Nota:

En esta versión, los webhooks de servicios son características beta. Mientras estén en beta, es posible que estas características no estén completas y presenten problemas de rendimiento o calidad conocidos y el Soporte técnico de Esri no ofrecerá soporte. La documentación beta de la API de los webhooks de servicio está disponible en la Guía de API para administradores de webhooks de servicio PDF. Para obtener más información sobre las características beta de ArcGIS Enterprise, consulte Características beta.

Crear un webhook de organización

Los webhooks de organización le permiten suscribirse a desencadenadores de eventos asociados con sus elementos, grupos y usuarios del portal de ArcGIS Enterprise.

Nota:

Para ver una solicitud POST de ejemplo que crea un webhook acerca de eventos relacionados con usuarios, grupos y elementos, consulte la documentación de la API REST Crear webhook.

Para crear un webhook para su organización, siga estos pasos:

1. Vaya al Directorio de Portal for ArcGIS e inicie sesión como miembro con rol de administrador.

   Solo los administradores o miembros a los que se les haya asignado el rol de administrador predeterminado pueden crear y administrar webhooks.

   https://machine.domain.com/webadaptor/sharing/rest

   Una vez que haya iniciado sesión, aparecerá la página del recurso Usuario de su cuenta.

2. Haga clic en el hipervínculo Id. de organización o realice una solicitud del siguiente formulario para acceder a la página del recurso Portal Self:
   https://machine.domain.com/webadaptor/sharing/rest/portals/self

3. Desplácese hacia la parte inferior de la página de recursos Self y haga clic en Webhook > Crea webhook para acceder a la operación Crear webhook.
4. Cuando esté en el extremo Crear webhook, proporcione la siguiente información:
   1. Proporcione un nombre único para el webhook en el cuadro de texto Nombre.
   2. Proporcione la URL de carga del receptor webhook en el cuadro de texto URL de carga, que se consultará mientras se crea el webhook para garantizar que se pueda llevar a cabo una conexión correcta entre su receptor y el portal de ArcGIS Enterprise.

      A continuación, se muestra un ejemplo de URL de carga:

      https://app.logic.azure.com:443/workflows/b688528a36e246279dc050f936e5ebd4/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=nHP-LBo9x-nSgMi11DSDuwRIUiJr-8yKGCy7OYaT_ow

   3. Si lo desea, defina un secreto para el webhook que se pueda usar para autenticar mensajes de webhook con el receptor. Introduzca la cadena alfanumérica definida por el usuario en el cuadro de texto Secreto (opcional).
   4. Si lo desea, especifique la información de desactivación del webhook en el cuadro de texto Propiedades de configuración.

      De forma predeterminada, el webhook se desactiva si se han producido cinco fallos en el curso de cinco días.

   5. En Qué eventos querría que desencadenasen este webhook, seleccione Permitirme definir manualmente o Enviarme todo.
      • Si elige Permitirme definir manualmente, enumere los eventos desencadenadores que se usarán para este webhook en el cuadro de texto Enviarme cambios para estos eventos separados por comas. Por ejemplo, si desea suscribirse a todos los eventos pertenecientes a un grupo específico de su organización, introduzca un evento desencadenador similar al que se muestra a continuación, donde [groupID] representa el Id. único asociado a un grupo específico:
        /groups/[groupID]/update

        Para ver una lista de todos los desencadenadores de eventos compatibles con los webhooks de la organización, consulte el tema Desencadenadores de eventos.
      • Si elige Enviarme todo, se le suscribe a todos los eventos desencadenadores compatibles. Recibirá notificaciones de cada evento a medida que ocurran.
5. Una vez configurados los parámetros anteriores, haga clic en Crear webhook para enviar la solicitud.

   Una vez que la operación se complete, se agregará un nuevo webhook a su organización.

Configurar parámetros avanzados para webhooks de organización

La configuración avanzada aplicada a los webhooks de su organización le permite personalizar aún más el rendimiento de los webhooks, por ejemplo, especificando el número de intentos de entrega, el tiempo de notificación y el tiempo entre intentos de entrega.

Nota:

Para ver una solicitud POST de ejemplo que configura estas propiedades avanzadas, consulte la documentación de la API REST Actualizar configuración de webhook.

Para definir estas propiedades avanzadas, haga lo siguiente:

1. Vaya al Directorio de Portal for ArcGIS e inicie sesión como miembro con rol de administrador. Solo los administradores o miembros a los que se les haya asignado el rol de administrador predeterminado pueden crear y administrar webhooks.
   https://machine.domain.com/webadaptor/sharing/rest

   Una vez que haya iniciado sesión, aparecerá la página del recurso Usuario de su cuenta.

2. Haga clic en el hipervínculo Id. de organización o realice una solicitud del siguiente formulario para acceder a la página del recurso Portal Self:
   https://machine.domain.com/webadaptor/sharing/rest/portals/self

3. Desplácese hacia la parte inferior de la página de recursos Self y haga clic en Webhook > Configuración > Actualizar para acceder a la operación Actualizar configuración de webhook.
4. Cuando esté en el extremo Actualizar configuración de webhook, proporcione la siguiente información:
   1. Defina un valor para Número de intentos de notificación.

      Este valor especifica el número de intentos que se realizarán para enviar las cargas de webhooks. De forma predeterminada, el portal de ArcGIS Enterprise intentará enviar cargas tres veces. El valor de intentos debe ser un entero entre 0 y 5.

   2. Defina un valor para Tiempo de espera de notificación en segundos.

      Este valor especifica el periodo de tiempo, en segundos, que esperará el portal de ArcGIS Enterprise para recibir una respuesta de un receptor. De forma predeterminada, el portal de ArcGIS Enterprise esperará 10 segundos. El valor del número de segundos que el portal de ArcGIS Enterprise esperará debe ser un entero entre 0 y 60 segundos.

   3. Establezca un valor para Tiempo de notificación transcurrido en segundos.

      Este valor especifica la cantidad de tiempo, en segundos, entre cada intento de envío de carga. De forma predeterminada, el portal de ArcGIS Enterprise intentará enviar otra carga después de 5 segundos si se produce un error en el intento anterior hasta que se haya alcanzado el número de intentos especificado en Número de intentos de notificación.

5. Una vez configurados los parámetros anteriores, haga clic en Actualizar configuración de webhook para enviar la solicitud.

   Una vez completada la operación, las propiedades actualizadas se aplicarán a todos los webhooks de la organización configurados.

Crear un webhook de servicios de geoprocesamiento

Los webhooks de servicios de geoprocesamiento le permiten suscribirse a desencadenantes de eventos específicos asociados con los servicios de geoprocesamiento.

Nota:

Para ver una solicitud POST de ejemplo que crea un webhook para servicios de geoprocesamiento, consulte la documentación beta de la API REST de webhooks en la Guía de API para administradores de webhooks de servicio PDF.

Para crear un webhook para un servicio de geoprocesamiento, siga estos pasos:

1. Vaya al Directorio de administrador de ArcGIS Server e inicie sesión como miembro con los privilegios administrativos apropiados asignados.
   Solo los administradores que tengan asignados los privilegios de administrador de Actualizar, Eliminar, Seguridad e infraestructura o Servidores o a los que se les haya asignado el rol de administrador predeterminado pueden crear y administrar webhooks.
   https://machine.domain.com/webadaptor/admin

2. Una vez iniciada la sesión, busque el recurso Webhooks para un servicio de geoprocesamiento haciendo clic en Servicios > [ServiceName] > Webhooks > Crear, donde [ServiceName] representa el servicio para el que se creará el webhook. Para los servicios alojados en carpetas específicas, haga clic en Servicios > [FolderName] > [ServiceName] > Webhooks > Crear, donde [FolderName] representa la carpeta donde se encuentra el servicio.

   Precaución:

   Para configurar webhooks para un servicio de geoprocesamiento, el servicio de geoprocesamiento debe ser asíncrono.

3. Cuando esté en el extremo Crear webhook, proporcione la siguiente información:
   1. Proporcione un nombre único para el webhook en el cuadro de texto Nombre. El nombre proporcionado solo puede contener valores alfanuméricos, ya que el uso de caracteres especiales dará lugar a una respuesta de error.
   2. Si lo desea, defina un secreto para el webhook que se pueda usar para autenticar mensajes de webhook con el receptor. Introduzca la cadena alfanumérica definida por el usuario en el cuadro de texto Clave de firma.
   3. Proporcione la URL de carga del receptor webhook en el cuadro de texto URL de hook, que se consultará mientras se crea el webhook para garantizar que se pueda realizar una conexión correcta entre el receptor y ArcGIS Server de la implementación. A continuación, se muestra un ejemplo de carga:
      https://app.logic.azure.com:443/workflows/b688528a36e246279dc050f936e5ebd4/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=nHP-LBo9x-nSgMi11DSDuwRIUiJr-8yKGCy7OYaT_ow

   4. Si lo desea, especifique el tipo de medio. En el menú desplegable Tipo de contenido, elija cualquiera de las siguientes opciones:
      • application/json (predeterminado)
      • application/x-www-form-urlencoded
   5. Si lo desea, defina el formato de las cargas. En el menú desplegable Formato de carga, elija cualquiera de las siguientes opciones:
      • JSON (predeterminado)
      • PJSON
   6. Si lo desea, use el parámetro Activo para deshabilitar o habilitar devoluciones de llamadas cuando se desencadena el webhook. Para habilitarlas, seleccione True. Para deshabilitarlas, seleccione False.

      El valor predeterminado es que las devoluciones de llamadas estén habilitadas.

4. Una vez configurados los parámetros anteriores, haga clic en Crear para enviar la solicitud.

   Una vez completada la operación, se aplica un nuevo webhook al servicio de geoprocesamiento específico.

Nota:

A diferencia de los webhooks de organización y de servicios de entidades, los webhooks de servicios de geoprocesamiento no tienen desencadenadores de eventos definidos por el usuario. Los webhooks de servicios de geoprocesamiento envían cargas una vez que se haya completado un trabajo de geoprocesamiento. Para obtener más información sobre las cargas enviadas para servicios de geoprocesamiento, consulte el tema Cargas.

Crear un webhook de servicios de entidades

Los webhooks de servicios de entidades le permiten suscribirse a desencadenantes de eventos específicos asociados con los servicios de entidades.

Nota:

Para ver una solicitud POST de ejemplo que crea un webhook para servicios de entidades, consulte la documentación beta de la API REST de webhooks en la Guía de API para administradores de webhooks de servicio PDF.

Para crear un webhook para un servicio de entidades, siga estos pasos:

1. Vaya al Directorio de administrador de ArcGIS Server e inicie sesión como miembro con los privilegios administrativos apropiados asignados.

   Solo los administradores que tengan asignados los privilegios de administrador de Actualizar, Eliminar, Seguridad e infraestructura o Servidores o a los que se les haya asignado el rol de administrador predeterminado pueden crear y administrar webhooks.

   https://machine.domain.com/webadaptor/admin

2. Una vez iniciada la sesión, busque el recurso Webhooks para un servicio de entidades haciendo clic en Servicios > [ServiceName] > Webhooks > Crear, donde [ServiceName] representa el servicio para el que se creará el webhook. Para los servicios alojados en carpetas específicas, haga clic en Servicios > [FolderName] > [ServiceName] > Webhooks > Crear, donde [FolderName] representa la carpeta donde se encuentra el servicio.

   Precaución:

   Para configurar webhooks para un servicio de entidades, el servicio de entidades debe incluir la funcionalidad de edición y tener habilitado el rastreo de cambios sin sincronización.

3. Cuando esté en el extremo Crear webhook, proporcione la siguiente información:
   1. Proporcione un nombre único para el webhook en el cuadro de texto Nombre. El nombre proporcionado solo puede contener valores alfanuméricos, ya que el uso de caracteres especiales dará lugar a una respuesta de error.
   2. Enumere los desencadenadores de eventos que se usarán para este webhook en el cuadro de texto Cambiar tipo. Por ejemplo, para invocar el webhook cada vez que se cree un servicio de entidades, utilice el siguiente desencadenador de evento:

      Ejemplo

      FeaturesCreated

      Para ver una lista de todos los desencadenadores de eventos compatibles con los webhooks de servicios de entidades, consulte el tema Desencadenadores de eventos.
   3. Si lo desea, defina un secreto para el webhook que se pueda usar para autenticar mensajes de webhook con el receptor. Introduzca la cadena alfanumérica definida por el usuario en el cuadro de texto Clave de firma.
   4. Proporcione la URL de carga del receptor webhook en el cuadro de texto URL de hook, que se consultará mientras se crea el webhook para garantizar que se pueda realizar una conexión correcta entre el receptor y ArcGIS Server de la implementación. A continuación, se muestra un ejemplo de carga:
      https://app.logic.azure.com:443/workflows/b688528a36e246279dc050f936e5ebd4/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=nHP-LBo9x-nSgMi11DSDuwRIUiJr-8yKGCy7OYaT_ow

   5. Si lo desea, especifique el tipo de medio. En el menú desplegable Tipo de contenido, elija cualquiera de las siguientes opciones:
      • application/json (predeterminado)
      • application/x-www-form-urlencoded
   6. Si lo desea, defina el formato de las cargas. En el menú desplegable Formato de carga, elija cualquiera de las siguientes opciones:
      • JSON (predeterminado)
      • PJSON
   7. Si lo desea, use el parámetro Activo para deshabilitar o habilitar devoluciones de llamadas cuando se desencadena el webhook. Para habilitarlas, seleccione True. Para deshabilitarlas, seleccione False.

      El valor predeterminado es que las devoluciones de llamadas estén habilitadas.

   8. Ajuste la programación de webhooks al modificar la información de Segundos en el cuadro de texto Programa. En el caso de servicios de entidades que experimentan muchas ediciones frecuentes, reduzca el valor Segundos para recibir webhooks de forma más frecuente con menos información de eventos en la carga. En el caso de los servicios de entidades que no experimentan cambios frecuentes, aumente el valor de la propiedad Segundos para recibir webhooks con menos frecuencia y que contienen más información de eventos en la carga.

      El valor mínimo y predeterminado para la programación es de 20 segundos.

4. Una vez configurados los parámetros anteriores, haga clic en Crear para enviar la solicitud.

   Una vez completada la operación, se aplica un nuevo webhook al servicio de entidades específico.