Aller au contenu principal

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.
  • 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

  1. Cliquez sur le bouton "Add Node" ou "+" dans le panel latéral
  2. Sélectionnez le type de nœud souhaité dans la liste
  3. Le nœud apparaît sur le canvas

Méthode 2 : Menu contextuel

  1. Clic droit sur le canvas
  2. Sélectionnez "Add Node"
  3. Choisissez le type de nœud

Méthode 3 : Glisser-déposer

  1. Depuis le panel latéral, glissez un type de nœud
  2. Déposez-le sur le canvas à l'emplacement souhaité

Configurer un nœud

Ouvrir la configuration

  1. Cliquez sur un nœud pour le sélectionner
  2. Le panel de configuration s'ouvre automatiquement à droite
  3. 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

  1. Survolez un nœud source
  2. Cliquez sur le point de connexion (handle) de sortie
  3. Glissez vers le nœud de destination
  4. 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

  1. Sélectionnez la connexion
  2. Appuyez sur la touche Suppr ou Delete
  3. Ou utilisez le menu contextuel

Déplacer et organiser

Déplacer un nœud

  1. Cliquez sur un nœud
  2. Glissez-le à l'emplacement souhaité
  3. Relâchez pour le positionner

Déplacer plusieurs nœuds

  1. Sélectionnez plusieurs nœuds (Shift + clic)
  2. Glissez l'ensemble
  3. 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

  1. Sélectionnez le nœud
  2. Appuyez sur la touche Suppr ou Delete
  3. Ou utilisez le menu contextuel
attention

Supprimer un nœud supprime également toutes ses connexions.

Supprimer plusieurs nœuds

  1. Sélectionnez plusieurs nœuds
  2. 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

  1. Cliquez sur le bouton "Test" dans la barre d'outils
  2. Entrez des données de test
  3. Exécutez le workflow
  4. 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 :

  1. Cliquez sur "Create Version" ou "Version"
  2. Entrez un numéro de version (semver)
  3. Ajoutez un changelog (optionnel)
  4. 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