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

Licence :

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

Vous pouvez configurer des webhooks pour les enquêtes ArcGIS Survey123 afin de créer automatiquement des tâches dans ArcGIS Workflow Manager lorsqu’une enquête est envoyée.

Avant de pouvoir envoyer des enquêtes pour créer des tâches dans Workflow Manager, vous devez effectuer les opérations suivantes :

• Définissez le paramètre allowUnsecureWebhooks sur true dans le fichier de configuration de Workflow Manager.
• Hébergez l’enquête sur le même portail ArcGIS Enterprise que Workflow Manager Server et partagez l’enquête avec l’utilisateur qui l’envoie.

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), les webhooks de Survey123 ne peuvent pas être utilisés pour créer des tâches dans Workflow Manager.

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 (Création) n’est pas disponible.

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

   Le panneau 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 pour votre enquête en utilisant les 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.