Konfigurieren der Fehlerbehandlung

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.

Fehler und Fehlerzuordnungen

Maestro Orchestrate distinguishes between two related concepts:

• Fehler werden auf Prozessebene definiert. Sie stellen benannte Fehlertypen dar, auf die jeder Knoten im Prozess verweisen kann.
• Error-Zuordnungen werden auf Elementebene definiert. Jeder Knoten hat seine eigene Liste von Zuordnungen, die mit Fehlern auf Prozess verknüpft sind und die Catch-Bedingungen für diesen bestimmten Knoten definieren.

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.

Hinzufügen einer Fehlerzuordnung

Um eine Fehler-Zuordnung zu einem Knoten hinzuzufügen, verwenden Sie den Abschnitt „Fehler-Zuordnung“ im Eigenschaftenbereich, um zu definieren, welche Fehler der Knoten erkennt und wie diese zur Runtime weitergeleitet werden.

1. Wählen Sie den Knoten auf der Arbeitsfläche aus.
2. Gehen Sie im Eigenschaftenbereich zu Fehler-Zuordnung.
3. Wählen Sie Zuordnung hinzufügen aus.
4. Konfigurieren Sie die Zuordnungsfelder (siehe Eigenschaften derFehlerzuordnung unten).

Ergebnis

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.

Eigenschaften der Fehlerzuordnung

Feld	Beschreibung
Fehler (Error)	Der Fehler auf Prozessebene, der durch diese Zuordnung erfasst wird. Wählen Sie aus der Dropdownliste oder wählen Sie die Menüschaltfläche aus, um das Dialogfeld zur Fehler-Erstellung zu öffnen und einen neuen Fehler inline zu definieren.Durch die Auswahl eines Fehlers wird die errorRef der Zuordnung auf die ID des ausgewählten Fehlers auf Prozess gesetzt.
Bedingung	Definiert, wann diese Zuordnung angewendet wird. Verwenden Sie die Variablenauswahl, um den Ausdruck zu erstellen, oder wechseln Sie für komplexe Bedingungen zum JavaScript- oder C#-Editor. Lassen Sie den Bereich leer, um den Fehler bedingungslos zu erkennen.
Details	Eine Freitextbeschreibung für die Zuordnung. Verwenden Sie dies, um die Absicht der Zuordnung für Ihr Team zu dokumentieren.

Neuanordnen von Zuordnungen nach Priorität

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.

Fehlerverbreitung

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

• Grenzereignisse: Der Fehler breitet sich auf das Fehlergrenzereignis aus, das an den Knoten angehängt ist, und der Prozess folgt dem ausgehenden Pfad des Grenzereignisses.
• Ereignisunterprozesse: Fehler, die im übergeordneten Prozess ausgelöst werden, werden an Ereignisunterprozesse weitergeleitet, die ein Fehlerstartereignis verwenden, wodurch die im Unterprozess definierte zentrale Fehlerbehandlung ausgelöst wird.

Für die Modellierung von Mustern, die Grenzereignisse und Ereignisunterprozesse verwenden, siehe Fehler und Wiederherstellung.

Erstellen von Fehlern auf Prozessebene

Fehler auf Prozessebene werden über alle Knoten im Prozess hinweg geteilt. So erstellen Sie einen neuen Fehler:

1. Wählen Sie im Feld Fehler einer Zuordnung die Menüschaltfläche aus.
2. Geben Sie im angezeigten Dialogfeld einen Namen und optional einen Fehler-Code ein.
3. Wählen Sie Erstellen.

Ergebnis

Der Fehler wird dem Prozess hinzugefügt und in der aktuellen Zuordnung ausgewählt. Es steht jetzt für die Referenz durch die Fehlerzuordnungen eines Knotens zur Verfügung.

Auf denselben Fehler kann durch Zuordnungen auf mehreren Knoten verwiesen werden.