WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

ResetContentDescriptor-Knoten

Mit dem ResetContentDescriptor-Knoten fordern Sie die Neuanalyse einer Nachricht durch einen anderen Parser an.

Dieses Thema ist in folgende Abschnitte eingeteilt:

Zweck

Der Knoten verknüpft die neuen Parser-Informationen mit dem Bitstrom der Eingabenachricht. Wenn die Nachricht bereits analysiert wurde, um eine Nachrichtenbaumstruktur zu erstellen, und der Inhalt des Baumes wurde geändert (z. B. von einem Compute-Knoten), muss der ResetContentDescriptor-Knoten den Bitstrom von der Nachrichtenbaumstruktur neu erstellen, indem er den aktuellen Parser aufruft.

Wenn Ihr Nachrichtenfluss die Nachricht vor ihrem Empfang am ResetContentDescriptor-Knoten aktualisiert hat, stellen Sie sicher, dass der geänderte Nachrichteninhalt auch noch für den aktuellen Parser gültig ist. Ist der Inhalt nicht gültig, generiert der Parser beim Versuch, den Bitstrom aus der Nachrichtenbaumstruktur heraus neu zu erstellen, einen Fehler, und der ResetContentDescriptor-Knoten löst eine Ausnahmebedingung aus. Wenn Sie beispielsweise einer Nachricht in der MRM-Domäne ein neues Feld hinzugefügt haben und dieses Feld nicht im Modell enthalten ist, schlägt die Neuerstellung des Bitstroms fehl.

Wenn Sie MRM als neuen Parser angeben, können Sie auch eine andere Nachrichtenschablone (Nachrichtengruppe, Nachrichtenart und Nachrichtenformat) angeben. Wenn Sie DFDL als neuen Parser angeben, können Sie auch eine andere Schemaposition und ein anderes Dokumentstammverzeichnis angeben. Dieser Knoten führt keine Neuanalyse der Nachricht durch. Stattdessen bestimmen die Eigenschaften, die Sie für diesen Knoten festgelegt haben, wie die Nachricht bei einer Neuanalyse vom Nachrichtenfluss analysiert wird.

Folgendes führt der ResetContentDescriptor-Knoten nicht aus:

  • Ändern des Nachrichteninhalts; er ändert Nachrichteneigenschaften, um anzugeben, wie der Bitstrom beim nächsten Starten des Parsers analysiert werden soll.
  • Konvertieren der Nachricht aus einem Format in ein anderes; wenn die eingehende Nachricht beispielsweise das Nachrichtenformat 'XML' hat und die ausgehende Nachricht das Nachrichtenformat 'binary', nimmt der ResetContentDescriptor-Knoten keine Neuformatierung vor. Er startet den Parser, um den Bitstrom der eingehenden XML-Nachricht neu zu erstellen, sodass die XML-Tags in der Nachricht erhalten bleiben. Bei einer erneuten Analyse der Nachricht durch einen nachfolgenden Knoten sind die XML-Tags ungültig und die Analyse schlägt fehl.

Der ResetContentDescriptor-Knoten befindet sich im Ablagefach Aufbau der Palette und wird im WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:

Symbol für den ResetContentDescriptor-Knoten

Diesen Knoten in einem Nachrichtenfluss verwenden

Stellen Sie sich als Beispiel für die Verwendung dieses Knotens vor, Sie möchten zwischen den BLOB- und MRM-Domänen umschalten. Das Format einer eingehenden Nachricht ist unter Umständen nicht bekannt, wenn sie in den Nachrichtenfluss eintritt. Daher wird der BLOB-Parser gestartet. Zu einem späteren Zeitpunkt in diesem Nachrichtenfluss möchten Sie eventuell, dass die Nachricht als Nachricht in der MRM-Domäne vordefiniert wird. Mit dem ResetContentDescriptor-Knoten können Sie den entsprechenden Wert festlegen, der bei der Analyse der Nachricht durch einen nachfolgenden Knoten im Nachrichtenfluss verwendet werden soll.

In der folgenden Tabelle werden die üblichen Eigenschaften des ResetContentDescriptor-Knotens aufgeführt.
Eigenschaft Wert
Nachrichtendomäne DFDL
Nachrichtendomäne zurücksetzen Ausgewählt
Nachrichtenmodell MyMessageModel
Nachrichtenmodell zurücksetzen Ausgewählt
Nachricht m_MESSAGE1
Nachricht zurücksetzen Ausgewählt
Physisches Format  
Physisches Format zurücksetzen Ausgewählt

