Dieses Thema enthält folgende Abschnitte:
Der XMLUmsetzungsknoten wird zur Umwandlung einer XML-Nachricht in ein anderes XML-Nachrichtenformat verwendet. Hierbei gelten die Regeln, die von einer XSL-Formatvorlage (XSL = eXtensible Stylesheet Language) bereitgestellt werden.
Sie haben drei Möglichkeiten für die Angabe der Adresse der Formatvorlage, die für diese Umwandlung verwendet werden soll:
Für die Umwandlung wird ein XSLT-Compiler (eXtensible Stylesheet Language for Transformations) verwendet, wenn die Formatvorlage Teil der Nachricht ist und der Wert für die Knotencachestufe (Knoteneigenschaft Cachestufe für Formatvorlage) größer als null ist.
Der XMLUmsetzungsknoten wird im Workbench durch folgendes Symbol dargestellt:
Zur Veranschaulichung der Verwendung dieses Knotens betrachten wir beispielsweise zwei Nachrichtenagenturen, die regelmäßig Informationen austauschen. Bei der einen Agentur könnte es sich um einen Fernsehsender, bei der anderen um eine Zeitung handeln. Die Informationen ähneln sich zwar, beide verwenden jedoch unterschiedliches Vokabular. Dieser Knoten kann ein Format in ein anderes umwandeln, indem er die Regeln der angegebenen Formatvorlage anwendet. Wenn Sie die Formatvorlage in der Nachricht angeben (entweder die XML-Daten oder die lokale Umgebung), kann derselbe Knoten beide Umwandlungen vornehmen.
Ausführliche Informationen zur Verwendung der XML-Umsetzungsknoten finden Sie im Beispielprogramm 'XMLT'.
Sobald Sie eine Instanz des XMLUmsetzungsknotens in einen Nachrichtenfluss eingereiht haben, können Sie diese konfigurieren. Klicken Sie in der Editoransicht mit der rechten Maustaste auf den Knoten, und klicken Sie auf Eigenschaften. Die Basiseigenschaften des Knotens werden angezeigt.
Alle obligatorischen Eigenschaften, für die ein Wert eingegeben werden muss (diejenigen, für die kein Standardwert definiert ist), sind im Eigenschaftendialog mit einem Stern markiert.
Konfigurieren Sie den XMLUmsetzungsknoten wie folgt:
<?xml-stylesheet type="text/xsl" href="foo.xsl"?>
Da dieser Knoten über ein SupportPac für Version 2.1 zur Verfügung gestellt wurde und das Element 'ComIbmXslMqsiStylesheetname' als Name der Formatvorlage verwendet wurde, überprüft der Knoten beide Elemente. Sind beide Elemente vorhanden, hat der Wert in 'ComIbmXslXmltStylesheetname' Vorrang.
Obwohl für jede Eigenschaft mehr als ein Wert gesetzt werden kann, sollte dies unterlassen werden. Falls Sie sich dennoch dafür entscheiden, gilt die oben aufgeführte Prioritätenreihenfolge für den Knoten.
Wird der Wert 'Ignorieren' gesetzt, durchsucht der Knoten die entsprechende Position nicht auf Informationen zur Formatvorlage. Werden alle drei Eigenschaften auf 'Ignorieren' gesetzt, wird ein Laufzeitfehler generiert.
Soll die Formatvorlage über die Knoteneigenschaften definiert werden, geben Sie den entsprechenden Wert für Name der Formatvorlage ein. Werden die Formatvorlagen an der Position mit der höchsten Priorität gefunden (festgelegt über die zuvor gesetzten Prioritätswerte), wird dieser Wert ignoriert.
Beispiel: Geben Sie den Wert 1208 als Zeichenfolge für dieses Element an, wenn die Ausgabe der Umwandlung in UTF-8 codiert werden soll.
Da dieser Knoten über ein SupportPac für Version 2.1 zur Verfügung gestellt wurde und das Element 'ComIbmXslMqsiOutputcharset' als Name für den Ausgabezeichensatz verwendet wurde, überprüft der Knoten beide Elemente. Sind beide Elemente vorhanden, hat der Wert in 'ComIbmXslXmltOutputcharset' Vorrang.
Für Ausgabezeichensatz muss ein numerischer Wert festgelegt werden. Beispiel: Geben Sie den Wert 1200 ein, wenn die Ausgabe der Umwandlung in UTF-16 codiert werden soll.
Obwohl für jede Eigenschaft mehr als ein Wert gesetzt werden kann, sollte dies unterlassen werden. Falls Sie sich dennoch dafür entscheiden, gilt die oben aufgeführte Prioritätenreihenfolge für den Knoten.
Wird der Wert 0 gesetzt, durchsucht der Knoten die entsprechende Position nicht auf Informationen zum Zeichensatz.
Kann der Knoten den Ausgabezeichensatz nicht auf Grundlage einer dieser Quellen ermitteln, weil entweder kein Wert gesetzt ist oder die Auswahlprioritäten auf 0 gesetzt sind, wird der Standardwert 1208 (UTF8) verwendet. (Die XSL-Spezifikation gibt an, dass der Ausgabezeichensatz in der Formatvorlage angegeben werden kann. Der XMLUmsetzungsknoten ignoriert diesen Wert jedoch.)
Die Tracedaten werden in der Tracedatei XMLTTrace.log gespeichert:
Wird für einen XMLUmsetzungsknoten ausgewählt, dass ein ausführlicher Trace durchgeführt wird, wird dies für alle Knoten in derselben Ausführungsgruppe übernommen.
Klicken Sie auf Abbrechen, um das Dialogfeld zu schließen und alle Änderungen zu verwerfen, die Sie an den Eigenschaften vorgenommen haben.
mqsireportproperties Brokername -e Kennung_der_Ausführungsgruppe -o ComIbmJVMManager -n jvmMaxHeapSize
mqsichangeproperties Brokername -e Kennung_der_Ausführungsgruppe -o ComIbmJVMManager -n jvmMaxHeapSize -v Neue_Größe
Ersetzen Sie Brokername, Kennung_der_Ausführungsgruppe
und Neue_Größe durch die entsprechenden Werte.Der Wert für Neue_Größe richtet sich nach der physischen Hauptspeichermenge Ihres Computers sowie danach, wie häufig Sie Java verwenden. Empfohlen wird ein Wert zwischen 512 MB und 1 GB.
In der nachfolgenden Tabelle werden die Terminals des XMLUmsetzungsknotens beschrieben.
Terminal | Beschreibung: |
---|---|
Eingangsterminal | Das Eingangsterminal, das die Nachricht zur Verarbeitung durch einen Knoten annimmt. |
Failure | Das Ausgabeterminal, an das die Originalnachricht weitergeleitet wird, wenn während der Umwandlung ein Fehler auftritt. |
Out | Das Ausgabeterminal, an das eine erfolgreich umgewandelte Nachricht weitergeleitet wird. |
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 Formatvorlageneigenschaften des XMLUmsetzungsknotens beschrieben.
Eigenschaft | M | C | Standardwert | Beschreibung: |
---|---|---|---|---|
Auswahlpriorität in XML-Einbettung | Ja | Nein | 1 | Die Prioritätsstufe zum Suchen der Formatvorlage in den XML-Daten. |
Auswahlpriorität in Nachrichtenumgebung | Ja | Nein | 2 | Die Priorität zum Suchen der Formatvorlage in der LocalEnvironment-Baumstruktur der aktuellen Nachricht. |
Auswahlpriorität in Brokerknotenattribut | Ja | Nein | 3 | Die Priorität zum Suchen der Formatvorlage als Eigenschaft des Knotens. |
Name der Formatvorlage | Nein | Ja | Der Name der Formatvorlage; wird beim Suchen der Spezifikation für die Formatvorlage in den Knoteneigenschaften verwendet. | |
Verzeichnis der Formatvorlage | Nein | Ja | Der Pfad der Formatvorlage. Wird bei allen Methoden zum Bestimmen der Position verwendet. | |
Cachestufe für Formatvorlage | Nein | Nein | 5 | Die Anzahl der kompilierten oder syntaktisch analysierten Formatvorlagen, die in der Knoteninstanz gespeichert werden sollen. |
In der nachfolgenden Tabelle werden die Ausgabezeichensatzeigenschaften des XMLUmsetzungsknotens beschrieben.
Eigenschaft | M | C | Standardwert | Beschreibung: |
---|---|---|---|---|
Auswahlpriorität in Nachrichtenumgebung | Ja | Nein | 1 | Die Priorität zum Suchen der Ausgabezeichensatz-ID in der LocalEnvironment-Baumstruktur der aktuellen Nachricht. |
Auswahlpriorität in Brokerknotenattribut | Ja | Nein | 2 | Die Priorität zum Suchen der Ausgabezeichensatz-ID als Eigenschaft des Knotens. |
Ausgabezeichensatz | Nein | Nein | Der numerische Wert für den Ausgabezeichensatz. |
In der nachfolgenden Tabelle werden die Detail-Trace-Eigenschaften des XMLUmsetzungsknotens beschrieben.
Eigenschaft | M | C | Standardwert | Beschreibung: |
---|---|---|---|---|
Trace-Einstellung | Ja | Nein | Off | Gibt an, ob die Tracefunktion aktiv ist. Ist sie aktiv, werden Tracedaten mit niedriger Detailtiefe in einer Datei gespeichert. |
In der nachfolgenden Tabelle werden die Beschreibungseigenschaften des XMLUmsetzungsknotens beschrieben.
Eigenschaft | M | C | Standardwert | Beschreibung: |
---|---|---|---|---|
Kurzbeschreibung | Nein | Nein | Kurze Beschreibung des Knotens | |
Ausführliche Beschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt |
Wenn zu Beginn des Hauptteils der Eingabenachricht eine XML-Codierungsdeklaration
enthalten ist, wird diese Codierung vom XMLUmsetzungsknoten ignoriert und für die
Decodierung der Nachricht immer die CodedCharSetId im Eigenschaftenordner verwendet.