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

L’étape Ouvrir des éléments de projet Pro vous permet d’ouvrir des projets ou des 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, le cas échéant.

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ée ArcGIS Pro configurée pour 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 un texte d’aide est configuré pour l’étape, il 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 tuile de 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ée 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 un texte d’aide est configuré pour l’étape, il 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 Portal qui contient votre élément de processus.

Vous ne pouvez utiliser le fichier PITEMX téléchargé 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 tuile de 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 dans 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) 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.

  3. Saisissez 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, formatez 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, 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 (Projets Pro), sélectionnez l’une des options suivantes pour indiquer l’emplacement du projet :
    • Current (Actuel) : paquetage de projet qui est actuellement ouvert dans ArcGIS Pro.

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

    • Portal (Portail) - Un paquetage de projet hébergé sur un portail ArcGIS Enterprise ou dans ArcGIS Online.
    • Filepath (Chemin d’accès au fichier) - Un 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 choisissez 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) - Un paquetage de projet héberge sur le même portail que Workflow Manager.
      • ArcGIS Online - Un paquetage de projet hébergé sur ArcGIS Online.
      • Other (Autre) - Un paquetage de projet situé sur un autre portail.
    2. Si vous sélectionnez Other (Autre), saisissez 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 sélectionnez 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 que vous souhaitez 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 que vous souhaitez utiliser dans la zone de texte Name (Nom).
  12. Sélectionnez le type d’élément que vous souhaitez utiliser dans la liste déroulante 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 workflow 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 modifier 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 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 sélectionnez 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 modifier les couches de réplica dans ArcGIS Pro, cochez la case Synchronize Replica Changes (Synchroniser les modifications de réplica) pour synchroniser les modifications lorsque l’étape est interrompue ou terminée.

    La case 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) qui affiche 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ées ArcGIS Pro lorsque les éléments configurés à l’étape sont ouverts.

      Cliquez sur le bouton Add Command (Ajouter une commande) et indiquez l’ID des commandes de complément personnalisées que vous voulez 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ément personnalisées peuvent être utilisés. Si plusieurs commandes sont spécifiées, elles s’exécutent dans 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 à l’emplacement de la tâche.
    1. Cliquez sur la flèche de la liste déroulante Operator (Opérateur) et choisissez 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 l’emplacement 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 l’emplacement 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 dans la distance indiquée de l’emplacement 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. Saisissez éventuellement un texte d’aide pour l’étape dans la zone de texte Step Help (Aide de l’étape).

    Vous pouvez également 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) + '.'

  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 saisissez 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.

retourner une valeur

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 indique les valeurs de retour de l’étape :

retourner une valeurDescription

S000001

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

F000001

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

Rubriques connexes