Die Nachrichtendomäne wird auf DFDL gesetzt, und der DFDL-Parser wird bei der nächsten Analyse der Nachricht gestartet. Nachrichtenmodell und Nachricht sind die Nachrichtenschablonenwerte, die das Nachrichtenmodell definieren. Alle Kontrollkästchen zum Zurücksetzen sind aktiviert, da alle Eigenschaften geändert werden müssen. Der Wert für die Eigenschaft Nachrichtenmodell wird vorgegeben.

Der ResetContentDescriptor-Knoten weist den der eingehenden Nachricht zugeordneten BLOB-Parser an, den physischen Bitstrom der Nachricht (nicht deren logische Baumstrukturdarstellung) zu erstellen, der später an den MRM-Parser weitergeleitet wird. Der MRM-Parser analysiert dann den Bitstrom unter Verwendung der Nachrichtenschablone (Nachrichtengruppe, Nachrichtenart und Nachrichtenformat), die im ResetContentDescriptor-Knoten angegeben ist.

In Version 6.1 ist es nicht nötig, im Nachrichtenfluss hinter einem XSLTransform-Knoten einen ResetContentDescriptor-Knoten aufzunehmen, um Nachrichtendomäne, Nachrichtengruppe, Nachrichtentyp und Nachrichtenformat der vom XSLTransform-Knoten generierten Nachricht festzulegen. Der XSLTransform-Knoten führt diese Funktion aus.

ResetContentDescriptor-Knoten konfigurieren

Wenn Sie eine Instanz des ResetContentDescriptor-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren. Der Abschnitt Nachrichtenflussknoten konfigurieren enthält weitere Informationen hierzu. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.

Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Sternchen gekennzeichnet.

  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung, eine ausführliche Beschreibung oder beides ein. Sie können den Knoten dort auch umbenennen.
  2. Auf der Registerkarte Grundeinstellungen:
    1. Wenn einer Nachricht ein anderer Parser zugeordnet werden soll, müssen Sie die neue Domäne in der Eigenschaft Nachrichtendomäne angeben:
      • DFDL
      • XMLNSC
      • DataObject
      • JSON
      • BLOB
      • MIME
      • MRM
      • JMSMap
      • JMSStream
      • XMLNS

      Sie können bei Bedarf auch einen benutzerdefinierten Parser angeben.

      Außerdem müssen Sie das Kontrollkästchen Nachrichtendomäne zurücksetzen aktivieren.

      Wenn Sie die Eigenschaft Nachrichtendomäne frei lassen und das Kontrollkästchen Nachrichtendomäne zurücksetzen nicht aktivieren, wird die Domäne nicht zurückgesetzt. Wenn Sie die Eigenschaft Nachrichtendomäne frei lassen und das Kontrollkästchen Nachrichtendomäne zurücksetzen aktivieren, ist der Standardwert BLOB.

    2. Wenn der MRM-, XMLNSC- oder IDOC-Parser die Nachricht neu analysieren soll, geben Sie die anderen Eigenschaften des Modells an, die mit der Eingabenachricht verknüpft werden sollen, und aktivieren Sie neben jedem Feld das relevante Kontrollkästchen. Wenn Sie ein Rücksetzungskontrollkästchen für eine Eigenschaft aktivieren und keinen Wert für diese Eigenschaft angegeben haben, wird der Wert dieser Eigenschaft auf nicht belegt zurückgesetzt. Wenn Sie alternativ dazu einen Wert für diese Eigenschaft angegeben haben, ist die Eigenschaft belegt. Wenn Sie das Rücksetzungskontrollkästchen für eine Eigenschaft nicht auswählen, wird der Wert für diese Eigenschaft von der eingehenden Nachricht übernommen. Wenn der Parser bereits mit der Eingabenachricht verknüpft ist, geben Sie nur die Eigenschaften an, die sich ändern sollen.
      1. Definieren Sie das Nachrichtenmodell. Wählen Sie einen Wert aus der Liste der verfügbaren Nachrichtenmodelle aus (Name und ID des Nachrichtenmodells werden angezeigt) und aktivieren Sie das Kontrollkästchen Nachrichtenmodell zurücksetzen.
      2. MRM- und DFDL-Domänen: Definieren Sie den Namen der Nachricht in Nachricht. Geben Sie den Namen ein und aktivieren Sie das Kontrollkästchen Nachricht zurücksetzen.
      3. MRM und IDOC: Definieren Sie das physische Format. Mit dieser Eigenschaft wird das physische Format für den Parser festgelegt. Sie können eins der Formate aus der Liste mit den Namen der Formate, die Sie für das zuvor angegebene Nachrichtenmodell definiert haben, auswählen und Physisches Format zurücksetzen aktivieren.

      Diese Aktionen werden nur ausgeführt, wenn geeignete Header vorhanden sind. Weist die Nachricht keinen MQRFH2-Header auf, erstellt der Knoten auch keinen Header.

  3. Auf der untergeordneten Registerkarte Parser-Optionen:
    1. Die Option Zeitpunkt für Syntaxanalyse ist standardmäßig auf Bei Bedarf gesetzt. Dies führt dazu, dass die Syntaxanalyse der Nachricht verzögert wird.

      Nähere Informationen finden Sie unter Bedarfsgerechte Syntaxanalyse.

    2. Aktivieren Sie MQRFH2C-Kompaktparser für MQRFH2-Header verwenden, wenn der MQRFH2C-Parser verwendet werden soll. Dieses Kontrollkästchen ist standardmäßig inaktiviert, d. h., der Kompaktparser wird nicht verwendet.
    3. Wenn Sie den XMLNSC-Parser verwenden, legen Sie die Werte für die Eigenschaften fest, die bestimmen, wie der XMLNSC-Parser vorgeht. Weitere Informationen hierzu finden Sie im Abschnitt Nachrichten in der XMLNSC-Domäne bearbeiten.
  4. Legen Sie auf der Registerkarte Auswertung die Auswertungseigenschaften fest, wenn der Parser den Hauptteil von Nachrichten anhand der Nachrichtengruppe überprüfen soll. (Wenn eine Nachricht an das Fehlerterminal des Knotens übergeben wird, wird sie nicht ausgewertet.)

    Sie finden weitere Informationen hierzu in den Abschnitten Nachrichten überprüfen und Auswertungseigenschaften.

