Configuration de la gestion des erreurs

Configure error mappings on BPMN nodes to define how Maestro Orchestrate catches, evaluates conditions for, and routes runtime errors during process execution.

Each node in your BPMN process can have one or more error mappings that define how Maestro Orchestrate handles errors thrown at runtime. Use the Error mapping property in the properties panel to specify which errors a node catches, under what conditions, and how to route them.

Erreurs et mappages d'erreur

Maestro Orchestrate distinguishes between two related concepts:

• 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.

When a node throws an error at runtime, Maestro Orchestrate evaluates its error mappings in priority order and applies the first mapping whose condition evaluates to true.

Ajout d’un mappage d’erreur

Pour ajouter un mappage d'erreur à un nœud, utilisez la section Mappage d'erreurs dans le panneau Propriétés pour définir les erreurs que le nœud détecte et comment les acheminer lors du runtime.

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).

Résultat

The error mapping is added to the node. Maestro Orchestrate evaluates it at runtime when the node throws an error, applying the first mapping whose condition evaluates to true.

Propriétés de mappage d’erreur

Champ	Description
Erreur	L’erreur au niveau du processus que ce mappage détecte. Sélectionnez dans le menu déroulant ou sélectionnez le bouton de menu pour ouvrir la boîte de dialogue de création d'erreurs 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 Orchestrate evaluates error mappings in the order they appear. To change evaluation order, drag a mapping to a new position in the list. The mapping at the top is evaluated first.

Propagation de l'erreur

Once an error mapping matches, Maestro Orchestrate routes the error to the appropriate handler attached to the node:

• É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, sélectionnez 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.

Résultat

L’erreur est ajoutée au processus et sélectionnée dans le mappage actuel. Elle est désormais disponible en référence par les mappages d'erreur de n'importe quel nœud.

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