Créer des tâches à l’aide d’un webhook Survey123

Licence :

This functionality requires a license for the ArcGIS Workflow Manager Server Advanced role.

Vous pouvez configurer des webhooks pour les enquêtes ArcGIS Survey123 afin de créer automatiquement des tâches dans ArcGIS Workflow Manager une fois les enquêtes envoyées. Chaque utilisateur qui soumet des enquêtes entraînant la création automatique de tâches dans Workflow Manager doit détenir une licence pour l’extension du type d’utilisateur ArcGIS Workflow Manager, ainsi que des privilèges suffisants pour créer des tâches.

Remarque :

L’enquête doit être hébergée sur le même portail ArcGIS Enterprise que Workflow Manager.

Si ArcGIS Workflow Manager est fédéré avec un portail ArcGIS Enterprise qui utilise l’authentification Windows (IWA) ou PKI (infrastructure à clé publique), les webhooks de Survey123 ne peuvent pas être utilisés pour créer des tâches dans Workflow Manager.

Attention :

Lorsque vous créez ou modifiez un webhook pour une enquête, cette dernière doit être mise à jour dans l’application de terrain Survey123 pour que les modifications prennent effet.

1. Créez une table de propriétés étendues pour le modèle de tâche que vous voulez utiliser pour créer les tâches lorsqu’une enquête est envoyée.

   Cela permet que les données de l’enquête soient associées aux tâches.

2. Localisez l’identifiant de l’élément de workflow et du modèle de tâche que vous souhaitez utiliser.
   1. Accédez à l’application Web Workflow Manager.
   2. Cliquez sur l'onglet Design (Création).

      La page Design (Conception) apparaît.

      Remarque :

      Si vous ne disposez pas de privilèges suffisants, l’onglet Design (Conception) n’apparaît pas.

   3. Cliquez sur le bouton Job Templates (Modèles de tâche) .

      Le panneau Job Templates (Modèles de tâche) apparaît.

   4. Cliquez sur le modèle de tâche à utiliser dans le panneau Job Templates (Modèles de tâche).

      Remarque :

      Vous pouvez saisir un mot-clé dans la zone de texte Search Job Templates (Rechercher des modèles de tâche) afin de filtrer la liste et afficher les modèles de tâche contenant le mot-clé.

   5. Localisez l’identifiant de l’élément de workflow et du modèle de tâche dans l’URL de la barre d’adresse de votre navigateur Web.

      Par exemple : https://gisserver.domain.com/webadaptorname/apps/workflowmanager/<workflow item id>/design/jobTemplate/<job template id>

3. Configurez un webhook pour votre enquête en utilisant les paramètres suivants :
   1. Dans le champ Payload URL, indiquez l'URL de Workflow Manager comme dans l’exemple suivant :
      https://gisserver.domain.com/webadaptorname/workflow/<workflow item id>/webhooks/createJobFromSurveyResponse/<job template id>
   2. Dans la section Trigger events (Événements déclencheurs), cochez la case New record submitted (Nouvel enregistrement envoyé).
   3. Dans la section Event data (Données d’événement), cochez les cases suivantes :
      • Informations sur l’enquête
      • Enregistrement envoyé
      • Informations sur le portail

Le webhook est prêt à être utilisé. Il crée une tâche dans Workflow Manager chaque fois qu’une réponse à une enquête est envoyée.