In IBM® Integration
Bus können Sie einen FileRead-Knoten, einen JavaCompute-Knoten, einen Datenbankknoten oder einen DatabaseRetrieve-Knoten manuell implementieren, um eine in einer WebSphere Enterprise
Service Bus-Zuordnung definierte Transformation des Typs 'Relationship Lookup' erneut zu erstellen. Werden keine Daten aus der Datei oder Datenbanktabelle abgerufen, können Sie auch einen Rechenknoten oder einen JavaCompute-Knoten verwenden. Anschließend wird einer dieser Knoten mit dem Zuordnungsknoten verbunden, der die Datentransformation durchführt.
Vorbereitungen:
Stellen Sie fest, ob für die Verwendung von Nachrichtenflussknoten für Ihre IBM Integration
Bus-Version irgendwelche Einschränkungen vorliegen. Der Abschnitt Einschränkungen, die in jedem Betriebsmodus gelten enthält weitere
Informationen hierzu.
In WebSphere Enterprise
Service Bus definieren
Sie eine Relationship-Lookup-Transformation als angepasste Transformation. Eine Transformation des Typs 'Relationship
Lookup' verwendet bei der Ausführung die Beziehung zwischen statischen Daten mit Querverweisen. Die Quelle und das Ziel
einer Relationship-Lookup-Transformation müssen einfache Typen sein. Bei den Daten, die in der Regel unter Verwendung von Beziehungen umgesetzt werden, handelt es sich um IDs (beispielsweise Auftrags- oder Produkt-IDs) und andere Werte, die in Form von Codes dargestellt werden (beispielsweise Land, Währung oder Familienstand).
Das WebSphere ESB-Konvertierungstool erstellt eine Platzhalter-Task in der Zuordnung, in der es eine Transformation des Typs 'Relationship Lookup' vorfindet.
So erstellen Sie in IBM Integration
Bus eine Transformation des Typs 'Relationship Lookup' erneut:
- 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:
- Wenn Sie in Schritt 1 eine Datei erstellt haben, wählen Sie einen FileRead-Knoten aus. Der Abschnitt FileRead-Knoten enthält
weitere Informationen hierzu.
- Wenn Sie in Schritt 1 eine Datei erstellt haben, wählen Sie einen JavaCompute-Knoten aus. Der Abschnitt JavaCompute-Knoten-Knoten enthält weitere Informationen hierzu.
- Wenn Sie in Schritt 1 eine Datenbanktabelle erstellt haben, wählen Sie einen Datenbankknoten aus. Der Abschnitt Datenbankknoten-Knoten enthält weitere
Informationen hierzu.
- Wenn Sie in Schritt 1 eine Datenbanktabelle erstellt haben, wählen Sie einen DatabaseRetrieve-Knoten aus. Der Abschnitt DatabaseRetrieve-Knoten-Knoten enthält weitere Informationen hierzu.
Mit einem FileRead-Knoten oder einem JavaCompute-Knoten können Daten mitten im Nachrichtenfluss aus einer Datei ausgelesen. Der Abschnitt Ergebnisnachricht mit einer eingehenden Nachricht kombinieren enthält weitere Informationen hierzu.
Mit einem Datenbankknoten oder einem DatabaseRetrieve-Knoten kann eine Nachricht unter Verwendung von Informationen aus einer Datenbank geändert werden. Der Abschnitt Zugriff auf Datenbanken über Nachrichtenflüsse enthält weitere Informationen hierzu.
- Fügen Sie über Drag-and-drop einen der oben erwähnten Knoten in den Nachrichtenfluss ein.
- Konfigurieren Sie die Nachrichtenflussknoteneigenschaften.
- Konfigurieren Sie den FileRead-Knoten-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 im JavaCompute-Knoten die Eigenschaft Java-Klasse. Diese Eigenschaft gibt den Namen der Java-Klasse an, die verwendet wird.
- Konfigurieren Sie den DatabaseRetrieve-Knoten-Knoten:
- Konfigurieren Sie die Eigenschaften für Grundeinstellung. Diese
Eigenschaften definieren die Datenbanktabellenmerkmale.
- Konfigurieren Sie die Eigenschaften für Tabelle für Datenelement.
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.
- Konfigurieren Sie die Datenbankknoteneigenschaften für die Grundeinstellung.
Diese
Eigenschaften definieren die Datenbanktabellenmerkmale.
- Geben Sie über die Eigenschaft Anweisung den Ausdruck an, mit dem der richtige Datensatz aus der Datenbanktabelle ausgewählt werden soll.
- Geben Sie über die Eigenschaft Datenquelle die Datenbank an, die die Tabellen enthält.
- Stellen Sie fest, ob der in Schritt 2 ausgewählte Knoten vor oder hinter dem Zuordnungsknoten eingefügt werden muss.
- Beim Aufruf einer Transformation des Typs 'Lookup' aus einem eingehenden Element in der XML-Zuordnung wird ein Ausgangsterminal des in Schritt 2 ausgewählten Knotens mit dem Eingangsterminal des Zuordnungsknotens oder dem Eingangsterminal eines Rechenknotens verbunden.
- Beim Aufruf einer Transformation des Typs 'Lookup' aus einem abgehenden Element in der XML-Zuordnung wird das Ausgangsterminal des Zuordnungsknotens mit dem Eingangsterminal des in Schritt 2 ausgewählten Knotens verbunden.
- Optional: Wenn der in Schritt 2 ausgewählte Knoten vor dem Zuordnungsknoten benötigt wird, führen Sie die folgenden Schritte aus:
- Verbinden Sie das Ausgangsterminal eines FileRead-Knotens oder eines JavaCompute-Knotens, wenn die Daten erfolgreich aus einer Datei abgerufen werden können.
- Verbinden Sie das NoMatch-Terminal eines FileRead-Knotens oder das Alternative Terminal eines JavaCompute-Knotens mit dem Eingangsterminal des Rechenknotens, wenn die Datei im Dateisystem nicht vorhanden ist oder zwar vorhanden ist, aber keine Datensätze gefunden werden, die dem Filterausdruck entsprechen.
- Verbinden Sie das Ausgangsterminal eines DatabaseRetrieve-Knotens oder eines Datenbankknotens, wenn die Daten erfolgreich aus einer externen Ressource abgerufen werden können.
- Verbinden Sie das KeyNotFound-Terminal eines DatabaseRetrieve-Knotens mit dem Eingangsterminal eines Rechenknotens, wenn die Ergebnisliste leer ist.
- Optional: Gehen Sie in einem Szenario, in dem der Ausgabewert leer oder nicht definiert ist, wie folgt vor:
- Definieren Sie den Ausgabewert.
- Wenn Sie für die Eigenschaft com.ibm.wbit.mapping.xml.lookup.default in WebSphere Enterprise
Service Bus einen Wert angegeben haben, geben Sie diesen Wert als Ausgabewert an.
- Ist keine Eigenschaft definiert, geben Sie für den Ausgabewert eine leere Zeichenfolge an.
- Fügen Sie einen Rechenknoten oder JavaCompute-Knoten über Drag-and-drop in den Nachrichtenfluss ein.
- Beim Aufruf einer Transformation des Typs 'Lookup' aus einem eingehenden Element in der XML-Zuordnung wird das Ausgangsterminal des Rechenknotens oder des JavaCompute-Knotens mit dem Eingangsterminal des Zuordnungsknotens verbunden.
- Beim Aufruf einer Transformation des Typs 'Lookup' aus einem abgehenden Element in der XML-Zuordnung wird das Ausgangsterminal des Zuordnungsknotens mit dem Eingangsterminal des Rechenknotens oder des JavaCompute-Knotens verbunden.
Weitere Schritte:
- Löschen Sie in Ihrer Zuordnung die Platzhalter-Task, indem Sie mit der rechten Maustaste auf Task klicken und anschließend Löschen auswählen.
- Klicken Sie in der Ansicht Ergebnisse prüfen mit der rechten Maustaste auf die unerledigte Task. Wählen Sie Complete (Beenden) aus.