Aller au contenu principal

Depannage Workflows

En bref​

Ce guide couvre les problemes courants du Workflow Builder : echecs d'execution, erreurs de blocs, timeouts, problemes de variables et de scheduling.

Echecs d'execution​

Le workflow echoue immediatement​

Causes possibles :

  • Un bloc de demarrage est manquant
  • La configuration d'un bloc est incomplete
  • Une variable referencee n'existe pas

Solutions :

  1. Verifiez que le workflow possede un bloc Start ou un Trigger (webhook, schedule, event).
  2. Ouvrez le panneau de debug et consultez le message d'erreur du premier bloc echoue.
  3. Verifiez que toutes les variables utilisees sont definies (voir section Variables ci-dessous).

Le workflow se bloque (timeout)​

Causes possibles :

  • Un bloc d'appel externe ne repond pas
  • Une boucle infinie dans un bloc Loop
  • Le temps d'execution depasse la limite

Solutions :

  1. Verifiez les timeouts configures sur les blocs d'integration et d'appel API.
  2. Verifiez la condition de sortie du bloc Loop — ajoutez une limite d'iterations maximum.
  3. Consultez la duree maximale dans Limites et quotas.

Le workflow echoue en mode Run mais fonctionne en mode Test​

Cause : Les deux modes utilisent des chemins d'execution differents. Le mode Test est synchrone, le mode Run est durable avec checkpointing.

Solutions :

  1. Verifiez que les blocs d'appel externe sont idempotents (peuvent etre reexecutes sans effet de bord).
  2. Consultez les logs de l'execution en mode Run dans le panneau Executions.
  3. Verifiez les variables d'environnement — elles peuvent differer entre les deux modes.

Erreurs de blocs​

Bloc Condition : branche inattendue​

Cause : La condition est evaluee differemment de ce qui est attendu.

Solutions :

  1. Verifiez le type de la variable comparee (texte vs nombre).
  2. Utilisez le mode debug pour inspecter la valeur reelle de la variable au moment de l'evaluation.
  3. Attention aux comparaisons de chaines : "10" (texte) est different de 10 (nombre).

Bloc Tool : "Outil non trouve"​

Causes possibles :

  • L'outil reference a ete supprime ou renomme
  • L'outil n'est pas disponible dans le workspace

Solutions :

  1. Verifiez que l'outil existe dans Agent Studio > Outils.
  2. Reconfigurer le bloc en selectionnant l'outil a nouveau.

Bloc Email : "Echec d'envoi"​

Causes possibles :

  • Adresse email invalide
  • Template d'email mal formate
  • Quota d'envoi depasse

Solutions :

  1. Verifiez l'adresse email du destinataire.
  2. Testez le template avec des valeurs statiques avant d'utiliser des variables.
  3. Consultez les quotas d'envoi dans les parametres du workspace.

Variables et resolution​

Variable non resolue​

Symptome : Le bloc affiche la variable brute (ex. {{nomVariable}}) au lieu de sa valeur.

Causes possibles :

  • Nom de variable incorrect (casse, tirets, espaces)
  • La variable est definie dans un bloc qui n'a pas encore ete execute
  • Le bloc source de la variable est sur une autre branche du workflow

Solutions :

  1. Verifiez l'orthographe exacte de la variable, y compris la casse.
  2. Verifiez que le bloc qui definit la variable est bien en amont dans le flux d'execution.
  3. Utilisez le panneau de variables pour voir toutes les variables disponibles a un point donne du workflow.

Variable vide​

Cause : Le bloc source a produit un resultat vide ou null.

Solutions :

  1. Inspectez la sortie du bloc source dans le mode debug.
  2. Ajoutez une valeur par defaut avec la syntaxe {{variable || "valeur par defaut"}}.

Scheduling​

Le schedule ne se declenche pas​

Causes possibles :

  • Le workflow n'est pas active
  • L'expression cron est invalide
  • Le fuseau horaire est incorrect

Solutions :

  1. Verifiez que le workflow est bien en statut Actif (pas en pause).
  2. Validez l'expression cron — utilisez un outil en ligne pour verifier la prochaine execution.
  3. Verifiez le fuseau horaire configure dans les parametres du schedule.

Executions multiples non souhaitees​

Cause : Le schedule declenche le workflow plus souvent que prevu.

Solutions :

  1. Verifiez l'expression cron (ex. * * * * * = chaque minute, pas chaque heure).
  2. Verifiez qu'il n'y a pas plusieurs triggers sur le meme workflow.

Voir aussi​

Besoin d'aide ?​

Ecrivez-nous : Support et contact.