Utiliser l'éditeur de flux
L'éditeur de flux est l'interface graphique dans laquelle vous construisez votre flux : vous y ajoutez des nœuds, vous les configurez, vous les connectez, puis vous testez le résultat (la sauvegarde est automatique).
Interface de l'éditeur
L'éditeur se compose de plusieurs zones :
- Canvas : zone centrale où vous placez et connectez les nœuds
- Panels latéraux : panel d'ajout des nœuds (catalogue) et panel de configuration du nœud sélectionné
- Barre d'outils : zoom, centrage, exécution du test
Navigation dans le canvas
- Déplacer la vue : cliquez et glissez sur le canvas
- Zoomer : molette de la souris ou boutons de zoom
- Sélectionner : cliquez sur un nœud
- Sélection multiple : maintenez Shift et cliquez sur plusieurs nœuds
Ajouter des nœuds
- Cliquez sur le bouton (Ajouter un nœud) dans le panel latéral.
- Sélectionnez le type de nœud dans le catalogue.
- Le nœud apparaît sur le canvas.
Le catalogue des nœuds et leurs champs de configuration sont décrits dans Types de Nœuds.
Nœuds personnalisés
Les nœuds personnalisés sont des Ressources propres à votre organisation, exposées dans le catalogue de l'éditeur (onglet « Personnalisés » du sélecteur de nœuds).
Configurer un nœud
- Cliquez sur un nœud pour le sélectionner.
- Le panel de configuration s'ouvre à droite.
- Remplissez les champs du formulaire.
Champs communs
Tous les nœuds partagent des champs communs :
| Champ | Description |
|---|---|
| Name | Identifie le nœud dans l'éditeur et dans les logs de traces — utile dès que le flux dépasse 5-6 nœuds. |
| App | Application associée au nœud (sur les nœuds qui l'exposent). |
| Stopper l'exécution du flux en cas d'échec | Arrête le flux si ce nœud échoue (défaut true) — pour continuer malgré l'échec, décochez et gérez l'erreur avec un nœud On Error. |
| Métadonnées métier | Annotation libre attachée au nœud (référence, contexte d'intégration, comme un e-mail, un identifiant, une valeur d'itération) — sans effet sur l'exécution, visible dans les traces selon le mode de traçage : sur les nœuds tracés en mode Standard et Complet, et sur les nœuds en erreur en mode Performance. |
Champs spécifiques
Chaque type de nœud a ses propres champs. Consultez la page du nœud correspondant dans Types de Nœuds.
Connecter les nœuds
Pour relier deux nœuds, survolez le nœud source, glissez depuis son point de connexion de sortie (handle) jusqu'au point d'entrée du nœud de destination, puis relâchez.
Pour supprimer une connexion, sélectionnez-la puis appuyez sur Suppr / Delete, ou utilisez le menu contextuel.
Le nœud On Error est un point de départ, comme le nœud Déclencheur : il n'a pas de point d'entrée et on ne peut pas s'y connecter directement. Il se déclenche automatiquement quand une erreur survient dans le workflow — voir Nœud On Error.
Déplacer et organiser
Cliquez sur un nœud puis glissez-le à l'emplacement souhaité. Pour déplacer plusieurs nœuds, sélectionnez-les (Shift + clic) puis glissez l'ensemble. Un alignement sur grille est appliqué automatiquement.
Rechercher dans le flux
Ctrl/Cmd + F ouvre la recherche dans le canvas : saisissez le nom d'un nœud ou une valeur qu’il contient (donnée, variable, élément de configuration).
- Les nœuds correspondants sont mis en évidence et la vue se positionne sur la première occurrence.
- Entrée passe à l'occurrence suivante.
- Échap ferme la recherche.
Utile pour retrouver rapidement un nœud dans un flux complexe.
Supprimer des éléments
Supprimer un nœud supprime toutes ses connexions et la configuration associée.
- Sélectionnez le nœud (ou plusieurs avec Shift + clic).
- Appuyez sur Suppr / Delete, ou utilisez le menu contextuel.
Utiliser les variables
Cliquez sur Afficher les variables pour afficher les variables disponibles dans le flux et les utiliser dans les nœuds.
Dans chaque nœud, vous pouvez utiliser des variables du contexte :
- Données d'entrée :
{{data}},incomingRequest.*selon le déclencheur — voir Nœud Déclencheur - Résultats des nœuds précédents :
{{nodeName.result}} - Variables globales :
{{variableName}}
La syntaxe Handlebars ({{variable}}, {{object.property}}, {{#if}}, {{#each}}) est détaillée dans Variables.
Depuis le panneau de test ou la consultation du contexte, cliquez sur une valeur pour copier son chemin (ex. data.orderId) et le réutiliser dans un nœud — voir Gestion des variables.
Tester dans l'éditeur
Deux niveaux de test sont possibles :
- Test par nœud : sélectionnez un nœud et cliquez sur Tester le nœud pour vérifier sa configuration seule — voir Tester un flux.
- Test complet : cliquez sur Exécuter dans la barre d'outils pour exécuter l'ensemble du flux avec des données de test. Commencez par tester sur un environnement de développement.
Les erreurs sont affichées directement sur les nœuds concernés et les données de chaque étape sont visibles dans le panel de test.
Sauvegarder
Les modifications sont sauvegardées automatiquement en mode brouillon : il n'y a pas de bouton de sauvegarde à chaque édition, et quitter l'éditeur ne perd pas vos modifications.
Créer une version
- Cliquez sur Fork dans l'éditeur.
- Renseignez le numéro SemVer et le journal des modifications (changelog).
- Validez avec Sauvegarder.
La gestion des versions (Principale vs versions numérotées, immuabilité en production) est détaillée dans Gestion des versions.
Assistant IA
Un assistant IA est disponible dans le panneau de configuration d'un nœud :
- Sélectionnez un nœud.
- Ouvrez l'assistant IA en haut du panneau de configuration.
- Décrivez en langage naturel ce que le nœud doit faire.
- Prévisualisez la suggestion, puis appliquez-la si elle convient.
Voir aussi : Nœud IA Agent · Chat Ecosystem
Raccourcis clavier
- Suppr / Delete : supprimer l'élément sélectionné
- Ctrl/Cmd + Z : annuler · Ctrl/Cmd + Y : refaire
- Ctrl/Cmd + C : copier · Ctrl/Cmd + V : coller
- Ctrl/Cmd + F : rechercher un nœud par son nom ou une valeur qu'il contient dans le canvas
- Espace : centrer la vue