XMLTransformation-Knoten

Der XMLTransformation-Knoten 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).

Dieses Thema enthält folgende Abschnitte:

Zweck

Sie haben drei Möglichkeiten zur Angabe der Adresse der Formatvorlage, die für diese Umwandlung verwendet werden soll:

  • Verwenden Sie den Inhalt der XML-Daten in der Nachricht selbst. Dadurch wird die Nachricht gemäß einer Formatvorlage, die von der Nachricht selbst definiert wird, umgewandelt.
  • Geben Sie einen Wert im Ordner der lokalen Umgebung (LocalEnvironment) an. Sie müssen diesen Wert vor dem XMLTransformation-Knoten (z. B. in einem Compute-Knoten) festlegen. Daher können Sie verschiedene Eingaben verwenden, um zu bestimmen, welche Formatvorlage für diese Nachricht verwendet werden soll - beispielsweise den Inhalt der Nachrichtendaten oder einen Wert in einer Datenbank.
  • Verwenden Sie Knoteneigenschaften. Dadurch stellen Sie sicher, dass die Umwandlung, die über diese einzelne Formatvorlage definiert wurde, auf jede von diesem Knoten verarbeitete Nachricht angewandt wird.

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 XMLTransformation-Knoten ignoriert und für die Decodierung der Nachricht immer die CodedCharSetId im Eigenschaftenordner verwendet.

Der XMLTransformation-Knoten befindet sich im Ablagefach Transformation der Palette und wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für XMLTransformation-Knoten

Diesen Knoten in einem Nachrichtenfluss verwenden

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 eine 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.

Ausführliche Informationen zur Verwendung des XMLTransformation-Knotens finden Sie im folgenden Beispiel: Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Brokers Toolkit integriert ist.

Wenn die Eingabe für den XMLTransformation-Knoten vom XMLNSC- oder MRM-Parser generiert wird, sollten Sie folgende 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 XMLTransformation-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.

Implementierte und nicht implementierte Formatvorlagen

Sie haben können Formatvorlagen auf zwei verschiedene Arten mit dem XMLTransformation-Knoten verwenden:
Implementierte Formatvorlagen
Bei implementierten Formatvorlagen handelt es sich um Formatvorlagen, die Sie in eine Brokerarchivdatei (BAR-Datei) importieren und auf Zielsystemen implementieren. Implementierte Formatvorlagen werden vom Broker verwaltet. Eine Principal-Formatvorlage ist die Stamm-Formatvorlage, auf die in einem Nachrichtenfluss verwiesen wird. Beispielsweise muss ein Verweis auf eine Principal-Formatvorlage im Eclipse-Arbeitsbereich C:\\Projekt1\a\b.xsl als a/b.xsl (oder ./a/b.xsl) angegeben werden. Eine Principal-Formatvorlage kann auf ihre untergeordneten Formatvorlagen verweisen (diese enthalten oder importieren).
Nicht implementierte Formatvorlagen
Bei nicht implementierten Formatvorlagen handelt es sich um Formatvorlagen, die Sie an einer Position speichern, an der der XMLTransformation-Knoten darauf zugreifen kann. Nicht implementierte Formatvorlagen werden nicht vom Broker verwaltet.
Der Abschnitt Style-Sheets und XML-Dateien migrieren enthält weitere Informationen hierzu.

Implementierung von implementierten Formatvorlagen oder XML-Dateien

