Mapping-Knoten

Mit dem Mapping-Knoten können Sie eine oder mehrere neue Nachrichten erstellen und diese mit verschiedenen Arten von Informationen füllen.

Dieses Kapitel enthält folgende Abschnitte:

Zweck

Sie können die neuen Nachrichten mit folgenden Informationsarten füllen:
  • Neue Informationen
  • Geänderte Informationen aus der Eingabenachricht
  • Informationen aus einer Datenbank
Sie können Elemente des Nachrichteninhalts, der verknüpften Umgebung und der Ausnahmeliste modifizieren.

Wenn Sie beim ersten Öffnen oder beim Erstellen einer Nachrichtenzuordnung für den Knoten die Option Diese Zuordnung wird von einem Nachrichtenflussknoten aufgerufen und ordnet Eigenschaften und den Hauptteil der Nachricht zu auswählen, werden die Header in der Eingabenachricht immer ohne Änderung in die Ausgabenachricht kopiert. Wenn Sie die Nachrichtenheader in einem Mapping-Knoten ändern möchten, wählen Sie die Option Diese Zuordnung wird von einem Nachrichtenflussknoten aufgerufen und ordnet Eigenschaften, Header und den Hauptteil der Nachricht zu aus. Bei Auswahl dieser Eigenschaft können über die erstellte Zuordnung zusätzliche Elemente (einschließlich WebSphere MQ-, HTTP- und JMS-Header) zugeordnet werden.

Diese Komponenten der Ausgabenachricht lassen sich unter Verwendung von Zuordnungen definieren, die auf Elementen der Eingabenachricht und auf Daten aus einer externen Datenbank basieren. Sie erstellen mit diesem Knoten verknüpfte Zuordnungen in der mit dem Knoten verknüpften Zuordnungsdatei, indem Sie Eingaben (Nachricht oder Datenbank) den Ausgaben zuordnen. Sie können die Zuordnungen dieser Verknüpfungen mithilfe integrierter oder benutzerdefinierter Funktionen und Prozeduren modifizieren. So haben Sie beispielsweise die Möglichkeit, einen Zeichenfolgewert in Großbuchstaben zu konvertieren, wenn Sie ihn dem Nachrichtenausgabefeld zuweisen.

Mit dem Mapping-Knoten können folgende Aktionen ausgeführt werden:

  • Neue Nachrichten erstellen
  • Nachrichten zwischen Parsern kopieren
  • Nachrichten von einem Format in ein anderes umwandeln

Der Mapping-Knoten befindet sich im Ablagefach Transformation der Palette und wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für Zuordnungsknoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Das folgende Beispiel zeigt, wie dieser Knoten verwendet wird:

Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Brokers Toolkit integriert ist.

Terminals und Eigenschaften

Nachdem Sie eine Instanz des Mapping-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt. Klicken Sie zum Anzeigen der Knoteneigenschaften im Eigenschaftendialog mit der rechten Maustaste und anschließend auf Eigenschaften. (Durch Doppelklicken auf den Mapping-Knoten wird das Dialogfenster Neue Nachrichtenzuordnung geöffnet.) Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.

In der folgenden Tabelle werden die Mapping-Knotenterminals 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 Berechnung ein Fehler auftritt. Wenn Sie die Option Warnungen als Fehler behandeln ausgewählt haben, gibt der Knoten die Nachricht auch dann an dieses Terminal weiter, wenn die Verarbeitung erfolgreich beendet wird.
Ausgabeterminal Das Ausgabeterminal, das die Nachricht nach Ausführung der Zuordnungen ausgibt.

In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte O zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte K 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 Mapping-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Knotenname Nein Nein Knotentyp 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 Mapping-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Datenquelle Nein Ja   Der Name der ODBC-Datenquelle für die Datenbank mit den Tabellen, auf die Sie in den mit diesem Knoten verknüpften Zuordnungen verweisen (wie unter der Eigenschaft Zuordnungsmodul festgelegt). Dieser Name gibt die entsprechende Datenbank auf dem System an, auf dem dieser Nachrichtenfluss ausgeführt werden soll. Der Broker stellt mit der Benutzer-ID und den Kennwortdaten, die Sie in den Befehlen mqsicreatebroker, mqsichangebroker oder mqsisetdbparms angegeben haben, eine Verbindung zu dieser Datenbank her.

