Dieses Kapitel enthält folgende Abschnitte:
Mit dem Extraktionsknoten können Sie den Inhalt der Eingabenachricht extrahieren, der von im Nachrichtenfluss nachgeschalteten Knoten verarbeitet werden soll. Dabei kann eine neue Ausgabedatei erstellt werden, die nur einen Teil der Inhalte der Eingabenachricht enthält. Die Ausgabenachricht enthält nur die Elemente der Eingabenachricht, die gemäß Ihren Angaben beim Konfigurieren des Extraktionsknotens durch die Definition von Zuordnungsanweisungen eingeschlossen werden sollen.
Der Extraktionsknoten wird in der Workbench durch folgendes Symbol dargestellt:
Dieser Knoten ist hilfreich, wenn Sie nach der ersten Verarbeitung der gesamten Nachricht nur einen Teil einer Nachricht benötigen. Beispiel: Sie möchten die gesamte Nachricht zu Prüfzwecken speichern (im Warehouseknoten), aber nur einen kleinen Teil der Nachricht (z. B. Bestellinformationen) zur Weiterverarbeitung weitergeben.
Sie erhalten die Aufträge von Neukunden und möchten deren Namen und Adressen für zukünftige Werbeaktionen sammeln. Mit Hilfe des Extraktionsknotens entnehmen Sie diese Informationen aus jeder Bestellung und senden sie als neue Nachricht an die Hauptstelle. Dort werden diese Nachrichten verarbeitet, so dass die Kundendetails bei der nächsten Marketingkampagne verwendet werden können.
Wenn Sie eine Instanz des Extraktionsknotens in einen Nachrichtenfluss gestellt haben, können Sie ihn konfigurieren. Klicken Sie mit der rechten Maustaste in der Editoransicht auf den Knoten, und wählen Sie die Option Eigenschaften aus. Daraufhin werden die grundlegenden Eigenschaften des Knotens angezeigt.
Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind dort mit einem Sternchen gekennzeichnet.
Konfigurieren Sie den Extraktionsknoten wie folgt:
Wenn Sie neben dem Eingabefeld auf Durchsuchen klicken, wird ein Dialogfeld mit allen verfügbaren Zuordnungsroutinen angezeigt, auf die dieser Knoten zugreifen kann. Wählen Sie die gewünschte Routine aus, und klicken Sie auf OK. Der Name der Routine wird unter Zuordnungsmodul angegeben.
Um mit der Zuordnungsroutine zu arbeiten, die mit diesem Knoten verknüpft ist, klicken Sie mit der rechten Maustaste auf den Knoten, und wählen Sie im Kontextmenü die Option Zuordnungen öffnen aus. Wenn die Zuordnungsroutine nicht existiert, wird sie für Sie mit dem Standardnamen in der Standarddatei erstellt. Wenn die Datei bereits existiert, können Sie die Datei <Nachrichtenflussname>_<Knotenname>.mfmap auch in der Navigatoransicht öffnen.
Eine Zuordnungsroutine kann nur mit dem Knotentyp verwendet werden, mit dem sie verknüpft ist. Sie können eine für einen Extraktionsknoten entwickelte Zuordnungsroutine nicht mit einem anderem Knoten einsetzen, der Zuordnungen verwendet (z. B. einem Dateneinfügeknoten). Wenn Sie eine Zuordnungsroutine erstellen, können Sie sie nicht aus einer anderen Zuordnungsroutine heraus aufrufen, obwohl sie aus einer ESQL-Routine heraus aufgerufen werden kann.
Klicken Sie auf Abbrechen, um das Dialogfeld zu schließen und alle Änderungen zu verwerfen, die Sie an den Eigenschaften vorgenommen haben.
In der nachfolgenden Tabelle werden die Terminals des Extraktionsknotens beschrieben.
Terminal | Beschreibung |
---|---|
Eingangsterminal | Das Eingangsterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt |
Fehlerterminal | Das Ausgabeterminal, an das die Eingabenachricht geleitet wird, wenn während der Extraktion ein Fehler auftritt. |
Ausgangsterminal | Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn die Eingabenachricht erfolgreich verarbeitet wird. |
In der nachfolgenden Tabelle werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen im Eigenschaftendialog, ob Sie einen Wert eingeben müssen, wenn kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Sie können den Wert ändern, wenn Sie der BAR-Datei den Nachrichtenfluss hinzufügen, um ihn einzusetzen).
In der nachfolgenden Tabelle werden die grundlegenden Eigenschaften des Extraktionsknotens beschrieben.
Eigenschaft | M | C | Standard | Beschreibung |
---|---|---|---|---|
Zuordnungsmodul | Ja | Nein | Extract | Der Name der Zuordnungsroutine, die die Anweisungen enthält, die gegen die Nachrichtenbaumstruktur ausgeführt werden sollen. Die Routine ist eindeutig und kann nur mit diesem Knotentyp verwendet werden. |
In der nachfolgenden Tabelle werden die Beschreibungseigenschaften des Extraktionsknotens beschrieben.
Eigenschaft | M | C | Standard | Beschreibung |
---|---|---|---|---|
Kurzbeschreibung | Nein | Nein | Kurze Beschreibung des Knotens | |
Ausführliche Beschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt |