Aller au contenu principal

Nœud On Error

Le nœud On Error gère les erreurs du flux : il se déclenche quand un nœud échoue et exécute la branche qui lui est connectée (alerte, fallback, log) au lieu de laisser l'exécution échouer sans contrôle. Il permet de capturer les erreurs d'exécution, d'implémenter une logique de fallback ou d'alerte et de continuer le flux après une erreur maîtrisée.

C'est un point de départ, comme le nœud Déclencheur : il n'a pas de point d'entrée et on ne peut pas s'y connecter directement. Il se déclenche automatiquement lorsqu'une erreur survient dans le workflow.

Paramètres​

Le nœud On Error se déclenche dès qu'un nœud du flux échoue. Le seul paramètre est le mode de traçage :

ParamètreTypeObligatoireDéfautDescription
Mode de traçageComplet / Standard / Performance❌—Niveau de détail enregistré pour ce nœud dans la trace — voir Modes de traçage.

Entrée​

Le nœud On Error reçoit les informations de l'erreur qui s'est produite :

{
  "error": {
    "message": "Error message",
    "code": "ERROR_CODE",
    "details": {}
  },
  "node": "nodeName",
  "lastResponse": {}
}

Sortie​

Le nœud On Error exécute la branche qui lui est connectée (email d'alerte, appel de secours, log, etc.). Les informations d'erreur restent disponibles dans les nœuds suivants via {{error.message}}, {{error.code}}, {{error.details}}, {{node}} et {{lastResponse}}.

Erreurs​

Le nœud On Error ne produit pas d'erreur propre : il se déclenche sur l'échec d'un autre nœud du flux (erreur HTTP, SQL, code, etc.).

Quand l'erreur est-elle gérée ?

Un nœud échoue (erreur HTTP, SQL, code, etc.). Selon sa configuration Stopper l'exécution du flux en cas d'échec :

  • Activé (true, défaut) : le flux s'arrête, sauf si un nœud On Error est présent dans le flux — dans ce cas l'erreur déclenche le nœud On Error.
  • Désactivé (false) : le flux continue et l'erreur est disponible dans lastResponse.

Sans nœud On Error, un nœud qui échoue avec Stopper l'exécution du flux en cas d'échec activé arrête le flux.

Exemple​

Alerte par email :

  1. Ajoutez un nœud On Error au flux.
  2. Connectez-lui la branche de gestion : nœud On Error → nœud Envoyer un e-mail avec le contenu de {{error.message}}.
  3. Quand un nœud du flux échoue, l'équipe reçoit une alerte sans que le flux ne se bloque.

Fallback vers une API de secours :

  1. Ajoutez un nœud On Error au flux.
  2. Connectez-lui la branche de gestion : nœud On Error → nœud Requête HTTP(S) vers l'API de secours.
  3. Le traitement se poursuit avec les données de l'API de secours.

Voir aussi​