Exécuter un Workflow
- Type de tâche :
runworkflow
La tâche Exécuter un Workflow est un composant fondamental pour la création de processus complexes et modulaires. Sa fonction est de lancer l'exécution d'un Workflow "enfant" à partir d'un Workflow "parent", permettant ainsi de passer des données et des paramètres du parent à l'enfant.
Cette approche permet de :
- Réutiliser des logiques complexes : Un Workflow qui exécute une opération courante (par exemple, récupérer des données utilisateur) peut être créé une fois et appelé depuis de nombreux autres Workflows.
- Simplifier les diagrammes : Divise un processus monolithique et complexe en sous-processus plus petits, plus simples et plus faciles à maintenir.
- Gérer des flux de travail en parallèle ou en séquence : Démarrer une automatisation secondaire à la fin d'une primaire.
Configuration
La configuration de la Tâche est divisée en deux domaines principaux.
1. Workflow à Exécuter
- Filtrer Workflow : Permet de filtrer la liste des Workflows à démarrer.
- Workflow à Exécuter : Permet de sélectionner le Workflow "enfant" à démarrer. La liste affiche tous les workflows disponibles en fonction des permissions de l'utilisateur.
2. Configuration des Paramètres
Cette section gère l'échange de données entre le Workflow parent et le Workflow enfant. Les paramètres disponibles dans cette zone dérivent exclusivement des paramètres déclarés dans le Workflow enfant : seuls les paramètres préalablement définis dans le Workflow enfant peuvent être valorisés dans cette zone.
Pour chaque paramètre, il est possible de spécifier :
- Paramètre : Indique le nom du paramètre tel qu'il est défini dans le Workflow enfant. Le nom n'est pas modifiable et sert à garantir l'association correcte de la valeur passée.
- Type : Affiche le type de données du paramètre (par exemple, String, Number, Boolean, etc.), cohérent avec la définition dans le Workflow enfant.
- Valeur : Définit la valeur qui sera passée au paramètre au moment du démarrage du Workflow enfant. La valeur peut être valorisée manuellement (par exemple,
123,"Erreur") ou via paramètres et variables du workflow.
Paramètres de Sortie
Les Paramètres de Sortie de la Tâche sont :
- targetWorkflow : Retourne le nom du Workflow "Enfant" qui a été exécuté.
- result : Retourne un message textuel décrivant le résultat de l'opération de démarrage du Workflow enfant.
- resultJson : Représente le résultat de l'exécution de la tâche au format JSON, incluant des informations générales, des configurations et des détails sur l'exécution.
- resultJsonTarget : Représente le résultat de l'exécution du Workflow enfant au format JSON, incluant des informations générales, des configurations et des détails sur l'exécution. Cet paramètre permet de réutiliser les données traitées par le Workflow enfant à l'intérieur du Workflow parent. Le contenu JSON peut être interrogé via la Tâche Requête JSONPath ou utilisé par la Tâche JSON vers Tableau pour écrire les données dans une table d'une base de données.
Notes Importantes
Seuls les workflows qui ne sont pas bloqués en modification au moment de l'exécution peuvent être exécutés. Si un utilisateur modifie le workflow enfant alors que le parent tente de le démarrer, l'opération peut échouer.
Exemple resultJson
{
"run_info": {
"status": "Completed",
"run_result": "Success"
},
"output_parameters": {
"exitStatus": "0"
}
}