Route-Knoten

Mit dem Route-Knoten können Sie Nachrichten, die bestimmten Kriterien entsprechen, entlang verschiedenen Pfaden eines Nachrichtenflusses steuern.

Dieses Thema enthält folgende Abschnitte:

Zweck

Beispiel: Sie müssen eine Nachricht auf Basis der Anforderungsdetails an mehrere Serviceprovider senden. Sie können auch den Route-Knoten zum Umgehen von unnötigen Schritten verwenden. Sie können beispielsweise überprüfen, ob bestimmte Daten in einer Nachricht vorhanden sind und nur für den Fall, dass Daten fehlen, einen Suchvorgang in der Datenbank ausführen. Wenn Sie die Eigenschaft Verteilungsmodus auf Alle setzen, können Sie mehrere Ereignisse auslösen, für die verschiedene Bedingungen erfüllt sein müssen. Beispielsweise können Sie Anforderungen protokollieren, die sich auf eine bestimmte Accountkennung beziehen und Anforderungen senden, die ein bestimmtes zu prüfendes Produkt betreffen.

Mit Hilfe von XPath-Filterausdrücken können Sie die Verarbeitung steuern. Das Ergebnis eines Filterausdrucks ist ein Boolescher Wert, d. h. das Ergebnis lautet entweder 'true' oder 'false'. Weitere Informationen zur Abfragesyntax von XPath 1.0 finden Sie im Abschnitt XPath.

Der Route-Knoten befindet sich im Ablagefach Routing der Nachrichtenflussknotenpalette und wird in Workbench durch folgendes Symbol dargestellt:

Symbol für Route-Knoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Anhand des Beispielprogramms Beispielprogramm 'Simplified Database Routing' wird die Verwendung dieses Knotens deutlich. Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker Toolkit integriert ist.

Der Route-Knoten verfügt über ein Eingabeterminal und mindestens drei Ausgabeterminals: 'Match', 'Default' und 'Failure'. Die Ausgabeterminals 'Default' und 'Failure' sind statisch und somit immer im Knoten vorhanden. Das dynamische Trefferterminal wird automatisch erstellt und zwar jedes Mal, wenn ein neuer Route-Knoten ausgewählt wird und im Nachrichtenflusseditor verwendet wird. Dieses Verhalten hat zur Folge, dass das erste dynamische Ausgabeterminal dieses Knotens nicht immer erstellt werden muss. Dieses Terminal muss mindestens vorhanden sein, damit der Knoten ausgeführt werden kann. Sie können den Namen für dieses dynamische Terminal ändern, wenn Sie den Namen 'Match' nicht für geeignet halten.

Wenn keine der Filterausdrücke zutreffen, wird eine Nachricht in das Terminal 'Default' kopiert. Wenn während der Filteroperation ein Fehler auftritt, wird die Nachricht an das Terminal 'Failure' weitergegeben. Im Route-Knoten können ein oder mehrere Ausgabeterminals definiert werden. Auf allen Terminals wird der zugehörige Filterausdruck für die Eingabenachricht verwendet. Wenn das Ergebnis den Wert TRUE hat, wird eine Kopie der Nachricht an das angegebene Terminal weitergeleitet. Der Route-Knoten legt die Reihenfolge fest, in der die Terminals angesprochen werden. Der Knoten leitet Nachrichten immer in der Reihenfolge an die Terminals weiter, in der sie in der Filtertabelle aufgeführt sind.

Die jeweiligen Filterausdrücke werden für die Eingabenachricht in der in der Filtertabelle angegebenen Reihenfolge angewendet. Wenn das Ergebnis den Wert TRUE hat, wird eine Kopie der Nachricht an das zugehörige dynamische Ausgabeterminal weitergeleitet. Wenn Sie die Eigenschaft Verteilungsmodus auf First (Erster) setzen, werden unter Umständen nicht alle Filterausdrücke angewendet.

Betrachten Sie folgende Beispieleingabenachricht:
<EmployeeRecord>
	<EmployeeNumber>00001</EmployeeNumber>
	<FamilyName>Smith</FamilyName>
	<Wage>20000</Wage>
</EmployeeRecord>
und die folgenden XPath-Filterausdrücke:
$Body/EmployeeRecord/EmployeeNumber="00002"|Match
$Body/EmployeeRecord/EmployeeNumber="00001"|out_exp2

