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, 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 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 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) : définissez automatiquement la localisation de la tâche à l’aide de coordonnées au format JSON Esri.
- Si vous avez sélectionné Map (Carte), effectuez ces étapes :
- 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 les widgets de l’application Web Workflow Manager.
- 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.
- Sélectionnez l’une des options suivantes pour indiquer où se trouve la carte Web :
- ArcGIS Online : ajoutez une carte Web située sur ArcGIS Online.
- Other (Autre) : ajoutez une carte Web publique située sur un portail ArcGIS Enterprise.
- Si vous avez sélectionné Other (Autre), spécifiez l’URL du portail qui contient la carte Web dans la zone de texte Portal URL (URL du portail) et appuyez sur Entrée.
Pour ArcGIS Enterprise, utilisez le format https://webadaptorhost.domain.com/webadaptorname.
- Spécifiez l’ID d’élément de la carte Web dans la zone de texte Item ID (ID de l’élément).
- Saisissez un nom pour la carte Web dans la zone de texte Reference Name (Nom de référence).
- 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).
- Indiquez le nom de la carte que vous souhaitez utiliser dans votre projet ArcGIS Pro dans la zone de texte ArcGIS Pro.
- 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 Location Method (Méthode de localisation) 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 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 ?