z/OS platform Auf z/OS-Systemen verwendet der Broker die vom Broker gestartete Task-ID oder die Benutzer-ID und das Kennwort, die im angepassten Datensatz <hlq>.SBIPPROC im mqsisetdbparms-Befehl 'JCL, BIPSDBP' angegeben werden.

Transaktion Ja Nein Automatisch Der Transaktionsmodus für den Knoten. Folgende Werte stehen zur Verfügung:
  • Automatisch (Standardwert). Der Nachrichtenfluss, dessen Bestandteil der Mapping-Knoten ist, wird bei erfolgreicher Ausführung festgeschrieben; d. h., die Aktionen, die Sie in den Zuordnungen definieren, werden ausgeführt, und die Nachricht setzt ihren Weg durch den Nachrichtenfluss fort. Wenn der Nachrichtenfluss fehl schlägt, wird er zurückgesetzt. Wenn Sie die Option Automatisch auswählen, hängt die Fähigkeit, die Aktionen des Mapping-Knotens in der Datenbank festzuschreiben bzw. zurückzusetzen, vom Erfolg oder Scheitern des gesamten Nachrichtenflusses ab.
  • Festschreiben. Wenn alle nicht festgeschriebenen Aktionen, die in diesem Nachrichtenfluss in der mit diesem Knoten verbundenen Datenbank ausgeführt werden, unabhängig vom Erfolg oder Scheitern des gesamten Nachrichtenflusses festgeschrieben werden sollen, wählen Sie die Option Festschreiben aus. Die Datenbankänderungen werden festgeschrieben, selbst wenn der Nachrichtenfluss fehlschlägt.
Zuordnungsroutine Ja Nein Zuordnung Der Name der Zuordnungsroutine, die die Anweisungen enthält, die gegen die Datenbank oder Nachrichtenbaumstruktur ausgeführt werden sollen. 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_Mapping.msgmap für den ersten Mapping-Knoten im Nachrichtenfluss MFlow1). Sie können keinen Wert angeben, der Leerzeichen enthält.

Wenn Sie neben dem Eingabefeld auf Durchsuchen klicken, wird ein Dialogfenster 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, die mit diesem Knoten verknüpft ist, zu arbeiten, klicken Sie doppelt auf den Knoten, oder klicken Sie mit der rechten Maustaste auf den Knoten, und klicken Sie im Kontextmenü auf Zuordnungen öffnen. 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>.msgmap auch in der Brokerentwicklungsansicht öffnen.

Eine Zuordnungsroutine kann nur mit dem Knotentyp verwendet werden, mit dem sie verknüpft ist. Sie können eine für einen Mapping-Knoten entwickelte Zuordnungsroutine nicht mit einem anderen Knoten einsetzen, der Zuordnungen verwendet (z. B. einem DataInsert-Knoten). 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.

Weitere Informationen zum Arbeiten mit Zuordnungsdateien und Definieren ihres Inhalts erhalten Sie unter Nachrichtenzuordnungen entwickeln.

Zuordnungsmodus Ja Nein Nachricht Der Modus für die Verarbeitung von Informationen, die über den Mapping-Knoten weitergeleitet werden. Gültige Werte sind:
  • Nachricht (Standardeinstellung): Die Nachricht wird vom Mapping-Knoten wie im Knoten geändert generiert oder übergeben.
  • Lokale Umgebung: Die Nachrichtenbaumstruktur 'LocalEnvironment' wird vom Mapping-Knoten wie im Knoten geändert generiert oder übergeben.
  • Lokale Umgebung und Nachricht: Die Nachrichtenbaumstruktur 'LocalEnvironment' und die Nachricht werden vom Mapping-Knoten wie im Knoten geändert generiert oder übergeben.
  • Ausnahme: Die Ausnahmeliste wird vom Mapping-Knoten wie im Knoten geändert generiert oder übergeben.
  • Ausnahme und Nachricht: Die Nachrichtenbaumstruktur 'ExceptionList' und die Nachricht werden vom Mapping-Knoten wie im Knoten geändert generiert oder übergeben.
  • Ausnahme und Lokale Umgebung: Die Nachrichtenbaumstrukturen 'ExceptionList' und 'LocalEnvironment' werden vom Mapping-Knoten wie im Knoten geändert generiert oder übergeben.
  • Alle: Die Nachricht, Ausnahmeliste und lokale Umgebung werden vom Mapping-Knoten wie im Knoten geändert generiert oder übergeben.

