La fonctionnalité « For Each » vous permet d’itérer sur un ensemble de propriétés d’entrée, en exécutant une séquence d’actions pour chaque élément. Cette fonctionnalité simplifie les tâches répétitives et améliore l’automatisation des flux de travail.
Cet article vous guidera dans la configuration et l’utilisation de l’action de Workflow For Each, la consultation de ses détails de sortie, la compréhension de ses limites et l’appréciation de ses avantages.
Configurer une action de Workflow For Each
Étape 1 : Ajouter une action For Each
Lors de la création ou de la modification d’un Workflow, cliquez sur le bouton « Add », puis sélectionnez « Add for each » dans le menu déroulant.
Étape 2 : Ajouter des propriétés
Vous serez dirigé vers un panneau où vous pourrez commencer à ajouter les propriétés (entrées) sur lesquelles l’action For Each sera exécutée. Veuillez noter que le nombre maximal de propriétés acceptées est de 100. Les Workflows comportant plus de 100 propriétés seront enregistrés, mais vous ne pourrez pas les exécuter.
Gardez à l’esprit que la limite de 100 entrées dans une boucle « For Each » ne correspond pas à 100 actions dans un Nested Workflow. Le nombre maximal d’actions configurables dans un Workflow reste de 50. Toutefois, le nombre total d’exécutions dépend du ratio entre les entrées et les actions.
Étape 3 : Méthodes d’entrée
Vous pouvez ajouter des propriétés de quatre manières différentes :
- Saisir une entrée dans chaque champ.
- Saisir une liste dans un seul champ, en séparant chaque entrée par une virgule :
a,b,c - Cliquer sur l’icône en forme d’éclair et sélectionner l’entrée dans une liste d’entrées d’exécution que vous avez créées précédemment.
Vous pouvez effacer la liste en sélectionnant l’option « Clear For each list » en bas de l’assistant.
Remarque : Quelle que soit la façon dont vous ajoutez les entrées, chaque valeur (a, b, c, …) reste une entité distincte sur laquelle l’action For Each sera exécutée.
Étape 4 : Sélectionner un Nested Workflow
Une fois toutes les propriétés requises ajoutées, appuyez sur « Save ».
Vous serez alors redirigé vers un assistant Workflow dans lequel il vous sera demandé de sélectionner un Nested Workflow existant à appliquer.
Tous les Workflows For Each doivent être des Nested Workflows, et ce paramètre présélectionné ne peut pas être modifié.
Étape 4.1 : Planifier le démarrage du Workflow (facultatif)
Vous avez également la possibilité de planifier le démarrage du Workflow dans cette section en activant cette fonction et en spécifiant le nombre de jours de délai.
Étape 5 : Sélectionner l’entrée d’exécution
Veuillez noter que le champ d’entrée d’exécution dans ce panneau ne sera affiché que si l’entrée d’exécution du Workflow sélectionné est marquée comme obligatoire. Sélectionnez simplement l’entrée précédemment spécifiée dans la liste déroulante du champ pour continuer.
Le Nested Workflow doit utiliser le Workflow For Each comme entrée d’exécution afin d’éviter les erreurs.
Étape 6 : Finaliser et exécuter
Enregistrez vos paramètres. Vous avez maintenant créé votre scénario For Each. Dans l’aperçu vers lequel vous serez dirigé, vous verrez un récapitulatif des propriétés pour lesquelles le Workflow imbriqué sera exécuté.
- Cliquer sur l’élément du Nested Workflow rouvrira l’assistant Workflow.
- Cliquer sur les entrées vous redirigera vers la section de configuration des entrées.
Effectuez les modifications nécessaires, enregistrez, publiez et exécutez votre Workflow.
Consulter les détails de sortie
Accéder aux détails d’exécution
Une fois que le workflow imbriqué For Each a terminé son exécution avec succès, vous pouvez consulter les détails d’exécution pour collecter les sorties. Accédez au panneau d’exécution et cliquez sur « See details » dans la section « Execute Nested Workflow ».
Afficher l’exécution pour chaque propriété
Cela vous mènera à un panneau « For Each » où vous pourrez voir l’exécution de chacune des propriétés sélectionnées (objets).
- Cliquez sur l’icône Workflow pour ouvrir un nouveau panneau d’exécution au centre de l’écran, affichant l’action Nested Workflow exécutée.
- Survolez l’icône Information pour voir les entrées et les sorties de l’option sélectionnée.
- Répétez le processus pour chaque objet.
Remarque : Les informations de sortie ne sont disponibles que dans cette section, et vous ne pourrez pas les voir en survolant l’icône d’information à côté de « Vue d’ensemble » dans ce même panneau.
Limites
- Limite d’actions : les Workflows peuvent contenir un maximum de 50 actions. Ce nombre inclut les actions For Each multipliées par le nombre de propriétés.
- Entrées d’exécution : le nombre maximal d’entrées d’exécution dans une boucle For Each est de 100.
- Exécutions parallèles : le nombre maximal d’exécutions parallèles est de 50.
- Exécutions séquentielles : dans une condition For Each, les exécutions se produisent une par une. Cela signifie que vous pouvez avoir jusqu’à 100 objets dans la liste d’une action For Each.
- If/Else : les conditions If/Else ne sont pas prises en charge dans les actions For Each. Les actions For Each ne sont pas prises en charge dans les conditions If/Else.
Ces limites contribuent à optimiser les performances et la réussite de vos Workflows.
Avantages
L’introduction de la condition « For Each » améliore considérablement l’adaptabilité et l’efficacité opérationnelle du flux de travail. Par exemple, lors de l’intégration des utilisateurs, si vous devez ajouter l’utilisateur à plusieurs groupes, l’utilisation d’une action « For Each » dans votre flux de travail peut automatiser le processus d’attribution. Cela élimine le besoin de suivi manuel et d’attribution à chaque groupe.