Ajouter et configurer Créer une tâche Field Maps

Disponible avec une licence Workflow Manager.

Dans ArcGIS Workflow Manager, l’étape Créer une tâche Field Maps vous permet de créer une tâche pour vous aider à gérer et à suivre le travail de terrain associé à votre travail à l’aide d’ArcGIS Field Maps. La fonctionnalité relative aux tâches dans Field Maps a pour but de vous aider à gérer et à suivre efficacement le travail sur le terrain. Dans un service d’entités utilisant des tâches, chaque entité est affichée en tant que tâche dans une liste interactive dans l’application mobile Field Maps.

Lorsque l’étape Créer une tâche Field Maps est exécutée, Workflow Manager crée automatiquement une nouvelle tâche dans votre service d’entités utilisant des tâches. L’étape met aussi automatiquement à jour les propriétés de la tâche à l’aide des valeurs spécifiées dans le volet Step Details (Détails de l’étape).

Un emplacement doit être défini pour le travail pour que l’étape Créer une tâche Field Maps s’exécute. Chaque tâche comporte une géométrie ponctuelle, polyligne ou surfacique héritée de l’emplacement du travail. Si l’emplacement de la tâche est un point et que l’emplacement du travail est une polyligne ou un polygone, le centroïde de l’emplacement du travail devient l’emplacement de la tâche. Si l’emplacement de la tâche est une polyligne ou un polygone, l’emplacement du travail doit être du même type de géométrie.

Optionnellement, Workflow Manager peut placer une dépendance webhook sur le travail, laquelle est automatiquement libérée lorsque le statut de la tâche répond aux conditions spécifiées dans le volet Step Details (Détails de l’étape). Pour cela, l’étape Créer une tâche Field Maps nécessite qu’une connexion webhook soit créée avec le service d’entités utilisant des tâches. Cela permet à Workflow Manager de recevoir des mises à jour sur le statut de la tâche. Une dépendance webhook est automatiquement ajoutée à l’étape qui suit l’étape Créer une tâche Field Maps.

Pour utiliser les dépendances webhook à l’étape Créer une tâche Field Maps, vous devez activer l’extension d’organisation Gestion des processus ArcGIS.

Conseil :

La dépendance webhook peut être visualisée sur l’onglet Holds (Suspensions), dans la section Dependencies (Dépendances).

Configurer l’étape

Pour configurer l’étape Créer une tâche Field Maps, procédez comme suit :

1. Créez ou mettez à jour un diagramme de processus pour accéder au volet Step Library (Bibliothèque d’étapes).
2. Faites glisser Create Field Maps Task (Créer une tâche Field Maps) depuis le volet Step Library (Bibliothèque d’étapes) vers une flèche de connexion d’une étape du canevas de processus.

   En savoir plus sur l’ajout d’étapes à un diagramme de processus.

   Le volet Step Details (Détails de l’étape) s’affiche.

3. Spécifiez un nom pour l’étape dans la zone de texte Step Name (Nom de l’étape).
4. Sélectionnez un service d’entités dans le menu déroulant Feature Service (Service d’entités).
5. Si aucun service d’entités n’est associé à votre diagramme de processus, ajoutez une référence de données de service d’entités.
   1. Cliquez sur Add data reference (Ajouter une référence de données) dans le menu déroulant.

      La boîte de dialogue Add data reference (Ajouter une référence de données) s’affiche.

   2. Ajoutez une référence de données de l’une des manières suivantes :
   • Browse for item (Rechercher l’élément) : parcourez une liste d’éléments sur le portail actuel et sélectionnez un élément.

     Conseil :

     Vous pouvez affiner les résultats en appliquant des filtres et des balises.

   • Enter item ID manually (Saisir l’ID d’élément manuellement) : indiquez l’ID d’élément et le nom de la référence dans les zones de texte Item ID (ID d’élément) et Reference Name (Nom de la référence). L’élément est validé automatiquement par Workflow Manager et le type de référence de données est défini.

   Si la référence de données ne peut pas être validée, vous devez indiquer l’ID d’élément d’une référence de données valide qui correspond au type de la référence de données définie.

   En savoir plus sur la gestion des références de données

6. Cliquez sur la flèche de liste déroulante Layer Name (Nom de la couche) et sélectionnez la couche utilisant les tâches dans laquelle vous souhaitez créer la tâche.

   Attention :

   • Un travail doit avoir un emplacement défini pour que l’étape Créer une tâche Field Maps s’exécute. Si l’emplacement de la tâche est une polyligne ou un polygone, l’emplacement du travail doit être du même type de géométrie.
   • Le service d’entités doit contenir au moins une couche utilisant les tâches pour être configuré avec l’étape Créer une tâche Field Maps.
