Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
Automatisations

Flux d'automatisation

Créer un flux d'automatisation : choisir le type de document, le déclencheur, les conditions et les étapes, puis le tester.

Un flux d'automatisation (Automation Flow) décrit un scénario : l'événement qui le démarre, les conditions à remplir et les étapes à exécuter.

Prérequis

  • Le rôle Responsable système (System Manager). Seul ce rôle peut créer un flux.

Créer un flux

  1. Ouvrez la liste Flux d'automatisation depuis l'espace de travail Automatisation.
  2. Cliquez sur Ajouter.
  3. Saisissez un Titre explicite.
  4. Sélectionnez le Type de document cible, par exemple « Client ». Une table enfant ne peut pas être une cible.
  5. Choisissez le Type de déclencheur et ses paramètres. Voir Déclencheurs.
  6. Ajoutez des règles dans Champs correspondants pour limiter les documents concernés.
  7. Ajoutez les étapes dans la table Actions. Voir Actions.
  8. Enregistrez.
  9. Cochez Activé, puis enregistrez de nouveau.

Un flux ne peut être activé qu'avec au moins une action et un déclencheur valide.

Champs du flux

ChampRôle
TitreLe nom du flux dans les listes et l'historique.
Type de documentLe type de document surveillé. Obligatoire pour les déclencheurs liés à un document ou à une date.
ActivéLe flux ne s'exécute que s'il est coché.
Raison de désactivationRempli par le moteur quand il désactive le flux après des échecs répétés.
Champs correspondantsLes règles sur les champs du document. Toutes doivent être vraies.
Expression avancée en PythonUne expression Python facultative, avec le document dans doc. Utile pour une condition « OU ».
Revalider à l'exécutionVérifie de nouveau les conditions au moment de l'exécution en arrière-plan.
Exécuter en tant queL'identité de l'exécution : l'utilisateur déclencheur, le propriétaire du document ou un utilisateur d'automatisation.
Utilisateur d'automatisationL'utilisateur utilisé avec « Utilisateur d'automatisation ». Valeur par défaut : Administrator.
Arrêter en cas d'erreurArrête les étapes suivantes quand une étape échoue. Coché par défaut.

Organiser les étapes

Chaque ligne de la table Actions a un Type d'étape :

Step TypeEffet
ActionExécute l'action choisie dans Action Type.
WaitMet l'exécution en pause pendant une durée en secondes, minutes, heures ou jours.
WaitForEventAttend un événement personnalisé, avec une clé de corrélation et un délai maximal.
IfÉvalue la Condition de l'étape et choisit une branche.

Pour placer une étape dans une branche, renseignez Étape parente avec le numéro de ligne de l'étape « If ». Choisissez ensuite « If » ou « Else » dans Branche de l'étape parente. L'étape « If » doit être sur une ligne précédente.

Une Condition de l'étape sur une étape « Action » saute l'étape quand la condition est fausse.

Tester un flux

Le bouton Exécution de test apparaît sur un flux enregistré.

  1. Cliquez sur Exécution de test.
  2. Sélectionnez le document dans Exécuter sur.
  3. Cliquez sur Run.

Le flux s'exécute réellement sur ce document, puis toutes ses écritures sont annulées. Une fenêtre affiche le statut de chaque étape. Un webhook n'est pas envoyé pendant un test : le résultat indique seulement la requête qui serait faite. Une étape « Wait » est simulée.

Exemple

Exemple fictif : vous voulez prévenir le commercial quand un client passe au statut actif.

ChampValeur
TitreClient activé
Type de documentClient
Type de déclencheurChamp modifié
Champ déclencheurdisabled
Valeur de départ1
To Value0
Ligne 1 de ActionsStep Type « Action », Action Type « Send Notification »

À chaque enregistrement où la case « Désactivé » passe de cochée à décochée, le moteur envoie la notification.

Désactivation automatique

Après plusieurs échecs consécutifs, le moteur décoche Activé et remplit Raison de désactivation. Le seuil est le champ Seuil d'échec des paramètres d'automatisation. Les déclenchements en attente du flux passent au statut « Skipped ».