L’étape Define Location (Définir la localisation) 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, un projet ArcGIS Pro ou 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 localisation choisie est Map (Carte), la carte Web configurée dans l’étape apparaît dans la vignette de la tâche. Si l’étape est configurée avec l’aide des étapes, elle 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 sélectionnant de nouvelles entités.
Si l’étape est exécutée dans ArcGIS Pro et que la méthode de localisation 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 l’étape est configurée avec l’aide des étapes, elle 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 avec des types de géométries de polygone, de polyligne ou de multipoint peuvent être enregistrées en tant qu’emplacement de la tâche. Les géométries de courbe ne sont pas prises en charge
- Les outils de construction de polyligne et de polygone Circle (Cercle), Ellipse, Stream (Flux), Freehand (Main levée) et Autocomplete Freehand (Automatique à main levée) ne peuvent pas être utilisés pour définir l’emplacement 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 localisation 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 localisation Geometry (Géométrie), la localisation de la tâche est automatiquement définie lorsque l’étape est exécutée et cette exécution est automatique. Si la géométrie renvoyée par une expression ArcGIS Arcade a une valeur nulle ou non valide, l’étape échoue. Si le type de géométrie renvoyé par une expression Arcade ne correspond pas au type de géométrie configuré dans l’étape, cette dernière échoue.
Configurer l’étape
Pour configurer l’étape, procédez comme suit :
- Créez ou mettez à jour un diagramme de processus pour accéder au volet Step Library (Bibliothèque d’étapes).
- 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.
Le volet Step Details (Détails de l’étape) s’affiche.
- Spécifiez un nom pour l’étape dans la zone de texte Step Name (Nom de l’étape).
- 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).
Si l’invite utilisateur contient du texte brut et des expressions ArcGIS Arcade, mettez en forme le texte comme suit :
'This job is currently assigned to ' + JobOwner($Job) + '.'Conseil :
Cliquez sur This input supports Arcade Expressions (Cette entrée prend en charge les expressions Arcade)
et sélectionnez une expression Arcade pour l’ajouter à la zone de texte associée. - 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.
Vous pouvez aussi utiliser des expressions ArcGIS Arcade pour fournir une valeur dynamique.
- 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) : prédéfinissez la localisation de la tâche à l’aide de coordonnées au format JSON de Esri.
- Si vous avez sélectionné Map (Carte), procédez comme suit pour ajouter une carte :
- Sélectionnez les options Selection Method (Méthode de sélection) 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 les widgets de l’application Web Workflow Manager.
- Sélectionnez une carte Web dans le menu déroulant Web Map (Carte Web).
- Si aucune référence de données de carte Web n’est associée à votre diagramme de processus, cliquez sur Add data reference (Ajouter une référence de données).
La boîte de dialogue Add data reference (Ajouter une référence de données) s’affiche.
- 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 à la recherche.
Enter item ID manually (Saisir l’ID d’élément) : sélectionnez l’environnement dans lequel se trouve la référence de données et 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). Si vous avez sélectionné Other (Autre), indiquez l’URL de l’organisation ArcGIS qui contient la couche la référence de données dans la zone de texte Portal URL (URL du portail).
L’élément est validé automatiquement par Workflow Manager et le type de référence de données est défini dans la barre Type.
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 corresponde au type de la référence de données définie.
- Browse for item (Rechercher l’élément) : parcourez une liste d’éléments sur le portail actuel et sélectionnez un élément.
- Cliquez sur OK pour enregistrer la référence de données ou sur Cancel (Annuler) pour quitter.
Vous pouvez supprimer la référence de données de carte Web en cliquant sur X.
- Sélectionnez une carte ArcGIS Pro dans le menu déroulant ArcGIS Pro.
- Si aucune référence de données de carte ArcGIS Pro n’est associée à votre diagramme de processus, cliquez sur Add ArcGIS Pro Data Reference (Ajouter une référence de données ArcGIS Pro).
La boîte de dialogue Add ArcGIS Pro data reference (Ajouter une référence de données ArcGIS Pro) s’affiche avec la zone Pro Item Type (Type d’élément Pro) définie sur Map (Carte).
- Indiquez le nom de la référence de données de carte ArcGIS Pro dans la zone de texte Pro Item type (Type d’élément Pro).
- Cliquez sur OK pour enregistrer la référence de données ou sur Cancel (Annuler) pour quitter.
Vous pouvez supprimer la référence de données de carte ArcGIS Pro en cliquant sur X.
- 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.
- Sélectionnez les options Selection Method (Méthode de sélection) le cas échéant :
- 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 de 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.
- Cliquez sur l'onglet Options.
- Définissez les paramètres Step Options (Options de l’étape) comme il convient :
- 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 le diagramme de processus est configuré pour exécuter automatiquement une séquence d’étapes qui comprend l’étape Exécuter un service de géotraitement, les étapes censées s’exécuter après l’expiration du jeton utilisateur ne démarrent pas automatiquement. L’extension d’organisation ArcGIS Workflow Manager Advanced est nécessaire à l’exécution des étapes automatisées supplémentaires sans intervention manuelle.
- Run on a Schedule (Exécution planifiée) : l’étape s’exécute selon une planification définie.
- Manual (Manuel) : l’étape est exécutée manuellement.
- Sélectionnez éventuellement l’une des options suivantes pour configurer l’aide dans l’étape :
- None (Aucune) : configurez l’étape sans son aide.
- Text (Texte) : configurez le texte de l’aide de l’étape dans la zone de texte Text (Texte).
Vous pouvez utiliser des expressions ArcGIS Arcade pour attribuer une valeur dynamique à l’aide de l’étape. Si l’aide de l’étape contient du texte brut et des expressions Arcade, mettez le texte en forme comme suit :
'For further assistance, please contact' + JobCreator($Job) + '.' - URL (URL) : configurez l’étape avec un lien vers une ressource d’aide dans la zone de texte URL (URL).
Remarque :
Les étapes qui sont exécutées dans l’application Web prennent en charge uniquement les formats d’URL HTTP et HTTPS. Les étapes qui sont exécutées dans ArcGIS Pro prennent en charge les formats d’URL HTTP et HTTPS ainsi que les formats de fichier.
Vous pouvez aussi utiliser des expressions Arcade pour fournir une valeur dynamique. Si l’URL contient du texte brut et des expressions Arcade, mettez le texte en forme comme suit :
'https://pro.arcgis.com/en/pro-app/latest/tool-reference/' + JobExtendedProperty($Job, 'tools', 'toolbox') + '/' + jobExtendedProperty($job, 'tools', 'alias') + '.htm'Configurez la case à cocher Automatically Encode Arcade Result (Encoder automatiquement le résultat Arcade) comme suit :
- Si une expression Arcade renvoie des caractères spéciaux à échapper lors de la conversion en URL, comme des espaces ou des barres obliques, assurez-vous que la case Automatically Encode Arcade Result (Encoder automatiquement le résultat Arcade) est cochée.
- Si une expression Arcade est utilisée pour constituer l’URL de base, décochez la case Automatically Encode Arcade Result (Encoder automatiquement le résultat Arcade).
- Cliquez éventuellement sur l’onglet Style pour changer la forme et la couleur de l’étape.
- 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).
Conseil :
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. Cliquez sur Copy Step ID (Copier l’ID d’étape)
pour copier l’ID de l’étape dans le presse-papiers.
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 :
| Valeur de retour | 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 |
|---|---|
<Location> | Renvoie la localisation définie. |
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?