Terminals und Eigenschaften

In der folgenden Tabelle werden die ResetContentDescriptor-Knotenterminals beschrieben .

Terminal Beschreibung
Eingabeterminal (In) Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt
Fehlerterminal (Failure) Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn der Knoten einen Fehler feststellt.
Ausgang Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn die Eigenschaften einen neuen Parser identifizieren.

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 ResetContentDescriptor-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Knotenname Nein Nein Knotentyp Der Name des Knotens.
Kurzbeschreibung Nein Nein   Kurze Beschreibung des Knotens.
Langbeschreibung Nein Nein   Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt

In der folgenden Tabelle werden die Basiseigenschaften des ResetContentDescriptor-Knotens beschrieben.

In der folgenden Tabelle werden die grundlegenden Eigenschaften des ResetContentDescriptor-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Nachrichtendomäne Nein Nein BLOB (Binary large object) Die Nachrichtendomäne, die mit der Nachricht verknüpft ist, die neu analysiert werden soll.
Nachrichtendomäne zurücksetzen Ja Nein Nicht ausgewählt Wenn Sie das Rücksetzungskontrollkästchen aktivieren, wird die Eigenschaft Nachrichtendomäne zurückgesetzt. Wenn in diesem Fall keine Auswahl für die Eigenschaft Nachrichtendomäne erfolgt, wird für die Eigenschaft Nachrichtendomäne der Wert BLOB verwendet.
Nachrichtenmodell Nein Nein   Der Name oder die Position der Nachrichtenmodellschemadatei, in der die erneut zu analysierende Nachricht definiert ist. Diese Liste enthält alle verfügbaren Nachrichtenmodellschemadateien.
Nachrichtenmodell zurücksetzen Ja Nein Nicht ausgewählt Wenn Sie das Kontrollkästchen für die Zurücksetzung auswählen, wird die Eigenschaft Schemaposition zurückgesetzt. Wenn in diesem Fall keine Auswahl für die Eigenschaft Schemaposition erfolgt, ist die Eigenschaft Schemaposition nicht belegt.
Nachricht Nein Nein   Der Name bzw. die Position eines globalen Elements, das ein gesamtes Datendokument modelliert und in der Schemadatei des Nachrichtenmodells enthalten ist. Diese Liste wird mit allen verfügbaren Nachrichten gefüllt, die in dem von Ihnen ausgewählten Nachrichtenmodell definiert sind.
Nachricht zurücksetzen Ja Nein Nicht ausgewählt Wenn Sie das Kontrollkästchen für die Zurücksetzung auswählen, wird die Eigenschaft Dokumentstammverzeichnis zurückgesetzt. Wenn in diesem Fall keine Auswahl für die Eigenschaft Dokumentstammverzeichnis erfolgt, ist die Eigenschaft Dokumentstammverzeichnis nicht belegt.
Physisches Format Nein Nein   Es ist nicht erforderlich, das physische Format der erneut zu analysierenden Nachricht auszuwählen, wenn Sie die DFDL-Domäne verwenden. Das physische Format Ihrer Nachricht ist in der von Ihnen ausgewählten DFDL-Schemadatei definiert.
Physisches Format zurücksetzen Ja Nein Nicht ausgewählt Wenn Sie das Kontrollkästchen für die Zurücksetzung auswählen, wird die Eigenschaft Physisches Format zurückgesetzt. Wenn in diesem Fall keine Auswahl für die Eigenschaft Physisches Format erfolgt, ist die Eigenschaft Physisches Format nicht belegt.

