Ajouter et configurer l’étape Define Location (Définir la localisation)

L’étape Define Location (Définir la localisation) vous permet d’identifier là où le travail doit être effectué pour une tâche. La localisation peut être un point, une ligne ou un polygone dans un service d’entités existant, dans un projet ArcGIS Pro ou dans une carte Web de l’application Web ArcGIS Workflow Manager.

Si l’étape est exécutée dans l’application Web Workflow Manager et que la méthode de sélection choisie est Map (Carte), la carte Web configurée dans l’étape apparaît dans la vignette de la tâche. Si un texte d’aide est configuré pour l’étape, il apparaît en bas de la vignette de la tâche. Les couches sélectionnables apparaissent sur la carte et toutes les couches supplémentaires, sauf la couche Job Location(Localisation de la tâche) sont en lecture seule. Utilisez le widget Manage Layers (Gérer les couches) pour modifier la visibilité de chaque couche et utilisez le widget Draw A Feature (Dessiner une entité) ou Select Features (Sélectionner des entités) pour définir la localisation de la tâche.

Remarque :

Si la localisation de la tâche est déjà définie, elle ne peut pas être mise à jour, mais vous pouvez la remplacer en dessinant ou en sélectionnant de nouvelles entités.

Si l’étape est exécutée dans ArcGIS Pro et que la méthode de sélection Map (Carte) est choisie, la couche Job Location (Localisation de la tâche) est ajoutée à la carte configurée dans l’étape lorsque l’étape est exécutée et la fenêtre Create Features (Créer des entités) apparaît avec la couche Job Location (Localisation de la tâche). Si un texte d’aide est configuré pour l’étape, il apparaît en bas de la vignette de la tâche. Utilisez la fenêtre Create Features (Créer des entités) pour définir la localisation de la tâche.

Le type de géométrie utilisé pour la localisation de la tâche dépend du type de géométrie configuré dans l’étape. Tenez compte des conditions suivantes lors de la définition de la localisation d’une tâche :

• Seules les entités dotées du type de géométrie correct peuvent être enregistrées en tant que localisation de la tâche.
• Si plusieurs polygones ou entités linéaires du type de géométrie adéquat sont sélectionnés, la localisation est enregistrée en tant qu’entité multi-parties.
• Le fait de dessiner une localisation dans l’application Web Workflow Manager entraîne le retrait des sélections existantes et le fait de sélectionner des entités entraîne le retrait des localisations dessinées.

Si vous optez pour la méthode de sélection Map (Carte), il est possible d’effectuer les actions suivantes lorsque l’étape est exécutée :

• La localisation de la tâche peut être définie.
• Pour annuler l’étape, cliquez sur Cancel (Annuler).
• Pour terminer l’étape, cliquez sur Proceed (Continuer).

Si vous optez pour la méthode de sélection Arcade, la localisation de la tâche est automatiquement définie lorsque l’étape est exécutée et cette dernière se termine automatiquement. Si la géométrie renvoyée par l’expression Arcade a une valeur nulle ou non valide, l’étape échoue. Si le type de géométrie renvoyé par l’expression Arcade ne correspond pas au type de géométrie configuré dans l’étape, l’étape échoue.

Configurer l’étape

Pour configurer l’étape, 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 Define Location (Définir la localisation) depuis le volet Step Library (Bibliothèque d’étapes) vers une flèche de connexion d’une étape de la zone d’affichage du workflow.

   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. Ajoutez éventuellement le message que vous voulez faire apparaître lors de l’exécution de l’étape dans la zone de texte User Prompt (Invite utilisateur).

   Vous pouvez également vous servir de l’exemple suivant pour afficher une valeur dynamique à l’aide d’expressions ArcGIS Arcade.

   
   'This job is currently assigned to ' + jobOwner($job) + '.'

5. Cliquez sur la flèche de la liste déroulante Geometry Type (Type de géométrie) et sélectionnez un type de sélection de géométrie pour la localisation de la tâche.
6. Sélectionnez l’une des options suivantes :
   • Map (Carte) : permet à un utilisateur de définir la localisation de la tâche sur une carte.
   • Geometry (Géométrie) : définissez automatiquement la localisation de la tâche à l’aide de coordonnées au format JSON Esri.
