Crear trabajos con webhooks

Licencia:

Esta funcionalidad requiere una licencia para el rol de ArcGIS Workflow Manager Server Advanced.

Los webhooks permiten a las aplicaciones enviar información a otras aplicaciones y servicios cuando se produce una acción o evento específico. ArcGIS Workflow Manager le permite procesar información a partir de webhooks entrantes para crear trabajos a partir de la plantilla de trabajo especificada automáticamente. También puede guardar la carga del webhook entrante como un archivo y adjuntarlo al trabajo, así como configurar valores de salida personalizados que se pueden utilizar en todo el trabajo.

Crear un webhook entrante

Complete estos pasos para crear un webhook entrante:

1. Acceda a la aplicación web de Workflow Manager.
2. Haga clic en la pestaña Diseño.

   Aparece la página Diseño.

   Nota:

   Si no tiene suficientes privilegios, la pestaña Diseño no estará disponible.

3. Haga clic en Plantillas de trabajo .

   Aparece el panel Plantillas de trabajo.

4. Haga clic en la plantilla de trabajo para la que desea crear un webhook entrante.

   La plantilla de trabajo aparece en el panel.

5. Haga clic en la pestaña Acciones automatizadas.

   Si no tiene licencia para el rol ArcGIS Workflow Manager Server Advanced o suficientes privilegios, no puede configurar acciones automatizadas.

6. En la sección Creación de trabajos de webhook, haga clic en Agregar webhook.

   Aparece el cuadro de diálogo Crear webhook.

7. Proporcione un nombre para el webhook en el cuadro de texto Nombre.
8. Proporcione un nombre de usuario y una contraseña en los cuadros de texto Nombre de usuario y Contraseña para crear credenciales para el webhook entrante.

   También puede usar una expresión ArcGIS Arcade en los cuadros de texto Nombre de usuario y Contraseña para rellenar dinámicamente estos valores con la configuración cifrada definida por el usuario.

   Precaución:

   La información que proporcione en los cuadros de texto Nombre de usuario y Contraseña no se cifra. Se recomienda crear configuraciones cifradas definidas por el usuario para almacenar credenciales de webhook de forma segura.

   Sugerencia:

   Haga clic en el botón La entrada admite expresiones de Arcade y elija una expresión ArcGIS Arcade para agregarla a su cuadro de texto asociado.

9. Si lo desea, active el Nombre de usuario y la contraseña de reserva y configure un conjunto de copia de seguridad de credenciales para el webhook proporcionando un nombre de usuario y una contraseña en los cuadros de texto Nombre de usuario de reserva y Contraseña de reserva.

   También puede usar una expresión ArcGIS Arcade en los cuadros de texto Nombre de usuario y Contraseña para rellenar dinámicamente estos valores con la configuración cifrada definida por el usuario.

   Precaución:

   La información que proporcione en los cuadros de texto Nombre de usuario de reserva y Contraseña de reserva no se cifra. Se recomienda crear configuraciones cifradas definidas por el usuario para almacenar credenciales de webhook de forma segura.

10. Para usar la autenticación de clave secreta, active Clave secreta de encabezado y proporcione valores para la clave secreta en los cuadros de texto Clave y Valor.
11. Si lo desea, haga clic en la pestaña Carga y active Adjuntar respuesta para guardar la carga del webhook entrante como un archivo y adjuntarla al trabajo.
12. Si lo desea, siga estos pasos para configurar el nombre del adjunto y la carpeta en la que se almacenará:
    1. Proporcione el nombre de la carpeta en la que se almacenará el adjunto en el cuadro de texto Nombre de carpeta.

       El nombre de la carpeta no puede contener una ruta de sistema de archivos ni caracteres especiales. Si no se proporciona un nombre de carpeta, se crea automáticamente una carpeta denominada General.

       Nota:

       La carpeta está contenida en el elemento de flujo de trabajo y no es una ruta de sistema de archivos.

    2. Seleccione una de las siguientes opciones de Nombre de adjunto:
       • Generado automáticamente: nombra automáticamente el adjunto con la siguiente sintaxis: <StepName>_<RunDate>_<RunTime>.
       • Personalizado: permite proporcionar un nombre de adjunto personalizado.
