Knoten 'Deskriptor_für_Neuanalyse' (ResetContentDescriptor)

Dieses Kapitel enthält folgende Abschnitte:

Zweck

Mit dem Knoten 'Deskriptor_für_Neuanalyse' (ResetContentDescriptor) fordern Sie die Neuanalyse einer Nachricht durch einen anderen Parser an. Wenn dafür ein MRM-Parser verwendet wird, können Sie auch eine andere Nachrichtenschablone (Nachrichtengruppe, Nachrichtenart und Nachrichtenformat) angeben. Dieser Knoten führt keine Neuanalyse der Nachricht durch. Stattdessen bestimmen die Eigenschaften, die Sie für diesen Knoten eingerichtet haben, wie die Nachricht bei einer Neuanalyse vom Nachrichtenfluss analysiert wird.

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 der Baumstruktur geändert wurde (z. B. von einem Rechenknoten), muss der Knoten 'Deskriptor_für_Neuanalyse' den aktuellen Parser aufrufen, der mit der Nachricht verknüpft ist, um die Nachricht zu analysieren und den Bitstrom neu zu erstellen.

Wenn Ihr Nachrichtenfluss die Nachricht vor ihrem Empfang am Knoten 'Deskriptor_für_Neuanalyse' aktualisiert hat, müssen Sie sicherstellen, dass der geänderte Nachrichteninhalt auch noch für den aktuellen Parser gültig ist. Ist dies nicht der Fall, generiert der Parser beim Versuch, den Bitstrom aus der Nachrichtenbaumstruktur heraus neu zu erstellen, einen Fehler, und der Knoten 'Deskriptor_für_Neuanalyse' 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 angezeigt wird, schlägt die Neuerstellung des Bitstroms fehl.

Folgendes führt der Knoten 'Deskriptor_für_Neuanalyse' nicht aus:

  • Änderung des Nachrichteninhalts. Er ändert die Nachrichteneigenschaften, um anzugeben, wie der Bitstrom beim nächsten Aufrufen des Parsers analysiert werden soll.
  • Umwandlung der Nachricht von einem Format in ein anderes. Wenn die ankommende Nachricht beispielsweise das Nachrichtenformat 'XML' hat und die abgehende Nachricht das Nachrichtenformat 'CWF', nimmt der Knoten 'Deskriptor_für_Neuanalyse' keine Neuformatierung vor. Er ruft den Parser auf, um den Bitstrom der ankommenden XML-Nachricht neu zu erstellen, der die XML-Tags in der Nachricht behält. Wenn die Nachricht von einem nachfolgenden Knoten neu analysiert wird, werden die XML-Tags ungültig, und die Neuanalyse schlägt fehl.

Der Knoten 'Deskriptor_für_Neuanalyse' wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für Knoten 'Deskriptor_für_Neuanalyse'

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 ankommenden Nachricht ist unter Umständen nicht bekannt, wenn sie in den Nachrichtenfluss eintritt. Daher wird der BLOB-Parser aufgerufen. 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 Knoten 'Deskriptor_für_Neuanalyse' 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 Knotens 'Deskriptor_für_Neuanalyse' aufgeführt.

Eigenschaft Wert
Nachrichtendomäne MRM
Nachrichtendomäne zurücksetzen Ausgewählt
Nachrichtengruppe DH53CU406U001
Nachrichtengruppe zurücksetzen Ausgewählt
Nachrichtenart m_MESSAGE1
Nachrichtenart zurücksetzen Ausgewählt
Nachrichtenformat CWF
Nachrichtenformat zurücksetzen Ausgewählt

Die Nachrichtendomäne wird auf MRM gesetzt, und der MRM-Parser wird bei der nächsten Analyse der Nachricht aufgerufen. Die Nachrichtengruppe, Nachrichtenart und das Nachrichtenformat sind die Werte der Nachrichtenschablone, die das Nachrichtenmodell ausmachen. Alle Markierungsfeld zum Zurücksetzen sind aktiviert, da alle Eigenschaften geändert werden müssen.

Der Knoten 'Deskriptor_für_Neuanalyse' weist den der ankommenden Nachricht zugeordneten BLOB-Parser an, den physischen Bitstrom der Nachricht zu erstellen (nicht deren logische Baumstrukturdarstellung), 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 Knoten 'Deskriptor_für_Neuanalyse' angegeben ist.

Knoten 'Deskriptor_für_Neuanalyse' konfigurieren

