Utiliser l'éditeur de workflow
L'éditeur de workflow est l'interface graphique qui vous permet de créer et modifier vos workflows.
Interface de l'éditeur
Zone principale
L'éditeur se compose de plusieurs zones :
- Canvas : Zone centrale où vous placez et connectez les nœuds
- Panels latéraux : Panels pour ajouter des nœuds et configurer les nœuds sélectionnés
- Barre d'outils : Outils pour zoomer, centrer, etc.
Navigation dans le canvas
- Déplacer : Cliquez et glissez sur le canvas pour déplacer la vue
- Zoomer : Utilisez la molette de la souris ou les boutons de zoom
- Sélectionner : Cliquez sur un nœud pour le sélectionner
- Sélection multiple : Maintenez Shift et cliquez sur plusieurs nœuds
Ajouter des nœuds
Méthode 1 : Panel latéral
- Cliquez sur le bouton "Add Node" ou "+" dans le panel latéral
- Sélectionnez le type de nœud souhaité dans la liste
- Le nœud apparaît sur le canvas
Méthode 2 : Menu contextuel
- Clic droit sur le canvas
- Sélectionnez "Add Node"
- Choisissez le type de nœud
Méthode 3 : Glisser-déposer
- Depuis le panel latéral, glissez un type de nœud
- Déposez-le sur le canvas à l'emplacement souhaité
Configurer un nœud
Ouvrir la configuration
- Cliquez sur un nœud pour le sélectionner
- Le panel de configuration s'ouvre automatiquement à droite
- Remplissez les champs du formulaire
Champs communs
Tous les nœuds ont des champs communs :
- Name : Nom du nœud (optionnel, utile pour l'organisation)
- Stop workflow on failure : Arrêter le workflow si ce nœud échoue
Champs spécifiques
Chaque type de nœud a ses propres champs de configuration. Consultez la documentation de chaque type de nœud pour plus de détails.
Connecter les nœuds
Créer une connexion
- Survolez un nœud source
- Cliquez sur le point de connexion (handle) de sortie
- Glissez vers le nœud de destination
- Relâchez sur le point de connexion d'entrée du nœud de destination
Types de connexions
- Connexion normale : Flux d'exécution standard
- Connexion d'erreur : Vers un nœud On Error pour gérer les erreurs
Supprimer une connexion
- Sélectionnez la connexion
- Appuyez sur la touche Suppr ou Delete
- Ou utilisez le menu contextuel
Déplacer et organiser
Déplacer un nœud
- Cliquez sur un nœud
- Glissez-le à l'emplacement souhaité
- Relâchez pour le positionner
Déplacer plusieurs nœuds
- Sélectionnez plusieurs nœuds (Shift + clic)
- Glissez l'ensemble
- Tous les nœuds sélectionnés se déplacent ensemble
Alignement automatique
L'éditeur propose un alignement automatique sur une grille pour une organisation propre.
Supprimer des éléments
Supprimer un nœud
- Sélectionnez le nœud
- Appuyez sur la touche Suppr ou Delete
- Ou utilisez le menu contextuel
attention
Supprimer un nœud supprime également toutes ses connexions.
Supprimer plusieurs nœuds
- Sélectionnez plusieurs nœuds
- Appuyez sur Suppr ou Delete
Utiliser les variables
Variables disponibles
Dans chaque nœud, vous pouvez utiliser des variables du contexte :
- Données du trigger :
{{trigger.data}} - Résultats des nœuds précédents :
{{nodeName.result}} - Variables globales :
{{variableName}}
Syntaxe Handlebars
Utilisez la syntaxe Handlebars pour les variables dynamiques :
{{variable}}: Variable simple{{object.property}}: Propriété d'un objet{{#if condition}}...{{/if}}: Condition{{#each array}}...{{/each}}: Boucle
Pour plus de détails, consultez Utiliser Handlebars.
Tester dans l'éditeur
Mode test
- Cliquez sur le bouton "Test" dans la barre d'outils
- Entrez des données de test
- Exécutez le workflow
- Visualisez les résultats à chaque étape
Débogage
- Les erreurs sont affichées directement sur les nœuds concernés
- Les données à chaque étape sont visibles dans le panel de test
- Utilisez les notes pour documenter la logique
Sauvegarder
Sauvegarde automatique
Les modifications sont sauvegardées automatiquement en mode DRAFT :
- Pas besoin de cliquer sur "Save"
- Les modifications sont perdues uniquement si vous quittez sans sauvegarder explicitement
Créer une version
Pour créer une version du workflow :
- Cliquez sur "Create Version" ou "Version"
- Entrez un numéro de version (semver)
- Ajoutez un changelog (optionnel)
- Cliquez sur "Create"
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
- Espace : Centrer la vue
Bonnes pratiques
- Organisation : Organisez vos nœuds de manière logique (de gauche à droite)
- Nommage : Nommez vos nœuds pour faciliter la compréhension
- Documentation : Utilisez des nœuds Note pour documenter la logique
- Test : Testez régulièrement pendant l'édition
- Versioning : Créez des versions régulièrement
Prochaines étapes
- Découvrir les types de nœuds
- Tester un workflow
- Créer une version