Ajouter et configurer l’attribution avancée

L’étape Attribution avancée vous permet d’ajouter une étape ultérieure à un utilisateur en fonction de la valeur en sortie de cette étape. Vous pouvez également utiliser l’étape afin d’utiliser l’emplacement de la tâche pour attribuer automatiquement un utilisateur ou un groupe à une étape ultérieure en interrogeant une couche de référence qui contient un champ accompagné d’une liste d’utilisateurs ou de groupes. Une fois l’étape effectuée, l’étape ultérieure peut être automatiquement attribuée à l’utilisateur ou au groupe choisi.

À l’exécution de l’étape, vous êtes invité à choisir à qui attribuer une étape ultérieure. Si l’étape est configurée avec une couche de référence, l’utilisateur ou le groupe auquel une tâche ultérieure est attribuée est automatiquement déterminé.

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

  • Pour terminer l’étape, cliquez sur Proceed (Continuer).
  • Pour annuler l’étape, cliquez sur Cancel (Annuler).
Remarque :

Si l’étape n’est pas facultative, elle doit être exécutée pour se terminer.

Configurer 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 Advanced Assignment (Attribution avancée) du 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. 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. Si vous ne souhaitez pas que tous les chemins conduisant hors de cette étape soient attribués à l’utilisateur ou au groupe choisi, décochez la case Automatically Switch Assignment (Modifier l’attribution automatiquement) et utilisez la valeur en sortie de cette étape pour modifier l’attribution à l’aide d’un chemin.

    Cela peut être nécessaire pour les processus comportant des étapes parallèles lorsque vous ne souhaitez qu’attribuer une des étapes à l’utilisateur ou au groupe choisi.

    Remarque :

    Lorsque la case Automatically Switch Assignment (Modifier l’attribution automatiquement) est cochée, l’attribution d’utilisateur ou de groupe choisie remplace tous les paramètres d’attribution de chemin conduisant hors de cette étape.

  6. Pour configurer l’attribution d’étape pour un groupe, cochez la case Force Group Assignment (Forcer l’attribution au groupe) afin de garantir que l’étape est toujours affectée au groupe, même si l’utilisateur qui l’exécute est membre du groupe.
  7. Sélectionnez l’une des options Assignment Method (Méthode d’attribution) suivantes :
    • User Defined (Défini par l’utilisateur) - Choisissez manuellement l’utilisateur auquel une étape ultérieure est attribuée.
    • Spatially (Spatialement) - Interrogez une couche de référence qui contient un champ accompagné d’une liste d’utilisateurs ou de groupes à l’aide de l’emplacement de la tâche afin de déterminer l’utilisateur ou le groupe auquel une étape ultérieure est attribuée.
  8. Si vous choisissez User Defined (Défini par l’utilisateur), procédez de l’une des manières suivantes :
    • All Users (Tous les utilisateurs) : choisissez cette option afin que n’importe quel utilisateur puisse être attribué à une étape ultérieure.
    • Group (Groupe) - Choisissez cette option, cliquez sur la flèche de la liste déroulante Group (Groupe), puis choisissez un groupe pour permettre uniquement que les utilisateurs figurant dans ce groupe soient attribués à une tâche ultérieure.
  9. Si vous choisissez Spatially (Spatialement), cliquez sur Add (Ajouter) pour ajouter une couche de référence.

    La boîte de dialogue Advanced Assignment Step (Étape d’attribution avancée) apparaît.

    1. Sélectionnez l’une des options suivantes pour indiquer où se trouve la couche de référence :
      • This Enterprise (Ce portail Enterprise) - Une couche d’entités hébergée sur le même portail que Workflow Manager.
      • ArcGIS Online - Une couche d’entités hébergée sur ArcGIS Online.
      • Other (Autre) - Une couche d’entités située sur un autre portail.
      Remarque :

      La couche d’entités doit être une couche de polygones.

    2. Si vous sélectionnez Other (Autre), saisissez l’URL du portail qui contient la couche d’entités 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. Spécifiez l’ID d’élément de la couche d’entités dans la zone de texte Item ID (ID d’élément).
    4. Cliquez sur la flèche de la liste déroulante Layer Name (Nom de la couche) et choisissez la couche à utiliser en tant que couche de référence.
    5. Cliquez sur la flèche de la liste déroulante Assignment Field (Champ d’attribution) et choisissez le champ à utiliser pour déterminer l’attribution d’utilisateur ou de groupe.
      Remarque :

      Le champ que vous choisissez ne peut contenir que des utilisateurs ou des groupes.

    6. Spécifiez un nom pour la couche de référence dans la zone de texte Reference Name (Nom de référence).

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

    7. Cliquez sur OK.

      La couche de référence apparaît dans le volet Step Details (Détails de l’étape).

      Remarque :

      Vous pouvez mettre à jour la couche de référence en cliquant sur Edit Reference Layer (Mettre à jour la couche de référence) Edit Reference Layer, ou la supprimer en cliquant sur Delete Reference Layer (Supprimer la couche de référence) Delete Reference Layer.

    8. Dans le volet Step Details (Détails de l’étape), sous Reference Layer (Couche de référence), choisissez l’une des options suivantes :
      • User (Utilisateur) - Choisissez cette option si le champ Assignment Field (Champ d’attribution) que vous avez choisi contient des utilisateurs.
      • Group (Groupe) - Choisissez cette option si le champ Assignment Field (Champ d’attribution) que vous avez choisi contient des utilisateurs.
  10. Cliquez sur l'onglet Options.
  11. 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

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

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

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

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 :

SortieDescription

assignment

Renvoie le nom d’utilisateur ou l’ID de groupe de l’utilisateur ou du groupe auquel une étape ultérieure est attribuée.

assignmentMethod

Renvoie la valeur UserDefined ou Spatial selon la méthode ayant été utilisée pour attribuer l’utilisateur ou le groupe.

Rubriques connexes