Wenn Sie eine Instanz des Knotens 'Deskriptor_für_Neuanalyse' in einen Nachrichtenfluss eingereiht 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 Knoten 'Deskriptor_für_Neuanalyse' wie folgt:

  1. Wenn einer Nachricht ein anderer Parser zugeordnet werden soll, müssen Sie die neue Domäne unter Nachrichtendomäne angeben:
    • MRM
    • XML
    • JMSMap
    • JMSStream
    • MIME
    • BLOB

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

    Wählen Sie das Markierungsfeld Nachrichtendomäne zurücksetzen aus.

  2. Wenn der MRM-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 Markierungsfeld Zurücksetzen.... Wenn der MRM-Parser bereits mit der Eingabenachricht verknüpft ist, müssen Sie nur die Eigenschaften angeben, die sich ändern werden.
    1. Geben Sie unter Nachrichtengruppe die Nachrichtengruppe ein. Wählen Sie aus der Dropdown-Liste der verfügbaren Nachrichtengruppen (Name und ID der Nachrichtengruppe werden angezeigt) einen Wert aus.
    2. Geben Sie unter Nachrichtenart die Nachrichten-ID ein. Sie finden diese ID in den Eigenschaften der Nachricht, wenn Sie sie im Editor anzeigen. Die Nachrichten-ID haben Sie beim Erstellen der Nachricht angegeben. Sie müssen die ID genau wie in den Nachrichteneigenschaften gezeigt eingeben.
    3. Geben Sie unter Nachrichtenformat das Nachrichtenformat ein. Es legt das physische Format für den MRM-Parser fest. Sie können eines der Formate aus der Dropdown-Liste auswählen, in der die IDs der Formate aufgeführt sind, die Sie in der oben erwähnten Nachrichtengruppe definiert haben.

    Diese Eigenschaften legen Domäne, Gruppe, Art und Format für den Nachrichtenheader der Nachricht fest, die den Knoten 'Deskriptor_für_Neuanalyse' passieren soll. Dies geschieht jedoch nur, wenn bereits geeignete Header vorhanden sind. Weist die Nachricht keinen MQRFH2-Header auf, erstellt der Knoten auch keinen Header.

  3. Bei XML-, JMS-, MIME-, oder BLOB-Parsern erfolgt in den Feldern Nachrichtengruppe, Nachrichtenart und Nachrichtenformat keine Angabe.
  4. Wählen Sie im Eigenschaften-Dialognavigator die Option "Auswertung", wenn der MRM-Parser den Nachrichtenhauptteil gegen das von der Nachrichtengruppe generierte Wörterbuch prüfen soll. (Wenn eine Nachricht an das Fehlerterminal des Knotens übergeben wird, wird sie nicht ausgewertet.)

    Sie finden detaillierte Informationen hierzu unter Nachrichten überprüfen und Eigenschaften der Gültigkeitsprüfung für Nachrichten in der MRM-Domäne.

  5. Wählen Sie im Navigator des Eigenschaftendialogs die Option 'Beschreibung' aus, um ein kurze und/oder ausführliche Beschreibung einzugeben.
  6. Klicken Sie auf Übernehmen, um die Änderungen am Knoten 'Deskriptor_für_Neuanalyse' 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 Knotens 'Deskriptor_für_Neuanalyse' beschrieben.

Terminal Beschreibung
Eingangsterminal Das Eingangsterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt
Fehlerterminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn der Knoten einen Fehler feststellt.
Ausgangsterminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn die Eigenschaften einen neuen Parser identifizieren.

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 Knotens 'Deskriptor_für_Neuanalyse' beschrieben.

Eigenschaft M C Standard Beschreibung
Nachrichtendomäne Nein Nein   Die Nachrichtendomäne, die mit der Nachricht verknüpft ist, die neu analysiert werden soll.
Nachrichtendomäne zurücksetzen Ja Nein Nicht ausgewählt Gibt an, ob die Nachrichtendomäne zurückgesetzt werden soll. Wenn Sie das Markierungsfeld aktivieren, wird der Vorgang ausgeführt.
Nachrichtengruppe Nein Nein   Die Nachrichtengruppe, die mit der Nachricht verknüpft ist, die neu analysiert werden soll.
Nachrichtengruppe zurücksetzen Ja Nein Nicht ausgewählt Gibt an, ob die Nachrichtengruppe zurückgesetzt werden soll. Wenn Sie das Markierungsfeld aktivieren, wird der Vorgang ausgeführt.
Nachrichtenart Nein Nein   Die Nachrichtenart, die mit der Nachricht verknüpft ist, die neu analysiert werden soll.
Nachrichtenart zurücksetzen Ja Nein Nicht ausgewählt Gibt an, ob die Nachrichtenart zurückgesetzt werden soll. Wenn Sie das Markierungsfeld aktivieren, wird der Vorgang ausgeführt.
Nachrichtenformat Nein Nein   Das Nachrichtenformat, das mit der Nachricht verknüpft ist, die neu analysiert werden soll.
Nachrichtenformat zurücksetzen Ja Nein Nicht ausgewählt Gibt an, ob das Nachrichtenformat zurückgesetzt werden soll. Wenn Sie das Markierungsfeld aktivieren, wird der Vorgang ausgeführt.

