Aller au contenu principal

Créer un workflow

Ce guide vous explique comment créer un workflow dans Ecosystem.

Prérequis​

  • Avoir accès à une entreprise
  • Avoir créé un trigger (ou en créer un en même temps)
  • Avoir les permissions nécessaires (USER ou ADMIN)
💡 Créer un trigger en même temps

Vous pouvez créer un nouveau trigger directement depuis le formulaire de création de workflow en cliquant sur "Create new trigger". Cela vous évite de naviguer entre les pages.

Étapes de création​

1. Accéder à la page de création​

  1. Cliquez sur "Workflows" dans le menu de navigation
  2. Cliquez sur le bouton "Create" en haut de la page

2. Remplir le formulaire​

Le formulaire de création contient les champs suivants :

Informations de base​

  • Name (obligatoire) : Nom du workflow

    • Exemple : "Traitement de commandes"
    • Ce nom sera visible dans la liste des workflows

  • Description (optionnel) : Description du workflow

    • Aide à comprendre l'objectif du workflow
    • Visible dans la liste et les détails

  • Trigger (obligatoire) : Trigger associé au workflow

    • Sélectionnez un trigger existant dans la liste déroulante
    • Ou créez un nouveau trigger en cliquant sur "Create new trigger"
    • Chaque workflow doit être associé à un trigger unique
🔗 Association Trigger-Workflow

Une fois le workflow créé, l'association avec le trigger ne peut plus être modifiée. Si vous devez changer de trigger, vous devrez créer un nouveau workflow.

Tags (optionnel)​

Ajoutez des tags pour catégoriser votre workflow :

  • Cliquez dans le champ "Tags"
  • Tapez le nom du tag et appuyez sur Entrée
  • Les tags existants apparaîtront en suggestions
  • Vous pouvez créer de nouveaux tags à la volée

3. Créer le workflow​

  1. Vérifiez toutes les informations
  2. Cliquez sur le bouton "Create"
  3. Vous serez redirigé vers l'éditeur de workflow

Après la création​

Une fois le workflow créé :

  1. Statut : Le workflow est créé avec le statut DRAFT
  2. Nœud Trigger : Un nœud trigger est automatiquement ajouté
  3. Édition : Vous pouvez commencer à éditer le workflow
  4. Configuration : Configurez les nœuds et ajoutez la logique

Structure initiale​

Lors de la création, le workflow contient automatiquement :

  • Un nœud Trigger : Point d'entrée basé sur le trigger sélectionné
  • Ce nœud ne peut pas être supprimé
  • Il représente le déclencheur du workflow
🎯 Point d'entrée

Le nœud Trigger est le point d'entrée de votre workflow. C'est à partir de ce nœud que vous pouvez accéder aux données reçues via data ou context.trigger.body dans les nœuds suivants.

Prochaines étapes​

Maintenant que votre workflow est créé :

  1. Utiliser l'éditeur pour ajouter des nœuds
  2. Configurer les nœuds selon vos besoins
  3. Tester le workflow avant de déployer
  4. Créer une version une fois prêt
  5. Déployer le workflow dans un environnement

Bonnes pratiques​

  • Nommage : Utilisez des noms clairs et descriptifs
  • Description : Ajoutez toujours une description pour faciliter la maintenance
  • Tags : Utilisez des tags cohérents pour faciliter la recherche
  • Planification : Planifiez votre workflow avant de commencer à l'éditer
  • Documentation : Documentez la logique complexe dans les notes

Modifier un workflow​

Pour modifier un workflow existant :

  1. Accédez à la page "Workflows"
  2. Cliquez sur le workflow à modifier
  3. Vous accédez à l'éditeur de workflow
  4. Modifiez les nœuds et connexions selon vos besoins
  5. Les modifications sont sauvegardées automatiquement (en mode DRAFT)
⚠️ Modifications en mode DRAFT

Les modifications d'un workflow en statut DRAFT n'affectent pas les versions déployées. Pour déployer vos changements, vous devez créer une nouvelle version du workflow. Les workflows déployés continueront d'utiliser leur version jusqu'à ce qu'une nouvelle version soit déployée.

Prochaines étapes​