Gérer les erreurs

Acheminez les nœuds échoués vers les gestionnaires d'erreurs, journalisez les détails des erreurs, réessayez en cas d'échecs temporaires et mettez fin aux erreurs irrécupérables de manière appropriée.

Ce que vous créerez : un workflow qui achemine un nœud échoué vers un chemin distinct, enregistre l'échec avec un contexte utile, réessaie en cas d'échec temporaire lorsque cela a du sens et se termine de manière appropriée lorsque l'erreur est irrécupérable. Après ce guide, vous aurez un modèle que vous pourrez déposer dans n'importe quel workflow existant.

Éléments requis

• Un compte UiPath Automation Cloud avec accès à Maestro Flow.
• Un workflow Flow existant avec au moins un nœud qui peut échouer et expose un gestionnaire d'erreurs, par exemple, une demande HTTP ou un nœud Extraction.

Nœuds utilisés

• Demande HTTP - le nœud sujet à l'échec dans cet exemple
• Script - enregistre les détails de l'erreur
• Résiliser - met fin au workflow avec un statut Failed en cas d'erreurs irrécupérables

Étapes

1. Connecter le gestionnaire d'erreurs du nœud

Par défaut, un nœud échoué arrête l'ensemble du processus. Pour gérer l'échec à la place :

1. Ouvrez votre workflow sur la zone de dessin et sélectionnez le nœud sujet à l'échec.
2. Faites glisser à partir de son gestionnaire d'erreurs - le connecteur en bas à droite du nœud - vers un nouveau nœud Script.

Cela crée un chemin d'erreur. Lorsque le nœud échoue, l'exécution est acheminée le long de ce chemin au lieu d'arrêter le processus. (Les nœuds qui n'exposent pas de gestionnaire d'erreurs ne prennent pas en charge la gestion des erreurs - un échec arrête le processus et apparaît sous l'onglet Incidents.)

2. Enregistrer l'erreur

Dans le nœud Script sur le chemin d'erreur, lisez l'objet d'erreur à $vars.<node>.error :

const error = $vars.httpRequest1.error;
console.log('Step failed:', error.message);
console.log('Code:', error.code, '| HTTP status:', error.status);
return { logged: true };

L'objet d'erreur est uniquement renseigné sur le chemin d'erreur. Pour obtenir la référence complète de ses champs, consultez la section Gestion des erreurs.

3. Relancer les échecs transitoires (facultatif)

Si l'échec est probablement transitoire - un incident réseau ou une limite de débit - réessayez avant d'abandonner. Le nœud de demande HTTP intègre des nouvelles tentatives intégrées : configurez le nombre de nouvelles tentatives dans ses propriétés, et il relance la requête autant de fois avant de déclencher le gestionnaire d'erreurs. Seul l'échec final est acheminé vers le chemin d'erreur.

Avertissement :

Réessayez uniquement les opérations idempotentes. Relancer un nœud avec des effets secondaires (écriture de données, envoi d'un message) peut créer des doublons.

4. Mettre fin si non récupérable

Sur le chemin d'erreur, après le nœud Script, ajoutez un nœud Résilier. Définir :

• Statut → Failed
• Message → une description qui inclut l'erreur, par exemple $vars.httpRequest1.error.message

Cela enregistre l'échec dans l'historique d'exécution avec une description utile, visible dans Observation des exécutions.

5. Test et débogage

Pour déclencher le chemin d'erreur intentionnellement :

1. Définissez temporairement l'URL dans le nœud de demande HTTP sur une valeur non valide (par exemple, https://this-will-fail.example.com).
2. Exécutez le test et vérifiez les traces d'exécution le long du chemin d'erreur.
3. Restaurez l'URL correcte.

Vérifier la sortie de la console du nœud Script dans la trace pour confirmer que les détails de l'erreur sont journalisés.

Résultat

Votre workflow achemine les échecs vers le chemin d'erreur, enregistre les détails de l'erreur, relance éventuellement les échecs transitoires et se termine de manière appropriée avec un statut d'échec descriptif. Vous pouvez confirmer que le chemin d'erreur fonctionne en utilisant une URL non valide dans le nœud de demande HTTP et en inspectant la sortie de la console du nœud Script dans la trace d'exécution.

Étendre ce workflow

• Envoyer une alerte en cas d'échec - Sur le chemin d'erreur, avant le nœud Résiliser, ajoutez un nœud de demande HTTP ou d'intégration pour notifier un canal Slack ou créer un ticket d'incident.
• Continuer au lieu de mettre fin - Si l'étape est non critique, demandez au chemin d'erreur de définir une valeur de secours et rejoignez le chemin principal au lieu de mettre fin à l'étape.
• Appliquer ce modèle partout - Pour plus de modèles (journaliser et continuer, valeurs de secours, escalade), consultez la référence Gestion des erreurs.