In der nachfolgenden Tabelle werden die Auswertungseigenschaften des Knotens 'Deskriptor_für_Neuanalyse' beschrieben. Der Abschnitt Eigenschaften der Gültigkeitsprüfung für Nachrichten in der MRM-Domäne enthält eine ausführliche Beschreibung der Eigenschaften.

Eigenschaft M C Standard Beschreibung
Auswerten Ja Ja Keine Durchführung einer Auswertung. Gültige Werte sind Keine, Inhalt, Inhalt und Wert und Übernehmen.
Aktion bei Fehler Ja Nein Ausnahme Aktion beim Fehlschlagen einer Gültigkeitsprüfung. 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.
Alle Wertvorgaben einschließen Ja Nein Ausgewählt Diese Eigenschaft kann nicht bearbeitet werden. Die Standardaktion (ausgewähltes Kontrollkästchen) besteht darin, dass in der Auswertung von Inhalt und Wert auch Basisprüfungen der Wertvorgaben ausgeführt werden.
Korrektur Ja Nein Keine Diese Eigenschaft kann nicht bearbeitet werden. Gültige Werte sind Keine und Vollständig.

In der nachfolgenden Tabelle werden die Eigenschaften der allgemeinen Nachrichtenoptionen des Knotens 'Deskriptor_für_Neuanalyse' beschrieben.

Eigenschaft M C Standard Beschreibung
Zeitpunkt für Syntaxanalyse Ja 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.

Der Abschnitt Bedarfsgerechte Syntaxanalyse enthält eine ausführliche Beschreibung dieser Eigenschaft.

MQRFH2C Compact Parser für MQRFH2-Domäne verwenden Nein Nein False (falsch) Durch diese Eigenschaft wird gesteuert, ob der MQRFH2C Compact Parser anstelle des MQRFH2-Parsers für MQRFH2-Header verwendet wird.

In der nachfolgenden Tabelle werden die XMLNSC-Parseroptionen für den Knoten 'Deskriptor_für_Neuanalyse' beschrieben.

Eigenschaft M C Standard Beschreibung
XMLNSC Compact Parser für XMLNS-Domäne verwenden Ja Nicht ausgewählt Nein Beginn der ÄnderungDurch diese Eigenschaft können Sie steuern, ob der XMLNSC-Kompaktparser für Nachrichten in der XMLNS-Domäne verwendet wird. Wenn Sie diese Eigenschaft festlegen, werden die Nachrichtendaten unter XMLNSC in Knoten angezeigt, die mit dem Ausgabeterminal verbunden sind, wenn der RFH2-Eingabeheader oder die Standardeigenschaftendomäne XMLNS ist.Ende der Änderung
Residenter Modus für gemischten Inhalt Ja Nein Keine Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Feststellen von gemischtem Text in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Gültige Werte sind Keine und Alle. Durch die Auswahl von Alle werden Elemente für gemischte Texte erstellt. Durch die Auswahl von Keine werden gemischte Texte ignoriert und keine Elemente erstellt.
Residenter Modus für Kommentare Ja Nein Keine Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Feststellen von Kommentaren in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Gültige Werte sind Keine und Alle. Durch die Auswahl von Alle werden Elemente für Kommentare erstellt. Durch die Auswahl von Keine werden Kommentare ignoriert und keine Elemente erstellt.
Residenter Modus für Verarbeitungsanweisungen Ja Nein Keine Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Feststellen von Verarbeitungsanweisungen in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Gültige Werte sind Keine und Alle. Durch die Auswahl von Alle werden Elemente für Verarbeitungsanweisungen erstellt. Durch die Auswahl von Keine werden Verarbeitungsanweisungen ignoriert und keine Elemente erstellt.

In der nachfolgenden Tabelle werden die Beschreibungseigenschaften des Knotens 'Deskriptor_für_Neuanalyse' 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
ac04810_