In diesem Beispiel wurde die Eigenschaft Verteilungsmodus auf den Wert Erster gesetzt. Der Route-Knoten verarbeitet die XPath-Filterausdrücke für die Eingabenachricht in der Reihenfolge, in der sie aufgeführt sind. Da für die Eigenschaft Verteilungsmodus der Wert First (Erster) angegeben wurde, wird die Eingabenachricht nur einmal an das dynamische Ausgabeterminal weitergeleitet, das dem ersten Filterausdruck, der in den Wert TRUE aufgelöst wird, zugeordnet ist. Im vorherigen Beispiel hat der erste Filterausdruck, der dem Trefferterminal zugeordnet ist, den Wert FALSE, da in der Eingabenachricht eine andere Personalnummer als "00002" angegeben ist. Es wird also keine Nachricht an das Trefferterminal weitergeleitet. Der zweite Filterausdruck hat den Wert TRUE, so dass eine Kopie der Nachricht an das dynamische Terminal "out_expr2" gesendet wird. Wenn in der Eingabenachricht die Personalnummer "00003" angegeben wäre, die keinem Filterausdruck entspricht, würde die Nachricht an das statische Ausgabeterminal 'Default' gesendet. Wenn die Eigenschaft Verteilungsmodus auf Alle gesetzt wäre, wäre das Ergebnis dasselbe, da nur ein Filterausdruck in den Wert TRUE aufgelöst wurde.

Route-Knoten konfigurieren

Wenn Sie eine Instanz des Route-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren. Der Abschnitt Nachrichtenflussknoten konfigurieren enthält weitere Informationen hierzu. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.

Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.

Terminals

In der folgenden Tabelle werden die Terminals des Route-Knotens beschrieben.

Terminal Beschreibung
In Das statische Eingangsterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt.
Match Ein dynamisches Ausgabeterminal, an das die Originalnachricht bei erfolgreicher Verarbeitung weitergeleitet werden kann. Sie können weitere dynamische Terminals erstellen (siehe Dynamische Terminals).
Standardwert Das statische Ausgabeterminal, an das die Nachricht gesendet wird, wenn kein Filterausdruck den Wert TRUE ergibt.
Failure Das statische Ausgabeterminal, an das die Eingabenachricht gesendet wird, wenn während der Verarbeitung ein Fehler auftritt.

Dynamische Terminals

Der Route-Knoten kann über weitere dynamische Ausgabeterminals verfügen. Nicht alle dynamischen Ausgabeterminals, die in einem Route-Knoten erstellt werden, müssen einem Ausdruck in der Filtertabelle zugeordnet werden. An dynamische Ausgabeterminals, für die keine Zuordnung erfolgte, werden keine Nachrichten gesendet. Einem dynamischen Ausgabeterminal können mehrere Ausdrücke zugeordnet werden. Es gibt kein statisches Ausgabeterminal, an das die Nachricht direkt weitergeleitet wird. Weitere Informationen zur Verwendung dynamischer Terminals finden Sie im Abschnitt Dynamische Terminals verwenden.

Eigenschaften

In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte C 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 Route-Knotens beschrieben.
Eigenschaft M C Standardwert Beschreibung
Knotenname Nein Nein Der Knotentyp, Route 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.
In der folgenden Tabelle werden die grundlegenden Eigenschaften des Route-Knotens beschrieben.
Eigenschaft M C Standardwert Beschreibung
Filtertabelle Ja Nein   Eine Tabelle, deren Zeilen Ausdrücke und zugeordnete Terminalnamen sind, die die Wechselverarbeitung definieren, die von diesem Knoten im Anschluss an die Auswertung der jeweiligen Filterausdrücke ausgeführt wird. Der vollständige Ausdruck hat das Format
XPath-Filterausdruck, Terminalname
Alle XPath-Ausdrücke müssen mit $Root, $Body, $Properties, $LocalEnvironment, $DestinationList, $ExceptionList oder $Environment beginnen. Ausdrücke werden in der Reihenfolge ausgewertet, in der sie in der Tabelle aufgeführt sind. Geben Sie zur Steigerung des Durchsatzes die Ausdrücke, die am häufigsten zutreffen, oben in der Filtertabelle an. Normalerweise wird für jeden XPath-Ausdruck ein eindeutiger Terminalname angegeben.
Verteilungsmodus Nein Ja Alle Diese Eigenschaft bestimmt das Routingverhalten des Knotens, wenn eine eingehende Nachricht mit mehreren Filterausdrücken übereinstimmt. Wenn Sie die Eigenschaft Verteilungsmodus auf First (Erster) setzen, wird die Nachricht an das Ausgabeterminal weitergeleitet, das dem ersten Ausdruck in der Tabelle, der den Wert TRUE ergibt, zugeordnet ist. Wenn Sie diese Eigenschaft auf Alle setzen, wird die Nachricht an alle Ausgabeterminals weitergeleitet, die den Ausdrücken in der Tabelle, die den Wert TRUE ergeben, zugeordnet sind. Wenn es keine Übereinstimmung mit einem Ausgabeterminal gibt, wird die Nachricht an das Terminal 'Default' weitergeleitet.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac37370_