Fail Node

Le node Fail Node arrête volontairement un workflow avec un message d'erreur personnalisé, utile pour la validation, l'application de règles métier et la gestion explicite des erreurs.

À quoi sert le node Fail Node ?

Le node Fail Node arrête l’exécution du workflow et renvoie un message d’erreur personnalisé. Utilisez-le comme point de terminaison explicite lorsqu’une condition amont n’est pas remplie : pour valider les entrées au plus tôt, appliquer des règles métier, ou faire remonter un échec clair et lisible à la personne qui exécute (ou supervise) le workflow.

Cas d’usage typiques :

• Stopper le workflow lorsqu’une entrée requise (URL, clé API, dataset) est absente ou invalide.
• Appliquer une règle métier avant de continuer (ex : contenu de moins de 500 mots, score hors [0, 100]).
• Transformer une erreur API molle (HTTP 4xx/5xx) en échec de workflow dur et traçable, avec contexte complet.
• Arrêter tôt lorsqu’une limite de débit ou un quota est atteint.

Configuration rapide

Suivez ces étapes pour ajouter et configurer le node Fail Node dans votre workflow :

Paramètres de configuration

Le Fail Node ne prend qu’un seul paramètre texte, mais c’est la qualité du message qui rend ce node utile.

Champs requis

Champs optionnels

Que renvoie le node ?

Le Fail Node n’a pas de port de sortie : il termine l’exécution du workflow au lieu de produire des données. Le moteur d’exécution lève une UserFailedException avec votre message en pièce jointe, qui est restituée dans le log d’exécution et tout canal de supervision abonné.

Comment récupérer l’output ?

Comme le node met fin à l’exécution, les nodes en aval ne sont jamais atteints. Pour réagir à l’échec, consommez le résultat d’exécution du workflow depuis l’extérieur (webhook API, vue d’historique, alerting). Le message que vous avez rédigé dans le node est exactement ce que le consommateur reçoit.

Exemples d’utilisation

Cas 1 : Valider une entrée requise au plus tôt

Garantir qu’une URL est fournie avant de lancer un pipeline de scraping coûteux.

Vérification du Conditional (amont) : {{Text_Input_0.text}} est vide.

Configuration du message d’erreur :

URL is required but was not provided.
Please supply a valid http(s) URL in the Text Input node.

Ce qu’il se passe à l’exécution : lorsque le Conditional route vers le Fail Node, le workflow s’arrête immédiatement. Les nodes Web Scraper / LLM en aval ne sont jamais facturés.

Cas 2 : Imposer une longueur minimale de contenu avec interpolation

Refuser un contenu de moins de 500 mots avant envoi vers un CMS.

Vérification du Conditional (amont) : {{Count_List_Items_0.count}} < 500.

Configuration du message d’erreur :

Content too short ({{Count_List_Items_0.count}} words).
Minimum required: 500. Expand the article before publishing.

Message généré à l’exécution (exemple) :

Content too short (312 words).
Minimum required: 500. Expand the article before publishing.

Cas 3 : Faire suivre un message d’erreur externe

Lorsque le message est construit par un node LLM ou API amont, externalisez-le :

1. Dans les paramètres du Fail Node, cochez Use variable for error message.
2. Le champ est remplacé par {{errorMessage}}.
3. Câblez la sortie du node amont vers la variable errorMessage du workflow.

Le node relaie alors le message produit par le node amont, sans aucune édition de chaîne dans le Fail Node lui-même.

Problèmes courants

Le workflow échoue toujours, même sur le chemin nominal

Cause : le Fail Node a été placé en ligne (sans Conditional en amont), donc chaque exécution l’atteint.

Solution : insérez un node Conditional en amont et reliez le Fail Node uniquement à la branche d’échec. La branche de succès doit le contourner entièrement.

Le message d'erreur contient le placeholder littéral `{{variableName}}`

Cause : le nom de variable ne correspond à aucune sortie amont, ou le node amont n’a pas produit de valeur avant le déclenchement du Fail Node.

Solution : copiez le nom de variable depuis le panneau de sortie du node source. Vérifiez que ce node source est bien en amont du Conditional qui déclenche le Fail Node, afin que sa valeur soit disponible au moment de l’interpolation.

`Use variable for error message` est activé mais le message est vide

Cause : la variable externe {{errorMessage}} n’est pas reliée ou la valeur amont est vide.

Solution : le runner se rabat sur Workflow failed intentionally dans ce cas. Pour obtenir un message exploitable, assurez-vous que le node amont écrit bien une chaîne non vide dans la variable de workflow errorMessage.

Erreur de validation `Error message is required` dans le panneau de paramètres

Cause : le champ est vide et la case d’externalisation est décochée.

Solution : soit saisissez un message (la seule valeur d’apparence vide acceptée est la référence littérale {{errorMessage}}), soit cochez Use variable for error message.

Bonnes pratiques et pièges à éviter

Comment s’intègre-t-il dans un workflow ?

Le Fail Node est un node terminal placé sur la branche d’échec d’un Conditional. Le motif est « valider, puis dérouler » : un ou plusieurs Conditional à l’entrée du workflow, chacun gardant un Fail Node, puis les nodes productifs en aval.

graph LR
    Input[Text Input] --> Cond{URL valide ?}
    Cond -->|Non| Fail[Fail Node
<br/>URL absente]
    Cond -->|Oui| Scraper[Web Scraper]
    Scraper --> LLM[LLM]
    LLM --> Output[Output]

Nodes complémentaires