Nachrichtengruppen haben Eigenschaften, mit denen Sie deren Kenndaten und die Art, in der sie verarbeitet werden, definieren können.
In der nachfolgenden Tabelle werden die Eigenschaften erläutert, mit denen Sie die Nachrichtengruppe anpassen können.
Eigenschaft | Typ | Bedeutung |
---|---|---|
Standardmäßige Nachrichtendomäne und unterstützte Nachrichtendomänen | Zeichenfolge und Kontrollkästchen | Der Name des Nachrichten-Parsers muss mit der Eigenschaft Nachrichtendomäne eines Empfangsknotens identisch sein, der Nachrichten aus der Nachrichtengruppe verarbeitet oder dem <Msd>>-Elementwert eines MQRFH2-Headers entsprechen, der einer Nachricht aus der Nachrichtengruppe vorangestellt wurde. Wählen Sie einen Wert aus der für die Eigenschaft Standardmäßige Nachrichtendomäne angebotenen Liste aus, und aktivieren Sie die Kontrollkästchen unter Unterstützte Nachrichtendomänen, um weitere Domänen auszuwählen. Sie können beliebig viele Kontrollkästchen aktivieren. Verwenden Sie den Namen des Nachrichten-Parsers, wenn Sie ESQL-Feldverweise auf Nachrichten in der Nachrichtengruppe, beispielsweise InputRoot.MRM.Document, schreiben. Der Zuordnungseditor und die Inhaltsunterstützungsfunktion des ESQL-Editors verwenden beim Generieren des ESQL-Feldverweises den Namen des Nachrichtenparsers. Folgende Namen stehen zur Auswahl:
|
Namespaces verwenden | Kontrollkästchen | Wählen Sie diese Eigenschaft, wenn Sie Namespaces in der Nachrichtengruppe verwenden möchten. Namespaces helfen, Namenskonflikte zu vermeiden, wenn verschiedene Dokumentdefinitionen Elemente mit identischen Namen besitzen. Weitere Informationen finden Sie unter
Namespaces. Dieses Kontrollkästchen ist standardmäßig aktiviert. Die Verwendung von Namespaces wirkt sich auch darauf aus, wie Elemente in der logischen Nachrichtenbaumstruktur erstellt werden. Jedes Element in der Nachrichtenbaumstruktur verfügt über einen Namen und einen Namespace, deshalb muss ein ESQL- oder Java™-Verweis auf eines dieser Elemente sowohl den Namen als auch den Namespace angeben. Die Verwendung von Namespaces wirkt sich somit auf den von Ihnen geschriebenen ESQL- oder Java-Code aus. Wählen Sie diese Eigenschaft auf jeden Fall aus, wenn die Nachrichtengruppe zur Modellierung von XML-Nachrichten verwendet werden soll. |
Eigenschaft | Typ | Bedeutung |
---|---|---|
Standardmäßiges physisches Format | String | Optional: Geben Sie das verwendete physische Standardformat nur an, wenn Sie
MRM als Standardnachrichtendomäne auswählen; andernfalls wird MRM in der Liste der unterstützten
Nachrichtendomänen ausgewählt. Der Standardwert ist <kein
Standardwert angegeben>. Wenn Sie nicht MRM auswählen, entweder als die Standardnachrichtendomäne oder als eine der unterstützten Nachrichtendomänen, ist die Eigenschaft Standardmäßiges physisches Format nicht verfügbar. |
Nachrichtengruppen-ID | String | Dies ist eine eindeutige Kennung, die automatisch generiert wird, wenn Sie die Nachrichtengruppe erstellen. Diese Eigenschaft kann nicht geändert werden. |
Aliasname für Nachrichtengruppe | String | Geben Sie einen alternativen eindeutigen Wert an, der die Nachrichtengruppe identifiziert. Diese Eigenschaft muss nur angegeben werden, wenn das Nachrichten-ID-Verfahren zum Identifizieren eingebetteter Nachrichten eingesetzt wird. Bei diesem Verfahren sind eingebettete Nachrichten in dieser Nachrichtengruppe definiert, aber die übergeordnete Nachricht ist in einer anderen Nachrichtengruppe definiert und der Bitstrom enthält nicht den tatsächlichen Namen oder die tatsächliche ID der Nachrichtengruppe. |
Präfix für Nachrichtenart | String | Diese Eigenschaft wird bei der Definition von mehrteiligen Nachrichten verwendet, insbesondere wenn das Nachrichtenpfad-Verfahren zum Identifizieren eingebetteter Nachrichten eingesetzt wird. Der Wert, den Sie angeben, wird als absoluter oder relativer Pfad von der äußersten zur innersten Nachricht verwendet. Des Weiteren wird er als Präfix des Werts der Eigenschaft Nachrichtenart verwendet, die für die äußerste Nachricht angegeben wurde (festgelegt entweder im MQRFH2-Header der Nachricht oder im Empfangsknoten des Nachrichtenflusses). Wenn Sie einen Wert einrichten, muss er die Form id1/id2/.../idnu haben. Dabei steht id1 für die ID der äußersten Nachricht, id2 für die ID des nächsten Elements bzw. der nächsten Nachricht und idn für die ID der innersten Nachricht. Der Standardwert ist leer (nicht eingerichtet). Die folgende Tabelle, in der die Verwendung der Nachrichtengruppeneigenschaft Präfix für Nachrichtenart beschrieben wird, zeigt, wie dieser Wert mit der Eigenschaft Nachrichtenart einer Eingabenachricht kombiniert wird. |
Broker behandelt Längenfacette als maximale Länge | Kontrollkästchen | Wählen Sie diese Eigenschaft, wenn das COBOL-Importprogramm für ein Zeichenfolgeelement statt einer Längenfacette eine maxLength-Facette erstellen soll. Dieses Kontrollkästchen ist standardmäßig aktiviert. |
Die folgende Tabelle zeigt die Auswirkungen, die bei Verwendung der Eigenschaft Präfix für Nachrichtenart auftreten. Bei dem, was die Nachrichtenart oder das Nachrichtenpräfix beschreibt, kann es sich um Elemente oder Nachrichten handeln.
Beispiel für die Eigenschaft der Nachrichtenart | Präfix für Nachrichtenart nicht festgelegt | Präfix für Nachrichtenart festgelegt |
---|---|---|
Einfacher Nachrichtentyp:msg_type | Ergibt den einfachen Nachrichtentyp:msg_type | Ergibt den Pfad des Nachrichtentyps: /msg_prefix_1/.../msg_prefix_n/ msg_type |
Pfad des Nachrichtentyps:msg_type_1/.../msg_type_m | Ergibt den Pfad des Nachrichtentyps:/msg_type_1/.../msg_type_m | Ergibt den Pfad des kombinierten Nachrichtentyps: /msg_prefix_1.../msg_prefix_n /msg_type_1/.../msg_type_m |
Einfacher absoluter Nachrichtentyp:/msg_type | Ergibt den einfachen Nachrichtentyp:msg_type | Ergibt den einfachen Nachrichtentyp:msg_type Wenn die Eigenschaft 'Präfix für Nachrichtenart' nicht auf den Wert 'msg_type' gesetzt wurde, tritt ein Fehler auf. |
Pfad des absoluten Nachrichtentyps:msg_type_1/.../msg_type_m | Ergibt den Pfad des Nachrichtentyps:/msg_type_1/.../msg_type_m | Ergibt den Pfad des Nachrichtentyps:/msg_type_1/.../msg_type_m Ein Fehler tritt auf, wenn alle IDs im Präfix für die Nachrichtenart nicht mit den entsprechenden IDs im sich ergebenden Pfad identisch sind. |
Wenn Sie MRM- oder IDOC-Domänen verwenden, können Sie für die Nachrichtengruppe neben den Haupteigenschaften der Nachrichtengruppe auch spezifische Eigenschaften des jeweiligen physischen Formats einstellen. Die folgenden Abschnitte beschreiben diese Eigenschaften.