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

Licence :

Ces fonctions nécessitent une licence pour le rôle ArcGIS Workflow Manager Server Advanced.

Vous pouvez configurer un webhook sur le site Web ArcGIS Survey123 pour créer automatiquement des tâches dans ArcGIS Workflow Manager lorsqu’une enquête est envoyée.

Pour que vous puissiez envoyer des enquêtes pour créer des tâches dans Workflow Manager, l’enquête doit être hébergée sur le même portail ArcGIS Enterprise que Workflow Manager Server et partagée avec l’utilisateur qui envoie l’enquête. Pour créer des tâches dans Workflow Manager avec une enquête Survey123 hébergée publiquement, configurez une action automatisée Webhook Job Creation (Création d’une tâche de webhook) avec la méthode d’authentification ArcGIS Webhook.

Remarque :

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

Pour configurer un webhook Survey123, procédez comme suit :

1. Accédez à l’application Web Workflow Manager.
2. Cliquez sur l’onglet Design (Création).

   La page Design (Création) apparaît.

   Remarque :

   Si vous ne disposez pas de privilèges suffisants, l’onglet Design (Création) n’est pas disponible.

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

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

4. Choisissez le modèle de tâche que vous voulez utiliser pour créer des tâches lorsqu’une enquête est envoyée dans le panneau Job Templates (Modèles de tâche).

   Le modèle de tâche apparaît dans le panneau.

   Conseil :

   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. Créez une table de propriétés étendues pour le modèle de tâche.

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

6. Notez l’identifiant de l’élément de workflow et le modèle de tâche dans la d’adresse de votre navigateur Web.

   Par exemple :

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

   Vous aurez besoin de ces informations pour configurer le webhook de votre enquête.

7. Configurez un webhook sur le ArcGIS Survey123 pour l’enquête, à l’aide des paramètres suivants :

   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. 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 à créer des tâches dans Workflow Manager lorsqu’une réponse à une enquête est envoyée.