Configuration de la gestion des erreurs

Chaque nœud de votre processus BPMN peut avoir un ou plusieurs mappages d'erreur qui définissent la façon dont Maestro gère les erreurs générées lors du runtime. Utilisez la propriété Mappage d'erreur dans le panneau Propriétés pour spécifier les erreurs qu’un nœud détecte, dans quelles conditions et comment les acheminer.

Erreurs et mappages d'erreur

Maestro distingue entre deux concepts connexes :

• Les erreurs sont définies au niveau du processus. Ils représentent des types d'erreur nommés auxquels n’importe quel nœud dans le processus peut se référer.
• Les mappages d’erreur sont définis au niveau de l’élément. Chaque nœud a sa propre liste de mappages qui sont liés aux erreurs au niveau du processus et définissent les conditions de capture de ce nœud spécifique.

Lorsqu’un nœud génère une erreur lors du runtime, Maestro évalue ses mappages d’erreur dans l’ordre de priorité et applique le premier mappage dont la condition est évaluée à true.

Ajout d’un mappage d’erreur

1. Sélectionnez le nœud sur la zone de dessin.
2. Dans le panneau Propriétés, accédez à Mappage d'erreur.
3. Sélectionnez Ajouter un mappage.
4. Configurez les champs de mappage (consultez les propriétés de mappage d'erreur ci-dessous).

Propriétés de mappage d’erreur

Champ	Description
Erreur	L’erreur au niveau du processus que ce mappage détecte. Sélectionnez dans la liste déroulante ou cliquez sur le bouton de menu pour ouvrir la boîte de dialogue de création d’erreur et définir une nouvelle erreur directement dans le code. La sélection d’une erreur définit la valeur errorRef du mappage sur l’ID de l’erreur choisie au niveau du processus.
Condition	Définit quand ce mappage s’applique. Utilisez le sélecteur de variables pour créer l’expression, ou passez à l’éditeur JavaScript ou C# pour les conditions complexes. Laissez vide pour détecter l’erreur inconditionnellement.
Détails (Details)	Une description en texte libre du mappage. Utilisez-la pour documenter l’intention du mappage de votre équipe.

Réordonner des mappages par priorité

Maestro évalue les mappages d’erreur dans l’ordre dans lequel ils apparaissent. Pour modifier l’ordre de l’évaluation, faites glisser un mappage vers une nouvelle position dans la liste. Le mappage en haut est évalué en premier.

Propagation de l'erreur

Une fois qu’un mappage d’erreur correspond, Maestro achemine l’erreur vers le gestionnaire approprié joint au nœud :

• Événements de limite : l’erreur se propage à l’événement de limite d’erreur joint au nœud et le processus suit le chemin sortant de l’événement de limite.
• Sous-processus d'événement : les erreurs soulevées dans le processus parent se propagent aux sous-processus d’événements qui utilisent un événement de démarrage en cas d’erreur, déclenchant une gestion centralisée des erreurs définie dans le sous-processus.

Pour modéliser des schémas qui utilisent des événements de limite et des sous-processus d'événements, consultez Erreurs et récupération.

Création d’erreurs au niveau du processus

Les erreurs au niveau du processus sont partagées entre tous les nœuds du processus. Pour créer une nouvelle erreur :

1. Dans le champ Error de n’importe quel mappage, cliquez sur le bouton de menu.
2. Dans la boîte de dialogue qui s’ouvre, entrez un nom et, facultativement, un code d’erreur.
3. Sélectionnez Créer. L’erreur est ajoutée au processus et sélectionnée dans le mappage actuel.

La même erreur peut être référencée par des mappages sur plusieurs nœuds.