Extraktionsknoten (Extract)

Dieses Kapitel enthält folgende Abschnitte:

Zweck

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:

Symbol für Extraktionsknoten

Diesen Knoten in einem Nachrichtenfluss verwenden

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.

Extraktionsknoten konfigurieren

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:

  1. Geben Sie unter Zuordnungsmodul die verknüpfte Zuordnungsroutine an, die in diesem Knoten ausgeführt werden soll. Standardmäßig ist der Name der Zuordnungsroutine identisch mit dem Namen der Abgleichungsdatei, in der die Routine definiert ist. Der Standardname der Datei ist der Name des Nachrichtenflusses, der mit dem Knotennamen verknüpft wird, wenn Sie ihn in den Nachrichtenfluss einschließen (z. B. MFlow1_Extract.mfmap für den ersten Extraktionsknoten im Nachrichtenfluss MFlow1). Sie können keinen Wert angeben, der Leerzeichen enthält.

    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.

  2. Wählen Sie im Navigator des Eigenschaftendialogs die Option 'Beschreibung' aus, um ein kurze und/oder ausführliche Beschreibung einzugeben.
  3. Klicken Sie auf Übernehmen, um die Änderungen am Extraktionsknoten vorzunehmen, ohne das Dialogfeld mit den Eigenschaften zu schließen. Klicken Sie auf OK, um die Änderungen zu übernehmen und das Dialogfeld mit den Eigenschaften zu schließen.

    Klicken Sie auf Abbrechen, um das Dialogfeld zu schließen und alle Änderungen zu verwerfen, die Sie an den Eigenschaften vorgenommen haben.

Terminals und Eigenschaften

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
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
ac04710_