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

ArcGIS Online    |    |  

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

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, cette dernière apparaît en bas de la vignette de la tâche.

Si vous exécutez l’étape dans l’application Web ArcGIS Workflow Manager, le bouton Download ArcGIS Pro Project (Télécharger le projet ArcGIS Pro) 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 qui contient l’é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.

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 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 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) This input supports Arcade expressions et sélectionnez une expression 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), sélectionnez une référence de données de projet ArcGIS Pro dans le menu déroulant Pro project (Projet Pro).
  8. Si aucun projet ArcGIS Pro n’est associé au diagramme de processus, ajoutez une référence de données de projet ArcGIS Pro :
    1. Cliquez sur Add data reference (Ajouter une référence de données) dans le menu déroulant.

      La boîte de dialogue Add data reference (Ajouter une référence de données) s’affiche.

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

    3. Cliquez sur OK pour enregistrer la référence de données ou sur Cancel (Annuler) pour quitter.
  9. 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).
  10. 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 se trouver dans le projet ArcGIS Pro lorsque l’étape est exécutée ; dans le cas contraire, l’étape échoue.

  11. 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) :
    • Selection (Sélection) : sélectionnez une référence dans une liste de références de données ArcGIS Pro associées au diagramme de processus. Si aucune référence de données ArcGIS Pro n’est associée au diagramme de processus, cliquez sur Add ArcGIS Pro data reference (Ajouter une référence de données ArcGIS Pro).

      Sélectionnez le type d’élément dans le menu déroulant Pro Item Type (Type d’élément Pro) et spécifiez le nom de l’élément dans la zone de texte Pro Item Name (Nom de l’élément Pro).

      En savoir plus sur la gestion des références de données

    • Arcade : sélectionnez le type d’élément dans le menu déroulant Type et spécifiez une valeur dynamique pour le nom d’élément, à l’aide d’une expression Arcade.
  12. 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.

  13. 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 vous puissiez reprendre la tâche ou effectuer des étapes supplémentaires.

  14. 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. Sélectionnez une commande ArcGIS Pro dans le menu déroulant.

      Si aucune référence de données de commande ArcGIS Pro n’est associée au diagramme de processus, cliquez sur Add ArcGIS Pro data reference (Ajouter une référence de données ArcGIS Pro) et spécifiez le nom et l’ID de la commande dans les zones de texte Command Name (Nom de la commande) et Command ID (ID de commande).

      Cliquez éventuellement sur Add Command (Ajouter une commande) pour ajouter d’autres commandes 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.

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

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

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

  17. Cliquez sur l'onglet Options.
  18. 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.

      En savoir plus sur les options de planification

  19. 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.
  20. 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.
  21. 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).

  22. Cliquez éventuellement sur l’onglet Style pour changer la forme et la couleur de l’étape.
  23. 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