Der XSLTransform-Knoten wird zur Umwandlung einer XML-Nachricht in ein anderes Nachrichtenformat verwendet (hierbei gelten die Regeln, die von einer XSL-Formatvorlage (XSL = eXtensible Stylesheet Language) bereitgestellt werden). Er wird auch zum Festlegen von Nachrichtendomäne, Nachrichtengruppe, Nachrichtentyp und Nachrichtenformat für die generierte Nachricht verwendet.
Dieser Knoten wurde früher als XMLUmsetzungsknoten bezeichnet.
Dieses Thema enthält folgende Abschnitte:
Sie haben drei Möglichkeiten zur 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 nicht Teil der Nachricht ist und der Wert für die Knotencachestufe (Knoteneigenschaft Cachestufe für Formatvorlage) größer als null ist. Wenn XSLT zwischengespeichert wird, führt dies zu einer Leistungsverbesserung, da XSLT nicht bei jeder Verwendung syntaktisch analysiert wird.
Wenn zu Beginn des Hauptteils der Eingabenachricht eine XML-Codierungsdeklaration enthalten ist, wird diese Codierung vom XSLTransform-Knoten ignoriert und für die Decodierung der Nachricht immer die CodedCharSetId im Eigenschaftenordner verwendet.
Der XSLTransform-Knoten befindet sich im Ablagefach Transformation der Palette und wird in der Workbench durch folgendes Symbol dargestellt:
Beispiel für die Verwendung dieses Knoten: Zwei Medienunternehmen, die regelmäßig Informationen austauschen. Bei einem der Unternehmen handelt es sich um einen Fernsehsender, das andere ist ein Zeitungsverlag. Obwohl identische Informationen verwendet werden, unterscheidet sich doch das verwendete 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.
| Name der lokalen Umgebungsvariablen | Name der Knoteneigenschaft |
|---|---|
| XSL.StyleSheetName | Name der Formatvorlage |
| XSL.MessageDomain | Nachrichtendomäne |
| XSL.MessageSet | Nachrichtengruppe |
| XSL.MessageType | Nachrichtentyp |
| XSL.MessageFormat | Nachrichtenformat |
| XSL.OutputCharSet | Zeichensatz |
<?xml-stylesheet type="text/xsl" href="foo.xsl"?>und 'foo.xsl' wird dann als Name der Formatvorlage verwendet.
Da dieser Knoten in Version 5.0 und Version 6.0 verfügbar war und das Element 'ComIbmXslXmltStylesheetname' als Name der Formatvorlage verwendet wurde, überprüft der Knoten beide Elemente. Sind beide Werte vorhanden, hat der Wert in 'XSL.StyleSheetName' Vorrang.
Da dieser Knoten in Version 5.0 und Version 6.0 verfügbar war und das Element 'ComIbmXslXmltOutputcharset' als Zeichensatz für die Ausgabe verwendet wurde, überprüft der Knoten beide Elemente. Sind beide Werte vorhanden, hat der Wert in 'XSL.OutputCharSet' Vorrang.
Für Zeichensatz muss ein numerischer Wert festgelegt werden. Geben Sie beispielsweise den Wert 1200 ein, wenn die Ausgabe der Umwandlung in UTF-16 codiert werden soll.
Wenn die Eingabe für den XSLTransform-Knoten vom XMLNSC- oder MRM-Parser generiert wird, sollten Sie verschiedene Punkte berücksichtigen. Bestimmte Informationen in XML-Dokumenten (z. B. Verarbeitungsanweisungen und Kommentare) werden vom XMLNSC-Parser gelöscht, wenn auf einem vorherigen Knoten die Eigenschaften zum Beibehalten dieser Informationen nicht entsprechend gesetzt wurden. Um sicherzustellen, dass die Nachricht vom XSLTransform-Knoten korrekt umgesetzt wird, müssen die die Eigenschaften Gemischten Inhalt beibehalten, Kommentare beibehalten und Verarbeitungsanweisung beibehalten auf dem vorherigen Knoten (z. B. einem MQInput-Knoten) korrekt gesetzt werden. Der MRM-Parser löscht auch diese Informationen, und Sie können keine Informationen für diesen Parser beibehalten. Deshalb sollten Sie die Verwendung des MRM-Parsers vermeiden, wenn Sie diese Informationen für Ihre Umsetzung benötigen.
Bei Formatvorlagen, die implementiert werden sollen, muss die Dateierweiterung entweder .xsl oder .xslt lauten, und bei XML-Dateien, die implementiert werden sollen, muss sie .xml lauten.
Importieren Sie alle Formatvorlagen und XML-Dateien, die implementiert werden sollen, in das Projekt eines Eclipse-Arbeitsbereichs. Schreiben Sie standortabhängige untergeordnete Formatvorlagen oder XML-Dateien, die implementiert werden sollen, in die richtige Verzeichnisstruktur, die relativ zu den zugehörigen übergeordneten Formatvorlagen ist. Im Eclipse-Arbeitsbereich sollten sich keine standortabhängigen untergeordneten Formatvorlagen befinden, die nicht implementiert werden sollen.
Bei allen Verweisen auf eine implementierte Formatvorlage muss es sich unabhängig von ihrer Position um einen relativen Verweis handeln. Ein Verweis auf eine Principal-Formatvorlage muss relativ zu dem Stammverzeichnis des relevanten Projekts des Eclipse-Arbeitsbereichs sein.
Einzige Ausnahme: Bei der Angabe einer Principal-Formatvorlage als Eigenschaft Name der Formatvorlage in einem XSLTransform-Knoten können Sie einen absoluten Pfad verwenden, der auf die richtige Verzeichnisstruktur im Eclipse-Arbeitsbereich verweist. Wenn die Principal-Formatvorlage gefunden wurde, setzt das System die Knoteneigenschaft automatisch auf den richtigen relativen Wert.
Außerdem führt es eine automatische Implementierung der Principal-Formatvorlage und der standortabhängigen untergeordneten Formatvorlagen aus, die im relevanten Eclipse-Arbeitsbereichsprojekt verfügbar sind. Alle Verweise auf standortabhängige untergeordnete Formatvorlagen (oder XML-Dateien) einer Principal-Formatvorlage müssen relativ zum Standort der zugehörigen übergeordneten Formatvorlagen sein. Wenn beispielsweise die Formatvorlage //project1/a/b.xsl auf die Formatvorlage //project1/a/c/d.xsl verweist, muss der Verweis in c/d.xsl (oder ./c/d.xsl) geändert werden.
Formatvorlagen können auf andere Formatvorlagen verweisen. Wenn Sie eine Formatvorlage (oder XML-Datei) mit einem relativen Verweis haben, die selbst zwar nicht, aber deren übergeordnetes Element implementiert werden soll, müssen Sie sicherstellen, dass die untergeordnete Formatvorlage an die korrekte Position unter Arbeitspfad/XSL/external (Arbeitspfad/XML/external) gestellt wird. Dabei ist Arbeitspfad der vollständige Pfad zum Arbeitsverzeichnis des Brokers.
Ein Broker ordnet die in der Ausführungsgruppe implementierte Speicherbaumstruktur, Arbeitspfad/XSL/external, und die Baumstruktur Arbeitspfad/XML/external einander automatisch zu. Wenn also beispielsweise das Dokument b/c.xml im implementierten Speicher des Brokers nicht gefunden wird, führt der Broker im Verzeichnis Arbeitspfad/XML/external/a/b automatisch eine Suche nach einem Verweis auf das Dokument in der implementierten Principal-Formatvorlage a/style.xsl durch. Relative Pfadverweise müssen auch für Dateien verwendet werden, die bereits implementiert wurden, die im Arbeitsbereich aber noch nicht verfügbar sind.
Implementieren Sie nur die Formatvorlagen oder XML-Dateien manuell, die vom System noch nicht berücksichtigt wurden (das Message Broker Toolkit gibt Warnungen zu diesen Dateien aus). Wenn Sie für den Knoten auf Durchsuchen klicken oder den vollständigen Pfad der Formatvorlage im Eclipse-Arbeitsbereich angeben, wird dies automatisch in die BAR-Datei eingefügt.
Fügen Sie die Dateien bei der manuellen Implementierung zu einem Brokerarchiv hinzu. Sie finden weitere Informationen hierzu in den Abschnitten Dateien zu einem Brokerarchiv hinzufügen und Schlüsselwörter zu XSL-Formatvorlagen hinzufügen.
Wenn eine Formatvorlage im Verzeichnis Arbeitspfad/XSL/external denselben Pfad und denselben Namen wie eine implementierte Formatvorlage hat, wird die implementierte Formatvorlage verwendet.
Nachdem Sie eine Instanz des XSLTransform-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren; siehe Nachrichtenflussknoten konfigurieren. 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.
Konfigurieren Sie den XSLTransform-Knoten:
Wenn Sie eine zwischengespeicherte Formatvorlage ändern (indem Sie die Datei im Dateisystem erneut implementieren oder ersetzen), ersetzt der XSLTransform-Knoten, der den Cache enthält, die zwischengespeicherte Version durch die geänderte (neueste) Version, bevor eine neue Nachricht verarbeitet wird. Wenn Sie mehrere Formatvorlagen ändern, sollten Sie jedoch die relevanten Nachrichtenflüsse stoppen, bevor Sie Änderungen vornehmen. Wenn Sie die relevanten Nachrichtenflüsse nicht stoppen, bevor Sie die Änderungen vornehmen, kann die Reihenfolge der Änderungen von aktiven Nachrichtenflüssen nicht garantiert werden, was eine Inkompatibilität zwischen geänderten Formatvorlagen verursachen kann. Verwenden Sie den Befehl mqsireload, um eine Formatvorlage erneut zu laden. Der Befehl verhindert die Inkompatibilität jedoch nicht.
Sie können bei Bedarf auch einen benutzerdefinierten Parser angeben.
Weitere Informationen finden Sie unter Nachrichten überprüfen und Auswertungseigenschaften.
Die Tracedaten werden in der Tracedatei XMLTTrace.log gespeichert:
Auf z/OS-Systemen befindet sich die Datei im Verzeichnis Installationsverzeichnis/output, wobei Installationsverzeichnis für das Verzeichnis steht, in dem der Broker installiert ist.
Auf Windows-Systemen befindet sich die Datei im Verzeichnis workpath\log, wenn Sie die Option -w des Befehls mqsicreatebroker angegeben haben.
Wenn Sie den Brokerarbeitspfad nicht angegeben haben, werden die Daten in das Verzeichnis C:\Dokumente und Einstellungen\All Users\Application Data\IBM\MQSI\common\log geschrieben.
Auf Linux- und UNIX-Systemen befindet sich die Datei im Verzeichnis /var/mqsi/common/log.Wenn Sie Traceeinstellung für einen XSLTransform-Knoten auf On setzen, wird diese Einstellung für alle Knoten in der Ausführungsgruppe übernommen.
Diese Eigenschaft wird nicht mehr unterstützt. Jeder relevante Trace wird in den Benutzertrace verschoben, vorausgesetzt, der Debug-Benutzertrace ist aktiviert. Die Einstellung von Traceeinstellung im XSLTransform-Knoten wirkt sich nicht auf Benutzertraces aus.
mqsireportproperties Brokername -e Kennung_der_Ausführungsgruppe -o ComIbmJVMManager -n jvmMaxHeapSize
Verwenden Sie den Befehl mqsichangeproperties, um die Größe des Java-Heapspeichers zu erhöhen:mqsichangeproperties Brokername -e Kennung_der_Ausführungsgruppe -o ComIbmJVMManager -n jvmMaxHeapSize -v Neue_Größe
Ersetzen Sie in den zuvor genannten Beispielen Brokername, Kennung_der_Ausführungsgruppe
und Neue_Größe durch die entsprechenden Werte.Der Wert für Neue_Größe richtet sich nach der Größe des physischen Hauptspeichers Ihres Computers sowie danach, wie häufig Sie Java verwenden. Ein Wert zwischen 512 MB (536870912) und 1 GB (1073741824) ist in der Regel ausreichend.
In der folgenden Tabelle werden die XSLTransform-Knotenterminals beschrieben .
| Terminal | Beschreibung: |
|---|---|
| Eingangsterminal | Das Eingangsterminal, das die Nachricht zur Verarbeitung durch einen Knoten annimmt. |
| Fehlerterminal | Das Ausgabeterminal, an das die Originalnachricht weitergeleitet wird, wenn während der Umwandlung ein Fehler auftritt. |
| Ausgabeterminal | Das Ausgabeterminal, an das eine erfolgreich umgewandelte Nachricht weitergeleitet wird. |
In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte C 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 XSLTransform-Knotens beschrieben.
| Eigenschaft | M | C | 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 Formatvorlageneigenschaften des XSLTransform-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung: |
|---|---|---|---|---|
| Name der Formatvorlage | Nein | Ja | Der Name der Formatvorlage; wird beim Suchen der Spezifikation für die Formatvorlage in den Knoteneigenschaften verwendet. |
In der folgenden Tabelle werden die erweiterten Eigenschaften des XSLTransform-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung: |
|---|---|---|---|---|
| Verzeichnis der Formatvorlage | Nein | Ja | Der Pfad der Formatvorlage. Er wird von allen Positionierungsmethode verwendet. | |
| Cachestufe für Formatvorlage | Nein | Nein | 5 | Die Anzahl der kompilierten oder syntaktisch analysierten Formatvorlagen, die in der Knoteninstanz gespeichert werden. |
In der nachfolgenden Tabelle werden die Eigenschaften für die Syntaxanalyse der Ausgabenachricht des XSLTransform-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung: |
|---|---|---|---|---|
| Nachrichtendomäne | Nein | Nein | BLOB | Die Nachrichtendomäne, die mit der Ausgabenachricht verknüpft ist. |
| Nachrichtengruppe | Nein | Nein | Die Nachrichtengruppe, die mit der Ausgabenachricht verknüpft ist. | |
| Nachrichtentyp | Nein | Nein | Der Nachrichtentyp, der mit der Ausgabenachricht verknüpft ist. | |
| Nachrichtenformat | Nein | Nein | Das Nachrichtenformat, das mit der Ausgabenachricht verknüpft ist. | |
| Zeichensatz | Nein | Nein | Der numerische Wert des Zeichensatzes für die Ausgabenachricht |
In der folgenden Tabelle werden die Parseroptionen des XSLTransform-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung: |
|---|---|---|---|---|
| Zeitpunkt für Syntaxanalyse | Nein | Nein | Bei Bedarf | Durch diese Eigenschaft wird gesteuert, zu welchem Zeitpunkt eine Ausgabenachricht syntaktisch analysiert wird.
Gültige Werte sind Bei Bedarf, Sofort und Vollständig. Eine vollständige Beschreibung der bedarfsgesteuerten Syntaxanalyse finden Sie unter Bedarfsgerechte Syntaxanalyse. |
| Baumstruktur unter Verwendung von XML-Schemadatentypen erstellen | Nein | Nein | Nicht ausgewählt | Über diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser Syntaxelemente in der Nachrichtenbaumstruktur mit Datentypen aus dem XML-Schema erstellt. Sie können diese Eigenschaft nur auswählen, wenn Sie Auswerten auf Inhalt oder Inhalt und Wert gesetzt haben. |
| XMLNSC-Kompaktparser für XMLNS-Domäne verwenden | Nein | Nein | Nein | Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Kompaktparser für Ausgabenachrichten in der XMLNS-Domäne verwendet wird. Wenn Sie diese Eigenschaft festlegen, werden die Nachrichtendaten unter XMLNSC in Knoten, die mit dem Ausgabeterminal verbunden sind, angezeigt, wenn der MQRFH2-Header oder die Domäne XMLNS ist. |
In der folgenden Tabelle werden die Auswertungseigenschaften des XSLTransform-Knotens beschrieben. Eine umfassende Beschreibung zu Auswertungseigenschaften finden Sie unter Auswertungseigenschaften.
| Eigenschaft | M | C | Standardwert | Beschreibung: |
|---|---|---|---|---|
| Auswertung | Nein | Ja | Keines | Durch diese Eigenschaft wird gesteuert, ob eine Auswertung der Ausgabenachricht stattfindet. Gültige Werte sind Keine, Inhalt, Inhalt und Wert und Übernehmen. |
| Aktion bei Fehler | Nein | Nein | Ausnahme | Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung der Ausgabenachricht 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. |
In der folgenden Tabelle werden die Detail-Trace-Eigenschaften des XSLTransform-Knotens beschrieben.
| Eigenschaft | M | C | Standardwert | Beschreibung: |
|---|---|---|---|---|
| Trace-Einstellung | Ja | Nein | Off | Über diese Eigenschaft wird gesteuert, ob die Tracefunktion aktiv oder inaktiv ist. Ist sie aktiv, werden Tracedaten mit niedriger Detailtiefe in einer Datei gespeichert. |