Ajouter et configurer une étape Open Pro Project Items (Ouvrir des éléments de projet Pro)

L’étape Open Pro Project Items (Ouvrir des éléments de projet Pro) vous permet d’ouvrir des projets ou paquetages de projets existants dans ArcGIS Pro. Vous pouvez configurer les éléments à ajouter au projet (par exemple, des cartes, des mises en page, des scènes, des éléments de tâche et des cartes Web) pour être sûr de travailler sur les éléments corrects. Si votre projet contient des éléments de cartographie, les couches de données peuvent automatiquement pointer sur la version des données spécifique de la tâche appropriée.

Remarque :

Si un paquetage de projet est utilisé pour mettre à jour et synchroniser des couches de réplicas hors connexion, le paquetage de projet ne peut pas être partagé si l’option Share outside organization (Partager en dehors de l’organisation) est activée.

Lorsque vous exécutez l’étape dans ArcGIS Pro, les éléments définis dans l’étape s’ouvrent dans le projet ArcGIS Pro spécifié. Si l’étape est configurée avec l’option Run ArcGIS Pro Command (Exécuter une commande ArcGIS Pro), la commande de complément personnalisé ArcGIS Pro configurée dans l’étape s’exécute à l’ouverture du projet. Si l’étape est configurée avec l’option View Error Inspector (Afficher l’inspecteur d’erreurs), la fenêtre Error Inspector (Inspecteur d’erreurs) apparaît à l’ouverture du projet et une couche comportant les entités d’erreurs est ajoutée à la carte dans ArcGIS Pro. Si l’étape est configurée avec l’aide des étapes, elle apparaît en bas de la vignette de la tâche.

Lorsque vous exécutez l’étape dans l’application Web ArcGIS Workflow Manager, un bouton de téléchargement apparaît dans la vignette de la tâche. Téléchargez le fichier PITEMX et double-cliquez dessus pour ouvrir le projet dans ArcGIS Pro. Si l’étape est configurée avec l’option Run ArcGIS Pro Command (Exécuter une commande ArcGIS Pro), ArcGIS Pro exécute la commande de complément personnalisé configurée. Si l’étape est configurée avec l’option View Error Inspector (Afficher l’inspecteur d’erreurs), la fenêtre Error Inspector (Inspecteur d’erreurs) apparaît et une couche comportant les entités d’erreurs est ajoutée à la carte. Si l’étape est configurée avec l’aide des étapes, elle apparaît en bas de la vignette de la tâche.

Attention :

Avant d’ouvrir le fichier PITEMX téléchargé dans ArcGIS Pro, ajoutez une connexion au portail au portail qui contient votre élément de processus.

Vous ne pouvez utiliser le fichier PITEMX qu’une seule fois pour ouvrir le projet dans ArcGIS Pro. Si vous devez rouvrir le projet, vous devez télécharger un nouveau fichier PITEMX à partir de la vignette de la tâche dans l’application Web Workflow Manager.

Lorsque l’étape est exécutée, les actions suivantes peuvent être effectuées :

  • Pour mettre l’étape en pause, cliquez sur Pause (Interrompre).
  • Pour terminer l’étape, cliquez sur Finish (Terminer).
Remarque :

Si l’étape n’est pas facultative, elle doit être exécutée ou mise en pause au moins une fois pouvoir être finalisée.

Configurer l’étape

Vous pouvez ajouter des paquetages de projets hébergés sur un portail ArcGIS Enterprise, dans ArcGIS Online ou sur un système de fichiers. Vous pouvez configurer les éléments à ajouter au projet (par exemple, des cartes, des mises en page, des scènes, des cartes Web et des éléments de tâche). L’ordre d’ouverture des éléments dans ArcGIS Pro est défini par l’ordre dans lequel vous les ajoutez à l’étape.

