In IBM® Integration Bus wird eine
Relationship-Lookup-Transformation in einer Zuordnung manuell implementiert. Sie definieren und
konfigurieren einen FileRead-Knoten oder einen DatabaseRetrieve-Knoten, um die Daten in der Mitte
eines Nachrichtenflusses zu lesen.
In IBM Integration Bus implementieren Sie manuell einen
FileRead- oder DatabaseRetrieve-Knoten, um eine Umwandlung einer Relationship-Lookup-Transformation
durchzuführen. Optional können Sie einen Compute-Knoten verwenden, wenn keine Daten aus der Datei
oder Datenbanktabelle abgerufen werden. In WebSphere Enterprise Service Bus definieren
Sie eine Relationship-Lookup-Transformation als angepasste Transformation.
In
WebSphere Enterprise Service Bus führt eine Relationship-Lookup-Transformation eine
Beziehungsverwaltung zwischen statischen Daten mit Querverweisen durch. Die Quelle und das Ziel
einer Relationship-Lookup-Transformation müssen einfache Typen sein. Die Daten, die üblicherweise
mithilfe von Beziehungen umgesetzt werden, sind ID-Nummern (z. B. Auftrags-IDs oder Produkt-IDs)
und andere als Codes dargestellte Werte (z. B. Land, Währung oder Familienstand).
Führen Sie folgende Schritte manuell aus:
- Erstellen Sie eine durch Kommas getrennte Wertedatei oder eine Datenbanktabelle mit den
Werten, die Sie zum Füllen einer statischen Beziehung in WebSphere Enterprise Service Bus
verwenden.
- Wählen Sie einen der folgenden Nachrichtenflussknoten aus:
- Wählen Sie einen FileRead-Knoten aus, wenn Sie in Schritt 1 eine Datei erstellt haben. Der Abschnitt FileRead-Knoten enthält weitere Informationen hierzu.
- Wählen Sie einen DatabaseRetrieve-Knoten aus, wenn Sie in Schritt 1 eine Datenbanktabelle
erstellt haben. Der Abschnitt DatabaseRetrieve-Knoten enthält weitere Informationen hierzu.
Sie verwenden einen FileRead-Knoten, um Daten in der Mitte eines
Nachrichtenflusses aus einer Datei zu lesen. Der Abschnitt Ergebnisnachricht mit einer eingehenden Nachricht kombinieren enthält weitere Informationen hierzu.
Sie verwenden einen DatabaseRetrieve-Knoten, um eine Nachricht unter Verwendung von
Informationen aus einer Datenbank zu ändern. Der Abschnitt Zugriff auf Datenbanken über Nachrichtenflüsse enthält weitere Informationen hierzu.
- Fügen Sie per Drag-and-drop einen FileRead- oder DatabaseRetrieve-Knoten in den
Nachrichtenfluss ein.
- Konfigurieren Sie die Nachrichtenflussknoteneigenschaften.
- Konfigurieren Sie den FileRead-Knoten.
- Konfigurieren Sie die Eigenschaften für Datensätze und Elemente.
Diese Eigenschaften geben an, wie Datensätze in einer Datei identifiziert werden.
- Konfigurieren Sie die Eigenschaften für Ergebnis. Diese Eigenschaften
geben an, wie die Daten übergeben werden.
- Sie müssen die Eigenschaft Datensatzauswahlausdruck konfigurieren, um
den Ausdruck anzugeben, der zum Auswählen des richtigen Datensatzes aus der Datei verwendet werden
soll.
- Konfigurieren Sie den DatabaseRetrieve-Knoten:
- Konfigurieren Sie die Eigenschaften für Grundeinstellung. Diese
Eigenschaften definieren die Datenbanktabellenmerkmale.
- Konfigurieren Sie die Eigenschaften für Data element table
(Datenelementtabelle). Diese Eigenschaften definieren die Informationen zu den abzurufenden Daten.
- Sie müssen die Eigenschaft Data element (Datenelement) konfigurieren, um
den Ausdruck anzugeben, der zum Auswählen des richtigen Datensatzes aus der Datenbanktabelle
verwendet werden soll.
- Legen Sie fest, ob der FileRead- oder DatabaseRetrieve-Knoten vor oder hinter dem
Zuordnungsknoten benötigt wird.
- Wenn eine Lookup-Transformation aus einem eingehenden Element in der XML-Zuordnung
aufgerufen wird, verbinden Sie ein Ausgabeterminal eines FileRead- oder DatabaseRetrieve-Knotens
mit dem Eingangsterminal des Zuordnungsknotens oder dem
Eingangsterminal des Compute-Knotens.
- Verbinden Sie das Ausgangsterminal eines FileRead-Knotens, wenn die
Daten erfolgreich aus einer Datei abgerufen werden.
- Verbinden Sie das NoMatch-Terminal eines FileRead-Knotens mit dem
Eingangsterminal des Compute-Knotens, wenn die Datei nicht im Dateisystem
vorhanden ist oder sie zwar vorhanden ist, aber kein Datensatz gefunden werden kann, der dem
Filterausdruck entspricht. Verbinden Sie anschließend das Ausgangsterminal
des Compute-Knotens mit dem Eingangsterminal des Zuordnungsknotens.
- Verbinden Sie das Ausgangsterminal eines DatabaseRetrieve-Knotens, wenn
die Daten erfolgreich aus einer externen Ressource abgerufen werden.
- Verbinden Sie das KeyNotFound-Terminal eines DatabaseRetrieve-Knotens
mit dem Eingangsterminal des Compute-Knotens, wenn der Ergebnissatz leer
ist. Verbinden Sie anschließend das Ausgangsterminal des Compute-Knotens mit
dem Eingangsterminal des Zuordnungsknotens.
- Wenn eine Lookup-Transformation aus einem ausgehenden Element in der XML-Zuordnung
aufgerufen wird, verbinden Sie das Ausgangsterminal des Zuordnungsknotens
mit dem Eingangsterminal eines FileRead- oder DatabaseRetrieve-Knotens.
- Optional: Legen Sie mit einem Compute-Knoten den Ausgabewert fest, wenn für die bereitgestellte Eingabe
keine Ausgabe definiert ist. Wenn Sie den Wert der Eigenschaft com.ibm.wbit.mapping.xml.lookup.default
in WebSphere Enterprise Service Bus definiert haben, verwenden Sie diesen Wert. Setzen
Sie den Ausgabewert auf eine leere Zeichenfolge, wenn keine Eigenschaft definiert ist.
Weitere Schritte:
Klicken Sie in der Ansicht Conversion
results (Umwandlungsergebnisse) mit der rechten Maustaste auf die auszuführende
Task. Wählen Sie Complete (Beenden) aus.