7. Si vous avez sélectionné Map (Carte), effectuez ces étapes :
   1. Sélectionnez les options Location Method (Méthode de localisation) le cas échéant :
      • Select (Sélectionner) : sélectionnez les entités existantes sur la carte
      • Draw (Dessiner) : créez des entités avec les outils de dessins de ArcGIS Pro ou avec les widgets de l’application Web Workflow Manager.
   2. Dans la section Map (Carte) sous Web Map (Carte Web), cliquez sur Add (Ajouter) pour ajouter la carte Web que vous souhaitez utiliser avec l’application Web Workflow Manager.

      La boîte de dialogue Define Location Step (Étape Définir la localisation) apparaît.

      Remarque :

      Les cartes Web ne peuvent pas être utilisées pour définir une localisation dans ArcGIS Pro. Vous devez indiquer le nom de la carte que vous souhaitez utiliser dans un projet ArcGIS Pro afin de définir une localisation.

   3. Sélectionnez l’une des options suivantes pour indiquer où se trouve la carte Web :
      • This Enterprise (Ce portail Enterprise) : ajoutez une carte Web disponible sur le même portail que Workflow Manager.
      • ArcGIS Online : ajoutez une carte Web publique située sur ArcGIS Online.
      • Other (Autre) : ajoutez une carte Web publique située sur un autre portail.
   4. Si vous sélectionnez Other (Autre), saisissez l’URL du portail qui contient la carte Web dans la zone de texte Portal URL (URL du portail) et appuyez sur Entrée.

      Par exemple, https://webadaptorhost.domain.com/webadaptorname.

   5. Saisissez l’ID d’élément de la carte Web dans la zone de texte Item ID (ID de l’élément).
   6. Saisissez un nom pour la carte Web dans la zone de texte Reference Name (Nom de référence).
   7. Cliquez sur  OK.

      L’URL de la carte Web apparaît dans le volet Step Details (Détails de l’étape).

      Remarque :

      Vous pouvez mettre à jour la carte Web en cliquant sur Edit (Mettre à jour) ou la supprimer en cliquant sur Remove (Supprimer).

   8. Indiquez le nom de la carte que vous souhaitez utiliser dans votre projet ArcGIS Pro dans la zone de texte ArcGIS Pro.
   9. Si le paramètre Enable Search (Activer la recherche) est configuré pour votre carte Web, vous pouvez indiquer un ensemble de définition, un texte de recherche ou une expression Arcade dans la zone de texte Search Text (Texte de recherche) pour effectuer un zoom sur une étendue de carte initiale lorsque l’étape est exécutée dans l’application Web Workflow Manager.
8. Si vous avez sélectionné Geometry (Géométrie), utilisez les exemples suivants pour définir la localisation de la tâche à l’aide de coordonnées au format JSON Esri.

   Vous pouvez utiliser une chaîne, une expression Arcade ou une combinaison des deux pour définir la localisation.

   Définissez la localisation d’un point à l’aide d’une chaîne JSON.

   {"x" : -118.15, "y" : 33.80, "spatialReference" : {"wkid" : 4326}}

   Définissez la localisation d’un point à l’aide d’une expression Arcade.

   '{"x":' + jobOutputValue($job, '6d3a2e62-41f3-0ca5-d14a-bf87b8e4e4ec', 'testx') +', "y":' +jobOutputValue($job, '6d3a2e62-41f3-0ca5-d14a-bf87b8e4e4ec', 'testy') + ', "spatialReference" : {"wkid" : ' +jobOutputValue($job, '6d3a2e62-41f3-0ca5-d14a-bf87b8e4e4ec', 'wkid') + "}}"

   Définissez la localisation d’un point à l’aide d’une expression Arcade qui convertit les coordonnées GeoJSON au format JSON Esri.

   {geoJsonToEsriJson(jobExtendedProperty($job,
   'assets', 'geojson'), 'Point'),"spatialReference" : {"wkid" : 4326}}

   Définissez une localisation à l’aide du champ shape :

   jobExtendedProperty($job, '<table_name>','shape')

   Remarque :

   Le champ shape est le nom du champ utilisé pour obtenir la géométrie à partir d’une table de propriétés étendues.

   La référence spatiale par défaut est Web Mercator Auxiliary Sphere (wkid 3857). Si la géométrie renvoyée par l’expression Arcade a une référence spatiale différente, la localisation est définie et la référence spatiale est convertie en wkid 3857.

9. Cliquez sur l’onglet Options.
10. Configurez Step Options (Options de l’étape) si nécessaire.
    • Manual (Manuel) : l’étape est exécutée manuellement.
      • Optional (Facultatif) : permet de finaliser la tâche sans l’exécuter.
    • Automatic (Automatique) : l’étape est exécutée dès qu’elle devient active.

      Remarque :

      Si votre diagramme de processus est configuré pour exécuter automatiquement une séquence d’étapes qui comprend l’étape Evaluate Data Quality (Évaluer la qualité des données) ou Run GP Service (Exécuter un service de géotraitement), les étapes censées s’exécuter après l’expiration du jeton utilisateur ayant démarré la séquence d’étapes ne démarrent pas automatiquement. Vous devez disposer d’une licence pour que le rôle ArcGIS Workflow Manager Server Advanced continue d’exécuter les étapes automatisées supplémentaires sans intervention manuelle.

    • Run on a Schedule (Exécuter selon une planification) : l’étape s’exécute selon une planification que vous définissez.

      En savoir plus sur les options de planification

11. Saisissez éventuellement un texte d’aide pour l’étape dans la zone de texte Step Help (Aide de l’étape).

    Vous pouvez également vous servir de l’exemple suivant pour afficher une valeur dynamique à l’aide d’expressions ArcGIS Arcade.

    
    'For further assistance, please contact ' + jobCreator($job) + '.'

12. Cliquez éventuellement sur l’onglet Style pour changer la forme et la couleur de l’étape.
13. Cliquez éventuellement sur l’onglet About (À propos de) et spécifiez une description pour l’étape dans la zone de texte Step Description (Description de l’étape).

    Remarque :

    L’onglet About (À propos de) contient également l’ID de l’étape qui peut être utilisé avec les propriétés de tâche dynamiques pour obtenir la sortie d’une étape.

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 ArcGIS Arcade. Le tableau suivant répertorie les valeurs de retour de l’étape :

Valeurs renvoyées	Description
S000001	L’étape s’est terminée correctement.
F000001	L’étape ne s’est pas terminée correctement.

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 indique la valeur en sortie de l’étape :

Sortie	Description	Syntaxe de l’expression ArcGIS Arcade
<Location>	Renvoie la localisation définie.	jobOutputValue($job, '<step_id>')