Bevor Sie den XMLTransformation-Knoten konfigurieren können, müssen Sie wissen, wie Sie mit Formatvorlagen arbeiten. Eine Formatvorlage kann sowohl auf eine andere XML-Datei als auch auf eine Formatvorlage verweisen. Verwendung von implementierten Formatvorlagen oder XML-Dateien:
  1. Stellen Sie sicher, dass die Dateien die richtigen Dateinamenerweiterungen haben.

    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.

  2. Importieren Sie die Dateien in den Eclipse-Arbeitsbereich.

    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.

  3. Stellen Sie sicher, dass alle Verweise auf die Dateien relativ sind.

    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 XMLTransformation-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.

  4. Bearbeiten Sie nicht implementierte untergeordnete Formatvorlagen oder XML-Dateien.

    Beginn der ÄnderungFormatvorlagen 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. Über die Umgebungsvariable MQSI_WORKPATH können Sie die Position des Arbeitspfads auf dem System ermitteln; auf Windows-Systemen lautet der Standardarbeitspfad beispielsweise MQSI_WORKPATH=C:\Dokumente und Einstellungen\All Users\Anwendungsdaten\IBM\MQSI.Ende der Änderung

    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.

  5. Implementieren Sie die Dateien.

    Implementieren Sie nur die Formatvorlagen oder XML-Dateien manuell, die vom System noch nicht berücksichtigt wurden (das Message Brokers 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.

    Für jede Ausführungsgruppe, die den XMLTransformation-Knoten verwendet, führen Sie eine der folgenden Aktionen aus:
    • Fügen Sie die Formatvorlage in das Verzeichnis Arbeitspfad/XSL/external auf dem Broker ein und nicht in die BAR-Datei.

      Wenn eine Formatvorlage im Verzeichnis Arbeitspfad/XSL/external denselben Pfad und denselben Namen wie eine implementierte Formatvorlage hat, wird die implementierte Formatvorlage verwendet.

    • Fügen Sie die Formatvorlage in die BAR-Datei ein und implementieren Sie die BAR-Datei. Wenn mehrere BAR-Dateien denselben Formatvorlagennamen enthalten, wird die Formatvorlage aus der zuletzt implementierten BAR-Datei verwendet.
    • Implementieren Sie die Formatvorlage in ihrer eigenen BAR-Datei. Wenn die BAR-Dateien XMLTransformation-Knoten verwenden, jedoch nicht die Formatvorlage enthalten, gibt das Message Brokers Toolkit Warnungen aus.

XMLTransformation-Knoten konfigurieren

Nachdem Sie eine Instanz des XMLTransformation-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie ihn konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt. Klicken Sie zum Anzeigen der Knoteneigenschaften im Eigenschaftendialog mit der rechten Maustaste und anschließend auf Eigenschaften. (Durch Doppelklicken auf den XMLTransformation-Knoten wird das Dialogfenster 'XSL-Auswahl' geöffnet.)

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 XMLTransformation-Knoten:

  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung und/oder eine Ausführliche Beschreibung ein. Sie können den Knoten dort auch umbenennen.
  2. Geben Sie zum Definieren einer Formatvorlage über die Knoteneigenschaften auf der Registerkarte Formatvorlage den erforderlichen Wert für Name der Formatvorlage ein. Dieser Wert wird ignoriert, wenn die Formatvorlagen an der Position mit der höchsten Priorität (festgelegt über die zuvor gesetzten Prioritätswerte) gefunden werden.
    Geben Sie die Principal-Formatvorlage mit einer der folgenden Methoden an:
    • Klicken Sie auf Durchsuchen neben Name der Formatvorlage. Die erkannten Principal-Formatvorlagen und alle zugehörigen untergeordneten Formatvorlagen mit relativem Verweis werden beim Hinzufügen eines Nachrichtenflusses zu einer BAR-Datei automatisch zur BAR-Datei hinzugefügt (wenn die Formatvorlagen und übergeordneten Formatvorlagen verfügbar sind).
    • Verwenden Sie zum Erkennen einer bereits implementierten oder einer zur Implementierung bereiten Formatvorlage die Eigenschaft Name der Formatvorlage, und lassen Sie die Eigenschaft Verzeichnis für Formatvorlagen leer.
    • Ziehen Sie im Nachrichtenflusseditor eine .xslt-Datei auf den XMLTransformation-Knoten; daraufhin wird der Name der Formatvorlage automatisch festgelegt.
  3. Auf der untergeordneten Registerkarte Erweitert:
    1. Wurde die Position der Formatvorlage vollständig angegeben, wird die Eigenschaft Verzeichnis für Formatvorlagen nicht berücksichtigt; andernfalls wird der Wert dieser Eigenschaft am Anfang der Spezifikation eingefügt, unabhängig davon, an welcher Stelle der Wert gefunden wurde.
    2. Geben Sie für die Eigenschaft Cachestufe für Formatvorlage die Anzahl der kompilierten oder syntaktisch analysierten Formatvorlagen ein, die in der Knoteninstanz gespeichert werden sollen. Der Standardwert ist 5. Der Formatvorlagen-Cache wird während der Lebensdauer des Knotens beibehalten und erst gelöscht, wenn der Knoten aus dem Nachrichtenfluss entfernt, der Nachrichtenfluss gelöscht oder die Ausführungsgruppe gestoppt wird

      Wenn Sie eine zwischengespeicherte Formatvorlage ändern (indem Sie die Datei im Dateisystem erneut implementieren oder ersetzen), ersetzt der XMLTransformation-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.

    3. Wählen Sie die entsprechenden Werte für die Eigenschaften Auswahlpriorität für eingebettete XML-Formatvorlage, Auswahlpriorität in Nachrichtenumgebung und Auswahlpriorität in Brokerknotenattribut aus. Mit den gesetzten Werten legen Sie fest, in welcher Reihenfolge die alternativen Positionen nach den Formatvorlageninformationen durchsucht werden. Die Einstellung für die höchste Priorität lautet 1. Es gilt folgende Standardreihenfolge:
      1. Auswahlpriorität für eingebettete XML-Formatvorlage, mit dem Standardwert 1. Der Knoten durchsucht die XML-Nachrichtendaten nach der Position der Formatvorlage. Die XML-Daten können beispielsweise Folgendes enthalten:
        <?xml-stylesheet type="text/xsl" href="foo.xsl"?>
      2. Auswahlpriorität in Nachrichtenumgebung, mit dem Standardwert 2. Der Knoten durchsucht die der Nachricht zugeordnete lokale Umgebung nach den Formatvorlageinformationen, die im Element 'ComIbmXslXmltStylesheetname' gespeichert sind.

        Da dieser Knoten über ein SupportPac für Version 2.1 zur Verfügung gestellt 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.

      3. Auswahlpriorität für Brokerknotenattribut, mit dem Standardwert 3. Der Knoten verwendet die Eigenschaften Name der Formatvorlage und Verzeichnis für Formatvorlagen zum Ermitteln der richtigen Werte.

      Sie können für mehrere Eigenschaften denselben Wert festlegen, aber auch dann gilt die vom Knoten festgelegt Prioritätenfolge als Standardreihenfolge (siehe Beschreibung oben).

      Wird der Wert 0 gesetzt, durchsucht der Knoten die entsprechende Position nicht auf Informationen zur Formatvorlage. Werden alle drei Eigenschaften auf 0 gesetzt, wird ein Laufzeitfehler generiert.

  4. Legen Sie auf der Registerkarte Zeichensatz für Ausgabe die Reihenfolge fest, in der der Knoten an gültigen Standorten nach dem Zeichensatz für die Ausgabenachricht sucht. Die Einstellung für die höchste Priorität lautet 1. Es gilt folgende Standardreihenfolge:
    1. Auswahlpriorität in Nachrichtenumgebung, mit dem Standardwert 1. Der Knoten durchsucht die der Nachricht zugeordnete lokale Umgebung nach den Zeichensatzinformationen, die im Element 'ComIbmXslXmltOutputcharset' gespeichert sind. Geben Sie beispielsweise 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 Zeichensatz für die Ausgabe verwendet wurde, überprüft der Knoten beide Elemente. Sind beide Elemente vorhanden, hat der Wert in 'ComIbmXslXmltOutputcharset' Vorrang.

    2. Auswahlpriorität für Brokerknotenattribut, mit dem Standardwert 2. Der Knoten ermittelt auf Grundlage der Eigenschaft Ausgabezeichensatz den korrekten Wert.

      Für Ausgabezeichensatz muss ein numerischer Wert festgelegt werden. Geben Sie beispielsweise den Wert 1200 ein, wenn die Ausgabe der Umwandlung in UTF-16 codiert werden soll.

    Sie können für mehrere Eigenschaften denselben Wert festlegen, aber auch dann gilt die vom Knoten festgelegt Prioritätenfolge als Standardreihenfolge (siehe Beschreibung oben).

    Wird der Wert auf null 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 null gesetzt sind, wird der Standardwert 1208 (UTF-8) verwendet. (Die XSL-Spezifikation gibt an, dass der Ausgabezeichensatz in der Formatvorlage angegeben werden kann. Der XMLTransformation-Knoten ignoriert diesen Wert jedoch.)

  5. Legen Sie auf der Registerkarte Detail-Trace die Traceeinstellung so fest, dass die Aktionen des XMLTransformation-Knotens nachverfolgt werden. Standardwert ist Off. Zum Aktivieren des Trace setzen Sie die Eigenschaft auf On.

    Die Tracedaten werden in der Tracedatei XMLTTrace.log gespeichert:

    • z/OS platform 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.
    • Windows platform Wenn Sie den Arbeitspfad auf Windows-Systemen mithilfe des Parameters-w des Befehls mqsicreatebroker festlegen, befinden sich die Protokolle unter workpath\log. Wenn Sie den Brokerarbeitspfad nicht angegeben haben, ist der Standort C:\Dokumente und Einstellungen\All Users\Application Data\IBM\MQSI\common\log.
    • Linux platformUNIX platform Auf Linux- und UNIX-Systemen befindet sich die Datei im Verzeichnis /var/mqsi/common/log.

    Wenn Sie Traceeinstellung für einen XMLTransformation-Knoten auf On setzen, wird diese Einstellung für alle Knoten in der Ausführungsgruppe übernommen.

    Diese Eigenschaft wird nicht mehr unterstützt. Starten Sie stattdessen den Benutzertrace. Der Benutzertrace enthält die gleichen XML-Traceinformationen. Wenn Sie Traceeinstellung im XMLTransformation-Knoten festlegen, hat dies keine Auswirkungen auf den Benutzertrace.

Wird in Zusammenhang mit umfangreichen XML-Nachrichten der Fehler Speicherknappheit gemeldet, kann der aktuelle Wert des Java-Heapspeichers für die XSLT-Steuerkomponente mithilfe des Befehls mqsireportproperties angezeigt werden:
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.

Terminals und Eigenschaften

In der folgenden Tabelle werden die XMLTransformation-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 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 XMLTransformation-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 Formatvorlageneigenschaften des XMLTransformation-Knotens beschrieben.

Eigenschaft O K 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 XMLTransformation-Knotens beschrieben.

Eigenschaft O K 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.

Geben Sie eine positive ganze Zahl zwischen null (0) und 100 ein. Der Standardwert ist 5. Falls Sie für diese Eigenschaft einen anderen Wert als eine positive ganze Zahl angeben, wird ein Ausnahmebedingungsfehler für die Nachrichtenflusskonfiguration ausgegeben.

Wenn Sie diese Eigenschaft auf null (0) setzen, wird keine Formatvorlage zwischengespeichert und Formatvorlagen werden interpretiert statt kompiliert.

Auswahlpriorität für eingebettete XML-Formatvorlage Ja Nein 1 Die Prioritätsstufe zum Suchen der Formatvorlage in den XML-Daten.
Auswahlpriorität für Nachrichtenumgebung Ja Nein 2 Die Priorität zum Suchen der Formatvorlage in Ordner der lokalen Umgebung (LocalEnvironment) der aktuellen Nachricht.
Auswahlpriorität für Brokerknotenattribut Ja Nein 3 Die Priorität zum Suchen der Formatvorlage als Eigenschaft des Knotens.

In der nachfolgenden Tabelle werden die Ausgabezeichensatzeigenschaften des XMLTransformation-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung:
Ausgabezeichensatz Nein Nein   Der numerische Wert für den Ausgabezeichensatz
Auswahlpriorität für Nachrichtenumgebung Ja Nein 1 Die Priorität zum Suchen der Ausgabezeichensatz-ID im Ordner der lokalen Umgebung (LocalEnvironment) der aktuellen Nachricht.
Auswahlpriorität für Brokerknotenattribut Ja Nein 2 Die Priorität zum Suchen der Ausgabezeichensatz-ID als Eigenschaft des Knotens.

In der folgenden Tabelle werden die Detail-Trace-Eigenschaften des XMLTransformation-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung:
Trace-Einstellung Ja Nein Off Beginn der ÄnderungDiese Eigenschaft wird nicht mehr unterstützt. Starten Sie stattdessen den Benutzertrace. Der Benutzertrace enthält die gleichen XSL-Traceinformationen. Wenn Sie diese Eigenschaft festlegen, hat dies keine Auswirkungen auf den Benutzertrace.

In früheren Versionen von WebSphere Message Broker legte diese Eigenschaft fest, ob die Tracefunktion aktiv oder inaktiv ist. Ist sie aktiv, werden Tracedaten mit niedriger Detailtiefe in einer Datei gespeichert.

Ende der Änderung
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:28:19

ac12490_