Mit dem TryCatch-Knoten stellen Sie eine besondere Steuerroutine für die Verarbeitung von Ausnahmen bereit.
Dieses Kapitel enthält folgende Abschnitte:
Ursprünglich wird die Eingabenachricht an das Try-Terminal weitergeleitet, das Sie mit den übrigen, nicht fehlerverarbeitenden Knoten des Nachrichtenflusses verbinden müssen. Wenn ein nachgeschalteter Knoten (z. B. ein Throw-Knoten) eine Ausnahmebedingung auslöst, wird sie vom TryCatch-Knoten abgefangen. Er leitet die Originalnachricht an das zugehörige Catch-Terminal weiter. Verbinden Sie das Catch-Terminal mit weiteren Knoten, um eine Fehlerverarbeitung der Nachricht nach einer Ausnahme zu ermöglichen. Wenn das Catch-Terminal angeschlossen ist, wird die Nachricht dorthin weitergegeben. Wenn das Catch-Terminal nicht angeschlossen ist, wird die Nachricht verworfen.
Der TryCatch-Knoten befindet sich im Ablagefach Aufbau der Palette und wird in der Workbench durch folgendes Symbol dargestellt:
Verwenden Sie den Throw-Knoten und den TryCatch-Knoten, wenn Sie mit dem Compute-Knoten eine Gesamtsumme berechnen. Sie können eine Nachricht erstellen, die an den Systemadministrator gesendet wird, wenn die berechnete Summe den Höchstwert für das Gesamtsummenfeld übersteigt.
Der TryCatch-Knoten besitzt keine konfigurierbaren Eigenschaften, die sich auf diesen Vorgang auswirken. Sie legen seine Verarbeitung fest, indem Sie die Ausgabeterminals an nachfolgende Knoten im Nachrichtenfluss anschließen.
Wenn durch explizite Verwendung des Throw-Knotens oder durch die ESQL-Anweisung THROW oder dadurch, dass der Broker eine implizite Ausnahme auslöst, wenn er einen Fehler feststellt, den die Nachricht nicht bearbeiten kann, eine Ausnahmebedingung im Nachrichtenfluss ausgelöst wird, übernimmt der TryCatch-Knoten wieder die Kontrolle.
Die Nachricht wird über das Catch-Terminal weitergegeben, und die von Ihnen entwickelte Fehlerbehandlung wird ausgeführt. Die Nachricht, die über dieses Terminal weitergegeben wird, hat denselben Inhalt wie an der Stelle, an der die Ausnahme ausgelöst wurde, einschließlich der vollständigen Beschreibung der Ausnahme in der Ausnahmeliste.
Nachdem Sie eine Instanz des TryCatch-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt. Klicken Sie zum Anzeigen der Knoteneigenschaften im Eigenschaftendialog entweder doppelt auf den Knoten, oder klicken Sie mit der rechten Maustaste und anschließend auf Eigenschaften.
In der folgenden Tabelle werden die TryCatch-Knotenterminals beschrieben .
Terminal | Beschreibung |
---|---|
Eingangsterminal | Das Eingangsterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt |
Catch-Terminal | Das Ausgabeterminal, an das die Nachricht weitergegeben wird, wenn nachgeschaltet eine Ausnahmebedingung ausgegeben und von diesem Knoten abgefangen wurde. |
Try-Terminal | Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn sie nicht abgefangen wird. |
In der folgenden Tabelle werden die Knoteneigenschaften beschrieben. Die Spalte O zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte K zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).
In der folgenden Tabelle werden die Beschreibungseigenschaften des TryCatch-Knotens beschrieben.
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Knotenname | Nein | Nein | Der Knotentyp: TryCatch | Der Name des Knotens. |
Kurzbeschreibung | Nein | Nein | Kurze Beschreibung des Knotens | |
Ausführliche Beschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt |