Zum Hauptinhalt springen

Workflow Exception

Aktuelle Konfiguration des Tasks `Workflow Exception` im Workflow Designer

Innerhalb eines Workflows fungiert das Task Workflow Exception als zentraler Manager für alle Anomalien und Fehler, die während der Ausführung des Flows auftreten können. Mit anderen Worten können alle Ausgänge vom Typ "Exception" aus verschiedenen Tasks an dieses einzelne spezielle Task angeschlossen werden.

Wie der Name und das Icon andeuten, stellt dieses Task einen Endpunkt für Workflow-Pfade dar, die auf einen nicht behandelten Fehler gestoßen sind.

Funktionsweise​

Das Funktionsprinzip von "Workflow Exception" ist die Zentralisierung der Fehlerbehandlung. Anstatt für jeden einzelnen Task, der fehlschlagen könnte, einen spezifischen Fehlerpfad zu definieren, können alle möglichen Ausnahmen in diesen einen Punkt zusammenlaufen.

Hauptmerkmale:

  • Fehlerzentralisierung: Es sammelt alle Bedingungen vom Typ "Exception", die in den verschiedenen Tasks des Workflows definiert sind. Dies vereinfacht die Logik des Diagramms, da vermieden wird, dass mehrere Fehlerbehandlungszweige im Flow verstreut sind.
  • Keine Konfiguration: Das Task "Workflow Exception" ist nicht konfigurierbar. Seine einzige Funktion ist das "Erfangen" von Ausnahmen und das Beenden dieses Workflow-Pfades, wobei signalisiert wird, dass ein Problem aufgetreten ist.

Praktisches Beispiel​

Im dargestellten Diagramm:

  1. Der Workflow beginnt mit dem Task "Import text".
  2. Wenn der Textimport erfolgreich ist, schreitet der Flow über die "Bedingung 72" zum Task "E-Mail Out v.2" fort.
  3. Wenn der Task "Import text" aus irgendeinem Grund fehlschlägt (z. B. wenn die Datei nicht gefunden wird), wird sein Ausgangsbedingung vom Typ "Exception" aktiviert.
  4. Diese Bedingung ist direkt mit dem Task "Workflow Exception" verbunden.
  5. Folglich wird die Ausführung dieses bestimmten Workflow-Zweigs unterbrochen und als fehlgeschlagen protokolliert, ohne dass eine E-Mail gesendet wird.

Zusammenfassend ist das Task "Workflow Exception" ein grundlegendes Element für die Erstellung robuster Workflows, da es einen einfachen und visuellen Mechanismus zur Verwaltung und Identifizierung von Fehlern während der Prozessausführung bietet.

Darüber hinaus kann ein neuer Zweig des Flows gestartet werden. Dieser Pfad ist speziell für die Fehlerbehandlung konzipiert. Wie im Bild gezeigt, kann ein nachfolgender Task (z. B. ein E-Mail-Versand-Task wie "mail_exception") verbunden werden, um Administratoren oder Benutzern mitzuteilen, dass ein Problem aufgetreten ist.

Ausgabe-Parameter​

Diese Parameter können in nachfolgenden Tasks (wie im Textkörper einer E-Mail) verwendet werden, um einen detaillierten und kontextualisierten Fehlerbericht zu liefern.

Von "Parameterliste" können folgende Variablen verwendet werden:

  • result: Das allgemeine Ergebnis der Ausnahme (z. B. „Die vom Task Import text ausgelöste Ausnahme wurde behandelt“).
  • exceptionMessage: Die spezifische Fehlermeldung, die vom fehlgeschlagenen Task zurückgegeben wird. Dies ist der nützlichste Parameter, um die Art des Problems zu verstehen (z. B. "Datei nicht gefunden", "Datenbankverbindung fehlgeschlagen", etc.).
  • failedTaskName: Der Name des Tasks, der den Fehler verursacht hat.
  • failedTaskId: Die eindeutige Kennung (ID) des Tasks, der den Fehler verursacht hat.
  • failedTaskType: Der Typ des Tasks, der den Fehler verursacht hat (z. B. "Import text", "Datenbankabfrage", etc.).