Diese Eigenschaft muss festgelegt werden, damit das benötigte Format der Ausgabenachricht richtig wiedergegeben wird. Wenn Sie eine Option auswählen (oder den Standardwert übernehmen), die nicht eine bestimmte Komponente der Nachricht einschließt, wird diese Komponente in keiner Ausgabenachricht, die erstellt wird, eingeschlossen.

Sie können eine beliebige Kombination aus den Komponenten Nachricht, Lokale Umgebung und Ausnahmebedingung auswählen, die vom Mapping-Knoten generiert und modifiziert werden soll. Wenn Sie eine Zuordnung erstellen möchten, die mehrere Zielnachrichten weitergibt, legen Sie für diese Eigenschaft Lokale Umgebung und Nachricht fest, um sicherzustellen, dass der Knoten korrekt ausgeführt wird.

In einigen früheren Versionen wurde die lokale Umgebung (LocalEnvironment) als DestinationList (Zieladressenliste) bezeichnet; dies wird aus Kompatibilitätsgründen übernommen.

Die Moduseinstellung wirkt sich nicht auf die Umgebungskomponente der Nachrichtenbaumstruktur aus. Ihr Inhalt, falls vorhanden, wird von diesem Knoten aus übergeben.

Warnungen als Fehler behandeln Ja Nein Nicht ausgewählt Wenn Datenbankwarnungen als Fehler behandelt werden sollen und der Knoten die Ausgabenachricht an das Fehlerterminal weitergeben soll, aktivieren Sie Warnungen als Fehler behandeln. Das Kontrollkästchen ist zu Beginn inaktiviert.

Wenn Sie es aktivieren, behandelt der Knoten alle positiven Rückkehrcodes von der Datenbank als Fehler und generiert Ausnahmebedingungen auf dieselbe Art wie bei negativen oder schwer wiegenden Fehlern. Wenn Sie das Kontrollkästchen nicht aktivieren, behandelt der Knoten Warnungen als normale Rückkehrcodes und löst keine Ausnahmebedingungen aus. Die höchstwertige Warnung, die ausgegeben werden kann, lautet nicht gefunden. Sie kann in den meisten Fällen als normaler Rückkehrcode sicher bearbeitet werden.

Ausnahmebedingung für Datenbankfehler ausgeben Ja Nein Ausgewählt Wenn der Broker bei Erkennung eines Datenbankfehlers eine Ausnahmebedingung generieren soll, aktivieren Sie Ausnahme für Datenbankfehler ausgeben. Das Kontrollkästchen ist zu Beginn aktiviert. Wenn Sie das Kontrollkästchen inaktivieren, müssen Sie ihn im Nachrichtenfluss bearbeiten, um die Integrität des Brokers und der Datenbank zu gewährleisten. Wenn Sie den Fehler nicht über einen eigenen Prozess bearbeiten, wird er ignoriert, da Sie sich gegen den Aufruf der Standardfehlerbehandlung durch den Broker entschieden haben. Sie könnten beispielsweise das Fehlerterminal mit einer Fehlerbehandlungs-Subroutine verbinden.

In der folgenden Tabelle werden die Parser-Optionen für den Mapping-Knoten beschrieben.

Eigenschaft O K Standardwert Beschreibung
Zeitpunkt für Syntaxanalyse Nein Nein Bei Bedarf Durch diese Eigenschaft wird gesteuert, zu welchem Zeitpunkt eine Eingabenachricht syntaktisch analysiert wird. Gültige Werte sind Bei Bedarf, Sofort und Vollständig.