In der folgenden Tabelle werden die Parser-Optionseigenschaften des ResetContentDescriptor-Knotens beschrieben.

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

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

MQRFH2C-Kompaktparser für MQRFH2-Header verwenden Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der MQRFH2C-Kompaktparser anstelle des MQRFH-Parsers für MQRFH2-Header verwendet wird.
Baumstruktur unter Verwendung von XML-Schemadatentypen erstellen Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser die Datentypen der in der Nachrichtenbaumstruktur erstellten Syntaxelemente aus dem XML-Schema entnimmt.Diese Eigenschaft kann nur ausgewählt werden, wenn für die Eigenschaft Auswerten auf der Registerkarte Auswertung Inhalt oder Inhalt und Wert festgelegt wurde.
XMLNSC-Kompaktparser für XMLNS-Domäne verwenden Nein Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Kompaktparser für Nachrichten in der XMLNS-Domäne verwendet wird. Wenn Sie diese Eigenschaft festlegen, werden die Nachrichtendaten in Knoten, die mit dem Ausgabeterminal verbunden sind, unter XMLNSC angezeigt, wenn es sich beim MQRFH2-Eingabeheader oder der Domäne um XMLNS handelt.
Zugriff auf gemischten Inhalt Nein Nein Nicht ausgewählt Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er gemischten Text in der erneut analysierten Nachricht feststellt. 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 Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er Kommentare in der erneut analysierten Nachricht feststellt. 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 Mit dieser Eigenschaft können Sie steuern, ob der XMLNSC-Parser Elemente in der Nachrichtenbaumstruktur erstellt, wenn er Verarbeitungsanweisungen in der erneut analysierten Nachricht feststellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Verarbeitungsanweisungen erstellt. Andernfalls werden Verarbeitungsanweisungen ignoriert, und es werden keine Elemente erstellt.
Nicht transparente Elemente Nein Nein Leer Mit dieser Eigenschaft können Sie eine Liste mit Elementen der erneut analysierten Nachricht angeben, die vom XMLNSC-Parser auf nicht transparente Weise analysiert werden sollen. Die nicht transparente Syntaxanalyse wird nur ausgeführt, wenn keine Gültigkeitsprüfung aktiviert ist (das heißt, wenn die Eigenschaft Auswerten auf Keine gesetzt ist); Einträge, die in Nicht transparente Elemente angegeben sind, werden ignoriert, wenn die Gültigkeitsprüfung aktiviert ist.

In der folgenden Tabelle werden die Auswertungseigenschaften des ResetContentDescriptor-Knotens beschrieben. Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Auswerten Nein Ja Keines Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt, Inhalt und Wert und Übernehmen. validateMaster
Fehlerbehebungsmaßnahme Nein Nein Ausnahme Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Sie können diese Eigenschaft nur angeben, wenn Sie Auswerten auf Inhalt und Wert oder auf Inhalt gesetzt haben. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahmebedingung und Ausnahmeliste.  
Die Überwachungseigenschaften des Knotens werden in der folgenden Tabelle beschrieben.
Eigenschaft O K Standardwert Beschreibung
Ereignisse Nein Nein Ohne Auf dieser Registerkarte werden Ereignisse angezeigt, die Sie für den Knoten definiert haben. Standardmäßig sind für keinen Knoten in einem Nachrichtenfluss Überwachungsereignisse definiert. Über Hinzufügen, Bearbeiten und Löschen können Sie Überwachungsereignisse für den Knoten erstellen, ändern oder löschen (Details siehe Überwachungsereignisquellen mithilfe von Überwachungseigenschaften konfigurieren).

Sie können hier angezeigte Ereignisse aktivieren oder inaktivieren, indem Sie das Kontrollkästchen Aktiviert aktivieren oder inaktivieren.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:19:55


ReferenzthemaReferenzthema | Version 8.0.0.5 | ac04810_