13. Opcionalmente, siga estos pasos para analizar la carga del webhook entrante y configurar valores de salida personalizados:
    1. Si el origen del webhook entrante es un webhook de servicio de entidades, puede activar Extraer cambios para usar los cambios extraídos en sus valores de salida.
    2. Haga clic en el botón de alternancia Modo de prueba en la sección Valores de salida.
    3. Pegue un ejemplo de la carga del webhook entrante en el cuadro de texto Respuesta de muestra.

       Ejemplo de carga en formato JSON:

       {"spatialReference": {
         "wkid": 4326,
         "latestWkid": 4326
       },
       "locations": [
         {
           "name": "380 New York Street",
           "extent": {
             "xmin": -117.196701,
             "ymin": 34.055489
           }
         }
       ]}

    4. Haga clic en Agregar salida y ruta.
    5. Proporcione un nombre para el valor de salida en el cuadro de texto Valor de salida.

       Este es el nombre del valor que se utiliza para obtener el valor de salida personalizado.

    6. Proporcione una expresión JSONPath en notación de puntos o notación entre corchetes para el valor que desea almacenar en el cuadro de texto Ruta de extracción.

       Ejemplo de JSONPath en notación de puntos:

       $locations.0.name

       Ejemplo de JSONPath en notación entre corchetes:

       $['locations'][0]['name']

       El valor aparece en la columna Resultado de muestra.

    7. Si lo desea, repita los subpasos c-e para agregar más valores de salida personalizados.
14. Haga clic en Guardar.

    El webhook entrante aparece en la sección Creación de trabajos de webhook.

15. Haga clic en Guardar para guardar la plantilla de trabajo.

    Al webhook se le asigna un Id. y una dirección URL.

16. Desplace el cursor por el webhook y haga clic en el botón Copiar dirección URL para copiar la dirección URL del webhook entrante al portapapeles y configurarla para su uso en su aplicación.

Editar un webhook

Complete estos pasos para editar un webhook entrante:

1. Acceda a la aplicación web de Workflow Manager.
2. Haga clic en la pestaña Diseño.

   Aparece la página Diseño.

   Nota:

   Si no tiene suficientes privilegios, la pestaña Diseño no estará disponible.

3. Haga clic en Plantillas de trabajo .

   Aparece el panel Plantillas de trabajo.

4. Haga clic en la plantilla de trabajo que contiene el webhook entrante que desea editar.

   La plantilla de trabajo aparece en el panel.

5. Haga clic en la pestaña Acciones automatizadas.

   Si no tiene licencia para el rol ArcGIS Workflow Manager Server Advanced o suficientes privilegios, no puede configurar acciones automatizadas.

6. En la sección Creación de trabajos de webhook, pase el cursor por el webhook entrante que desea editar y haga clic en Editar.

   Aparece el cuadro de diálogo Crear webhook.

7. Actualice la configuración del webhook entrante según sea necesario.
8. Haga clic en Guardar para guardar los cambios.
9. Haga clic en Guardar para guardar la plantilla de trabajo.

   El webhook entrante se actualiza.

Eliminar un webhook

La eliminación de un webhook entrante es permanente y no se puede deshacer. Complete estos pasos para eliminar un webhook entrante:

1. Acceda a la aplicación web de Workflow Manager.
2. Haga clic en la pestaña Diseño.

   Aparece la página Diseño.

   Nota:

   Si no tiene suficientes privilegios, la pestaña Diseño no estará disponible.

3. Haga clic en Plantillas de trabajo .

   Aparece el panel Plantillas de trabajo.

4. Haga clic en la plantilla de trabajo que contiene el webhook entrante que desea eliminar.

   La plantilla de trabajo aparece en el panel.

5. Haga clic en la pestaña Acciones automatizadas.

   Si no tiene licencia para el rol ArcGIS Workflow Manager Server Advanced o suficientes privilegios, no puede configurar acciones automatizadas.

6. En la sección Creación de trabajos de webhook, pase el cursor por el webhook entrante que desea eliminar y haga clic en Eliminar webhook .

   Precaución:

   Los webhooks entrantes eliminados no se pueden recuperar.
7. Haga clic en Guardar para guardar la plantilla de trabajo.

   El webhook se elimina.