Procédez comme suit pour configurer l’étape :

  1. Créez ou mettez à jour un diagramme de processus pour accéder au volet Step Library (Bibliothèque d’étapes).
  2. Faites glisser Open Pro Project Items (Ouvrir des éléments de projet Pro) du volet Step Library (Bibliothèque d’étapes) vers une flèche de connexion d’une étape de la zone d’affichage du 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).

    Si l’invite utilisateur contient du texte brut et des expressions 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) This input supports Arcade expressions et sélectionnez une expression ArcGIS Arcade pour l’ajouter à la zone de texte associée.

  5. Dans la section Arguments (Arguments), cliquez sur Edit (Mettre à jour).

    La boîte de dialogue ArcGIS Pro Mapping Step (Étape de cartographie ArcGIS Pro) apparaît.

  6. Dans la section Pro Project (Projet Pro), sélectionnez l’une des options suivantes pour indiquer l’emplacement du projet :
    • Current (Actuel) : paquetage de projet actuellement ouvert dans ArcGIS Pro.

      En savoir plus sur l’ouverture d’un projet dans ArcGIS Pro

    • Portal (Portail) : paquetage de projet hébergé sur un portail ArcGIS Enterprise ou dans ArcGIS Online.
    • Filepath (Chemin d’accès au fichier) : paquetage de projet hébergé sur un partage de fichier réseau ou un système de fichiers local.

      Vous pouvez aussi utiliser des expressions ArcGIS Arcade pour fournir une valeur dynamique.

  7. Si vous avez sélectionné Portal (Portail), cliquez sur Add Pro Project (Ajouter le projet Pro) et procédez comme suit :
    1. Sélectionnez l’une des options suivantes pour indiquer l’emplacement du paquetage de projet :
      • This Enterprise (Ce portail Enterprise) : paquetage de projet hébergé sur le même portail que Workflow Manager.
      • ArcGIS Online : paquetage de projet hébergé sur ArcGIS Online.
      • Other (Autre) : paquetage de projet situé sur un autre portail.
    2. Si vous avez sélectionné Other (Autre), spécifiez l’URL du portail qui contient le paquetage de projet 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.

    3. Si vous le souhaitez, spécifiez un nom différent pour le paquetage de projet dans la zone de texte Item ID (ID d’élément).
    4. Si vous le souhaitez, spécifiez un nom de référence différent pour le paquetage de projet dans la zone de texte Reference Name (Nom de référence).

      Il s’agit du nom affiché dans la configuration de l’étape.

    5. Cliquez sur OK.

      Le paquetage de projet apparaît dans la boîte de dialogue ArcGIS Pro Mapping Step (Étape de cartographie ArcGIS Pro).

      Remarque :

      Vous pouvez mettre à jour le paquetage de projet en cliquant sur Edit (Mettre à jour) ou le supprimer en cliquant sur Delete (Supprimer).

  8. Si vous avez sélectionné Filepath (Chemin d’accès au fichier), spécifiez le chemin d’accès local ou réseau au paquetage de projet dans la zone de texte Filepath (Chemin d’accès au fichier).
  9. Dans la section Open Items (Ouvrir des éléments), cliquez sur Open New Item (Ouvrir un nouvel élément) pour ajouter les éléments à ouvrir dans le projet.
    Remarque :

    Les éléments doivent être présents dans le projet ArcGIS Pro lorsque l’étape est exécutée ; dans le cas contraire, l’étape échoue.

  10. 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 zone de texte Name (Nom) :
    • String (Chaîne) : indiquez une valeur de chaîne pour le nom de l’élément.
    • Arcade : indiquez une valeur dynamique en guise de nom d’élément à l’aide d’une expression Arcade.
  11. Indiquez le nom de l’élément à utiliser dans la zone de texte Name (Nom).
  12. Sélectionnez le type d’élément à utiliser dans le menu déroulant Type (Type) :
    • Map (Carte) : une carte
    • Layout (Mise en page) : une mise en page
    • Scene (Scène) : une scène locale ou globale
    • Task (Tâche) : un élément de tâche
  13. Si l’étape Create Version (Créer une version) est utilisée dans votre diagramme de processus pour la création d’une version des données spécifique à la tâche, cochez la case Repoint Version (Repointer la version) pour repointer les couches de données d’éléments de cartographie vers la version spécifique à la tâche lorsque l’étape est exécutée.
    Remarque :

    La case à cocher Repoint Version (Repointer la version) n’est pas disponible pour les éléments de tâche.

  14. Si vous le souhaitez, si l’étape Create Replica (Créer un réplica) est utilisée dans votre diagramme de processus pour mettre à jour les couches de réplica, cochez la case Synchronize Replica Changes (Synchroniser les modifications de réplica) pour synchroniser les modifications lorsque le projet est ouvert dans ArcGIS Pro.

    La case à cocher Synchronize Replica Changes (Synchroniser les modifications de réplica) est uniquement disponible avec les options de projet Pro Portal (Portail) et Filepath (Chemin d’accès au fichier).

  15. Au besoin, répétez ces étapes pour ajouter plus d’éléments.
    Conseil :

    Pour supprimer un élément, survolez-le et cliquez sur Delete Item (Supprimer l’élément) Delete Item.

  16. Au besoin, cliquez sur l’onglet Finish (Terminer) et cochez la case Reset to Default (Rétablir les valeurs par défaut) pour pointer les couches de données d’éléments de cartographie à nouveau vers la version d’origine une fois l’étape terminée.
    Remarque :

    La case à cocher Reset to Default (Rétablir les valeurs par défaut) n’est pas disponible pour les éléments de tâche.

  17. Le cas échéant, si vous avez sélectionné Portal (Portail) ou Filepath (Chemin d’accès au fichier) en tant que paramètre Pro Project (Projet Pro), cochez la case Close ArcGIS Pro Project (Fermer le projet ArcGIS Pro) pour fermer le projet lorsque l’étape est suspendue ou terminée.

    Lorsque l’étape est suspendue ou terminée, le projet est fermé et ArcGIS Pro demeure ouvert afin que l’utilisateur puisse reprendre la tâche ou effectuer des étapes supplémentaires.

  18. Si vous le souhaitez, si vous utilisez l’étape pour mettre à jour les couches de réplica dans ArcGIS Pro, cochez la case Synchronize Replica Changes (Synchroniser les modifications de réplica) pour synchroniser les mises à jour lorsque l’étape est interrompue ou terminée.

    La case à cocher Synchronize Replica Changes (Synchroniser les modifications de réplica) est uniquement disponible avec les options de projet Pro Portal (Portail) et Filepath (Chemin d’accès au fichier).

  19. Vous pouvez cliquer sur l’onglet Advanced (Avancé) et configurer les options si nécessaire.
    • Zoom to Location (Zoom sur la localisation) : effectue un zoom de la carte sur la localisation de la tâche si une localisation est définie pour la tâche.
    • View Error Inspector (Afficher l’inspecteur d’erreurs) : ouvre la fenêtre Error Inspector (Inspecteur d’erreurs) pour examiner les entités d’erreurs sur la carte.

      Dans le cas des sources de données de service d’entités, les couches d’erreurs doivent être stockées dans le service et la source de données doit être une version de branche avec la fonctionnalité de validation.

    • Run ArcGIS Pro Command (Exécuter une commande ArcGIS Pro) : exécute les commandes de complément personnalisé ArcGIS Pro lorsque les éléments configurés à l’étape sont ouverts.

      Cliquez sur Add Command (Ajouter une commande) et indiquez l’ID des commandes de complément personnalisé à exécuter. Si vous le souhaitez, vous pouvez réorganiser les commandes ou en supprimer.

      En savoir plus sur l’affichage des ID de commande dans les info-bulles dans ArcGIS Pro

      Remarque :

      Seuls les ID des commandes de compléments personnalisés peuvent être utilisés. Si plusieurs commandes sont spécifiées, elles s’exécutent suivant l’ordre dans lequel elles sont configurées dans l’étape.

  20. Vous pouvez activer l’option Restrict Edits to Job Location (Restreindre les mises à jour à la localisation de la tâche) pour limiter les mises à jour à la localisation de la tâche.
    1. Cliquez sur la flèche de la liste déroulante Operator (Opérateur) et sélectionnez l’une des options suivantes :
      • Intersect with Job Location (Intersection avec la localisation de la tâche) : permet de mettre à jour des entités qui intersectent la localisation de la tâche.
      • Completely within Job Location (Complètement dans la localisation de la tâche) : permet de mettre à jour des entités situées entièrement dans la localisation de la tâche.
    2. Si vous le souhaitez, spécifiez une valeur dans la zone de texte Buffer (Zone tampon) pour permettre la mise à jour d’entités situées à la distance indiquée de la localisation de la tâche.

      Vous pouvez aussi utiliser des expressions ArcGIS Arcade pour fournir une valeur dynamique.

      Si la zone tampon contient une expression Arcade, elle doit être évaluée comme étant un nombre entier.

  21. Cliquez sur Save (Enregistrer).
    Remarque :

    L’option Save (Enregistrer) n’est pas disponible lorsque les paramètres sont configurés avec des valeurs non valides.

  22. Cliquez sur l'onglet Options.
  23. 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 davantage d’étapes automatisées 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

  24. Cochez éventuellement la case Enabled (Activé) dans la section Step Commenting (Commentaires de l’étape) pour permettre à un utilisateur d’ajouter un commentaire à l’étape au moment de son exécution.
  25. Si vous avez activé les commentaires pour l’étape, cochez éventuellement la case Required (Obligatoire) dans la section Step Commenting (Commentaires de l’étape) pour faire de l’ajout d’un commentaire à l’étape une condition préalable à l’exécution de celle-ci.
  26. 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, vous devez formater le texte 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 exécutées dans l’application Web prennent uniquement en charge les URL aux formats HTTP et HTTPS. Les étapes exécutées dans ArcGIS Pro prennent uniquement en charge les formats HTTP, HTTPS et fichier.

      Vous pouvez aussi utiliser des expressions Arcade pour fournir une valeur dynamique. Si l’URL contient du texte brut et des expressions Arcade, vous devez mettre en forme le texte 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) :

      • 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).

  27. Cliquez éventuellement sur l’onglet Style pour changer la forme et la couleur de l’étape.
  28. 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) Copy Step ID 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 retourDescription

S000001

L’étape s’est terminée correctement.

F000001

L’étape ne s’est pas terminée correctement.

Rubriques connexes