Eine vollständige Beschreibung dieser Eigenschaft finden Sie unter Bedarfsgerechte Syntaxanalyse.

Die Option Zeitpunkt für Syntaxanalyse ist standardmäßig auf Bei Bedarf gesetzt, d. h., die Überprüfung wird bis zur nächsten Teil-Syntaxanalyse verschoben. Wenn Sie den Wert für diese Option in Sofort ändern, wird die Teil-Syntaxanalyse außer Kraft gesetzt. In diesem Fall werden mit Ausnahme der komplexen Typen mit der Zusammensetzung 'Auswahl' oder 'Nachricht' alle Nachrichtenkomponenten syntaktisch analysiert und ausgewertet, die zu diesem Zeitpunkt nicht aufgelöst werden können. Wenn Sie diesen Wert in Vollständig ändern, wird die Teil-Syntaxanalyse außer Kraft gesetzt. In diesem Fall werden alle Nachrichtenkomponenten syntaktisch analysiert und ausgewertet; komplexe Typen mit der Zusammensetzung 'Auswahl' oder 'Nachricht', die zu diesem Zeitpunkt nicht aufgelöst werden können, verursachen einen Fehler bei der Gültigkeitsprüfung.

XMLNSC-Kompaktparser für XMLNS-Domäne verwenden Nein Nein Nicht ausgewählt Wenn Sie dieses Kontrollkästchen aktivieren, wird im MQRFH2-Header der ausgehenden Nachricht der Parser XMLNS statt des Parsers XMLNSC angegeben. Dies bedeutet, dass eine externe Anwendung nicht geändert werden muss. Wenn ausgehende Nachrichten keine MQRFH2-Header enthalten, hat diese Eigenschaft keine Auswirkungen.
Gemischten Inhalt beibehalten Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Feststellen von gemischtem Text in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für gemischten Text erstellt. Andernfalls wird gemischter Text ignoriert, und es werden keine Elemente erstellt.
Kommentare beibehalten Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Feststellen von Kommentaren in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Kommentare erstellt. Andernfalls werden Kommentare ignoriert, und es werden keine Elemente erstellt.
Verarbeitungsanweisung beibehalten Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Feststellen von Verarbeitungsanweisungen in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Verarbeitungsanweisungen erstellt. Andernfalls werden Verarbeitungsanweisungen ignoriert, und es werden keine Elemente erstellt.

In der folgenden Tabelle werden die Auswertungseigenschaften des Mapping-Knotens beschrieben.

Wenn eine Nachricht an das Fehlerterminal des Knotens übergeben wird, wird sie nicht ausgewertet. Diese Eigenschaften führen nicht dazu, dass die Eingabenachricht ausgewertet wird. Falls diese Auswertung erforderlich ist, wird davon ausgegangen, dass die Auswertung bereits durch den Empfangsknoten oder einen vorhergehenden Auswertungsknoten ausgeführt wurde. Weitere Informationen zur Auswertung von Nachrichten und Auswertungseigenschaften finden Sie unter Nachrichten überprüfen und Auswertungseigenschaften.

Eigenschaft O K Standardwert Beschreibung
Auswerten Nein Ja Keines Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt und Wert, Inhalt und Übernehmen.
Aktion bei Fehler Nein Nein Ausnahme Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Sie können diese Eigenschaft nur angegeben, wenn Sie 'Auswerten' auf Inhalt oder Inhalt und Wert gesetzt haben. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahmebedingung und Ausnahmeliste.
Alle Wertvorgaben einschließen Nein Nein Ausgewählt Diese Eigenschaft kann nicht bearbeitet werden. Wenn das Kontrollkästchen aktiviert ist (Standardeinstellung), werden alle Wertvorgaben in die Auswertung eingeschlossen.
Korrektur Nein Nein Keines Diese Eigenschaft kann nicht bearbeitet werden. Mindestkorrekturen werden zur Verfügung gestellt. Gültige Werte sind Keine und Vollständig.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:28:12

ac04720_