Workflows et runs

Un workflow est la définition versionnée : nodes, edges, triggers et configuration. Une exécution (run) est un passage concret de cette définition à un instant donné, avec statut et logs.

💡 Définition vs exécution

	Workflow	Run (exécution)
Nature	Modèle JSON + métadonnées Dolibarr	Instance d’exécution
Cycle	Brouillon → actif → archivé	queued → running → terminal
Stockage	Tables llx_knot_* (schéma interne)	Historique Executions
Idempotence	Clés configurées sur les nodes	Appliquée à chaque retry

💡 Cycle de vie du workflow

• Brouillon : édition libre, Simulate autorisé si Problems est vide.
• Actif : les triggers (cron, webhook, object event) peuvent créer des runs.
• Archivé : plus de nouvelles exécutions ; historique conservé.

💡 États d’un run

Statut	Signification
queued	En attente du cron Knot ou d’un slot d’exécution
running	Moteur en cours sur la chaîne de nodes
success	Terminé sans erreur bloquante
error	Échec — consulte les logs par node
cancelled	Annulation manuelle
skipped	Branche non prise (ex. If/Else)

Retry

Après un échec transient, un retry relance le run en réutilisant l’idempotence si tu l’as configurée sur le node concerné.

💡 Voir aussi

• Triggers et planification
• Suivre les runs (guide détaillé à venir)