Aller au contenu principal

Workflow Exception

Configuration actuelle de la tâche `Workflow Exception` dans le concepteur de flux de travail

À l'intérieur d'un workflow, la tâche Workflow Exception agit comme un gestionnaire centralisé pour toutes les anomalies et erreurs qui peuvent survenir pendant l'exécution du flux. En d'autres termes, toutes les conditions de sortie de type "Exception" provenant des différentes tâches peuvent être reliées à cette unique tâche spéciale.

Comme le nom et l'icône le suggèrent, cette tâche représente un point terminal pour les chemins du workflow qui ont rencontré une erreur non gérée.

Fonctionnement​

Le principe de fonctionnement du "Workflow Exception" est d'accentrer la gestion des erreurs. Au lieu de définir un chemin d'erreur spécifique pour chaque tâche susceptible d'échouer, il est possible de faire converger toutes les exceptions possibles dans ce point unique.

Caractéristiques Principales:

  • Centralisation des Erreurs: Collecte toutes les conditions de type "Exception" définies dans les différentes tâches du workflow. Cela simplifie la logique du diagramme, évitant d'avoir de nombreux branches de gestion des erreurs éparpillées dans le flux.
  • Aucune Configuration: La tâche "Workflow Exception" n'est pas configurable. Sa seule fonction est de "capturer" les exceptions et de terminer ce chemin du workflow, signalant qu'un problème s'est produit.

Exemple Pratique​

Dans le diagramme présenté :

  1. Le workflow commence avec la tâche "Import text".
  2. Si l'importation du texte a lieu avec succès, le flux continue à travers la "Condizione 72" vers la tâche "E-Mail Out v.2".
  3. Si, pour quelque raison que ce soit, la tâche "Import text" échoue (par exemple, le fichier n'est pas trouvé), sa condition de sortie de type "Exception" est activée.
  4. Cette condition est directement reliée à la tâche "Workflow Exception".
  5. Par conséquent, l'exécution de ce branche particulier du workflow s'arrête et est enregistrée comme ayant échoué, sans que ce soit envoyé de courriel.

En résumé, la tâche "Workflow Exception" est un élément fondamental pour la création de workflows robustes, car elle fournit un mécanisme simple et visuel pour gérer et identifier les échecs pendant l'exécution des processus.

De plus, il est possible de lancer un nouveau branche du flux. Ce chemin est spécifiquement conçu pour la gestion de l'erreur. Comme montré sur l'image, il est possible de connecter une tâche suivante (par exemple, une tâche d'envoi de courriel comme "mail_exception") pour notifier aux administrateurs ou aux utilisateurs qu'un problème s'est produit.

Paramètres de Sortie​

Ces paramètres peuvent être utilisés dans les tâches suivantes (comme dans le corps d'un courriel) pour fournir un rapport détaillé et contextualisé de l'erreur.

De la "Liste Paramètres" on peut utiliser les variables suivantes :

  • result: Le résultat général de l'exception (ex. “L'exception lancée par la tâche Import text a été gérée”).
  • exceptionMessage: Le message d'erreur spécifique retourné par la tâche ayant échoué. C'est le paramètre le plus utile pour comprendre la nature du problème (ex. "Fichier non trouvé", "Connexion au serveur échouée", etc.).
  • failedTaskName: Le nom de la tâche qui a généré l'erreur.
  • failedTaskId: L'identifiant unique (ID) de la tâche qui a généré l'erreur.
  • failedTaskType: Le type de tâche qui a généré l'erreur (ex. "Import text", "Requête à la base de données", etc.).