Introduction aux Workflows
Les workflows sont le cœur d'Ecosystem. Ils définissent la logique de traitement des données déclenchées par un trigger.
Qu'est-ce qu'un workflow ?
Un workflow est une séquence d'opérations (nœuds) qui :
- Reçoit les données d'un trigger
- Traite ces données selon la logique définie
- Produit un résultat (réponse HTTP, envoi d'email, etc.)
Structure d'un workflow
Nœuds (Nodes)
Chaque workflow est composé de nœuds connectés entre eux :
- Nœud Trigger : Point d'entrée (automatique, basé sur le trigger associé)
- Nœuds de traitement : Requêtes HTTP, conditions, boucles, code, etc.
- Nœud de sortie : Réponse HTTP, envoi d'email, etc.
Le détail de chaque type de nœud (champs, comportement, cas d'usage) est documenté dans les pages dédiées — voir le catalogue des nœuds ci-dessous.
Connexions (Edges)
Les nœuds sont connectés par des flèches qui définissent le flux d'exécution :
- Les données passent d'un nœud à l'autre
- Le contexte est partagé entre tous les nœuds
- Les erreurs peuvent être gérées via des nœuds spécifiques
Éditeur de workflow
L'éditeur de workflow offre :
- Interface graphique : Glisser-déposer des nœuds
- Configuration visuelle : Configuration de chaque nœud via des formulaires
- Prévisualisation : Visualisation du flux d'exécution
- Test : Test du workflow avant déploiement
Types de nœuds
Les pages suivantes servent de référence pour configurer chaque nœud dans l'éditeur :
| Catégorie | Nœuds |
|---|---|
| Entrée / sortie HTTP | Trigger Node, HTTP Request, HTTP Response |
| Traitement | Code, IA Agent |
| Contrôle de flux | Condition, Switch, ForEach, While |
| Actions | Email, FTP, Send PubSubEvent, AWS SQS |
| Utilitaires | Wait, Note (non exécutée) |
| Erreurs | On Error |
Cycle de vie d'un workflow
- Création : Le workflow est créé avec le statut DRAFT
- Édition : Configuration des nœuds et connexions
- Test : Test du workflow avec des données de test
- Versioning : Travail sur MAIN ; création de versions numérotées pour figer et livrer (notamment en production)
- Déploiement : Déploiement dans un environnement
- Exécution : Exécution automatique lors du déclenchement du trigger
Statuts d'un workflow
- DRAFT : En cours d'édition
- MAIN : ligne de développement toujours modifiable, idéale pour itérer et tester vite ; non déployable en production — voir Gestion des versions. Le déploiement d'autres versions requiert un trigger sur l'environnement cible
- DEPLOYED : Déployé dans au moins un environnement
Concepts associés
Versions
Les workflows supportent le versioning :
- Créez des versions pour suivre les changements
- Déployez des versions spécifiques
- Gardez un historique des modifications
Tags
Organisez vos workflows avec des tags pour faciliter la recherche et l'organisation.
Traces
Chaque exécution génère une trace qui permet de :
- Visualiser le flux d'exécution
- Voir les données à chaque étape
- Déboguer les problèmes
Prochaines étapes
- Créer un workflow
- Utiliser l'éditeur
- Consulter un type de nœud dans le catalogue des nœuds, en commençant par Trigger Node