Mit dem ResetContentDescriptor-Knoten fordern Sie die Neuanalyse einer Nachricht durch einen anderen Parser an.
Dieses Kapitel enthält folgende Abschnitte:
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 Rechen-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. 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:
Der ResetContentDescriptor-Knoten befindet sich im Ablagefach Aufbau der Palette und wird im WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:
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.
| Eigenschaft | Wert |
|---|---|
| Nachrichtendomäne | MRM |
| Nachrichtendomäne zurücksetzen | Ausgewählt |
| Nachrichtengruppe | MyMessageSet |
| Nachrichtengruppe zurücksetzen | Ausgewählt |
| Nachrichtentyp | m_MESSAGE1 |
| Nachrichtentyp zurücksetzen | Ausgewählt |
| Nachrichtenformat | Text1 |
| Nachrichtenformat zurücksetzen | Ausgewählt |
Die Nachrichtendomäne wird auf MRM gesetzt, und der MRM-Parser wird bei der nächsten Analyse der Nachricht gestartet. Die Nachrichtengruppe, die Nachrichtenart und das Nachrichtenformat sind die Werte der Nachrichtenschablone, die das Nachrichtenmodell ausmachen. Alle Kontrollkästchen zum Zurücksetzen sind aktiviert, da alle Eigenschaften geändert werden müssen.
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.
Wenn Sie eine Instanz des ResetContentDescriptor-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren. Der Abschnitt 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.
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.
Diese Aktionen werden nur ausgeführt, wenn geeignete Header vorhanden sind. Weist die Nachricht keinen MQRFH2-Header auf, erstellt der Knoten auch keinen Header.
Nähere Informationen finden Sie unter Bedarfsgerechte Syntaxanalyse.
Sie finden weitere Informationen hierzu in den Abschnitten Nachrichten überprüfen und Auswertungseigenschaften.
In der folgenden Tabelle werden die ResetContentDescriptor-Knotenterminals 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 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 | |
| Ausführliche Beschreibung | 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. |
| Nachrichtengruppe | Nein | Nein | Die Nachrichtengruppe, die mit der Nachricht verknüpft ist, die neu analysiert werden soll. Wenn Sie diese Eigenschaft festlegen und die Projektabhängigkeiten später aktualisieren, um diesen Nachrichtengruppenverweis zu entfernen, wird eine Warnung ausgegeben. Aktualisieren Sie entweder die Eigenschaft Nachrichtengruppe, oder stellen Sie den Verweis auf dieses Nachrichtengruppenprojekt wieder her. |
|
| Nachrichtengruppe zurücksetzen | Ja | Nein | Nicht ausgewählt | Wenn Sie das Rücksetzungskontrollkästchen aktivieren, wird die Eigenschaft Nachrichtengruppe zurückgesetzt. Wenn in diesem Fall keine Auswahl für die Eigenschaft Nachrichtengruppe erfolgt, ist die Eigenschaft Nachrichtengruppe nicht belegt. |
| Nachrichtentyp | Nein | Nein | Der Nachrichtentyp, der mit der Nachricht verknüpft ist, die neu analysiert werden soll. | |
| Nachrichtentyp zurücksetzen | Ja | Nein | Nicht ausgewählt | Wenn Sie das Rücksetzungskontrollkästchen aktivieren, wird die Eigenschaft Nachrichtentyp zurückgesetzt. Wenn in diesem Fall keine Auswahl für die Eigenschaft Nachrichtentyp erfolgt, ist die Eigenschaft Nachrichtentyp nicht belegt. |
| Nachrichtenformat | Nein | Nein | Das Nachrichtenformat, das mit der Nachricht verknüpft ist, die neu analysiert werden soll. Wenn Sie die Eigenschaft Nachrichtendomäne auf DataObject setzen, können Sie diese Eigenschaft auf XML oder SAP ALE IDoc setzen. Setzen Sie diese Eigenschaft auf SAP ALE IDoc, wenn Sie einen Bitstrom auf Basis einer externen Quelle analysieren und eine Nachrichtenbaumstruktur generieren müssen. | |
| Nachrichtenformat zurücksetzen | Ja | Nein | Nicht ausgewählt | Wenn Sie das Rücksetzungskontrollkästchen aktivieren, wird die Eigenschaft Nachrichtenformat zurückgesetzt. Wenn in diesem Fall keine Auswahl für die Eigenschaft Nachrichtenformat erfolgt, ist die Eigenschaft Nachrichtenformat 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 Syntaxelemente in der Nachrichtenbaumstruktur mit Datentypen erstellt, die vom XML-Schema genommen wurden. Diese Eigenschaft kann nur ausgewählt werden, wenn die Eigenschaft Auswerten in der Registerkarte Auswerten auf Inhalt oder Inhalt und Wert gesetzt wird. |
| 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 | - | 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. |
| Eigenschaft | O | K | Standard | Beschreibung |
|---|---|---|---|---|
| Ereignisse | Nein | Nein | None (Keinen) | 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. |