7. Cliquez sur la flèche de la liste déroulante Change Input Type (Modifier le type d’entrée) et sélectionnez un type d’entrée dans la liste déroulante Task Type (Type de tâche).
   • Selection (Sélection) : sélectionnez un type de tâche qui correspond au type de tâche que vous souhaitez créer à partir du menu déroulant Task Type (Type de tâche).
   • Arcade : fournissez une expression ArcGIS Arcade pour référencer un code de domaine pour un type de tâche configuré dans votre couche utilisant les tâches.
8. Vous avez également la possibilité de configurer une propriété de tâche pour que l’étape se mette à jour lorsque la tâche est créée.
   1. Cliquez sur Add Task Property (Ajouter une propriété de tâche).
   2. Cliquez sur Show default value (Afficher la valeur par défaut) pour définir une valeur par défaut pour la propriété.
   3. Sélectionnez l’une des options suivantes :
      • Value (Valeur) : indiquez une valeur statique.
      • Arcade Expression (Expression Arcade) : indiquez une valeur dynamique à l’aide d’une expression Arcade.
   4. Indiquez une valeur par défaut pour la propriété dans la zone de texte Value (Valeur) ou Arcade Expression (Expression Arcade).
   5. Vous pouvez également cliquer sur Add Task Property (Ajouter une propriété de tâche) et répétez les étapes pour ajouter plus de propriétés.

      Conseil :

      Pour supprimer une propriété de tâche, positionnez le pointeur sur cette dernière et cliquez sur Delete Property (Supprimer la propriété).

   6. Vous pouvez également survoler une propriété, cliquer sur Reorder Property (Réorganiser la propriété) et la faire glisser vers l’emplacement souhaité pour réorganiser les propriétés.
9. Vous avez également la possibilité d’ajouter une dépendance webhook à l’étape.

   Licence :

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

   1. Cochez la case Add Webhook Dependency (Ajouter une dépendance webhook).
   2. Choisissez une connexion webhook à partir du menu déroulant Webhook Connection (Connexion webhook).

      Remarque :

      Pour ajouter une dépendance webhook, il est nécessaire qu’au moins une connexion webhook soit configurée avec le service d’entités sélectionné dans l’étape 4.

   3. Sous Release Condition (Condition d’annulation de la suspension), définissez les critères que le statut de la tâche doit remplir pour que la suspension de la dépendance soit levée.

      La condition d’annulation de la suspension doit être un statut qui indique que le travail de terrain est terminé. Par exemple, Task Status = Completed.

      Conseil :

      Plusieurs combinaisons de conditions d’annulation de la suspension peuvent être gérées à l’aide des opérateurs logiques AND et OR. Par exemple, si deux conditions d’annulation de la suspension sont configurées et que l’opérateur logique OR est utilisé, la suspension de la dépendance est levée lorsque le statut de la tâche correspond à l’une ou l’autre des valeurs. Si l’opérateur logique AND est utilisé, la suspension de la dépendance n’est annulée que lorsque le statut de la tâche correspond aux deux valeurs.

   4. Cliquez sur Add Release Condition (Ajouter une condition d’annulation de la suspension) pour ajouter d’autres conditions d’annulation de la suspension.

Valeur de retour

Une fois l’étape terminée, sa valeur de retour est stockée pour indiquer le résultat de l’étape. La valeur de retour peut être immédiatement évaluée en utilisant des chemins pour déterminer les prochaines étapes du processus. Vous pouvez également récupérer la valeur de retour des étapes terminées tout au long du processus à l’aide d’expressions Arcade.

Le tableau suivant répertorie les valeurs de retour de l’étape :

Valeur de retour	Description
S000001	L’étape s’est terminée correctement.
F000001	L’étape a échoué.

Valeur en sortie

Une fois que l’étape est terminée, sa valeur en sortie est stockée et peut être utilisée pour déterminer le chemin suivi par le processus. Elle peut également servir d’entrée pour d’autres étapes tout au long du processus. Le tableau suivant répertorie les valeurs en sortie de l’étape :

Sortie	Description
taskObjectId	Renvoie l’ID d’objet de la tâche créée à l’aide de l’étape Créer une tâche Field Maps
taskType	Renvoie la valeur codée du type de tâche pour la tâche créée à l’aide de l’étape Créer une tâche Field Maps
taskGlobalId	Renvoie l’ID Global de la tâche créée à l’aide de l’étape Créer une tâche Field Maps