Bei der Migration eines Nachrichtenflusses, der
XMLTransformation-Knoten enthält, müssen Sie prüfen, wie die Knoteneigenschaften und
Suchprioritäten von WebSphere Message
Broker Version
7.0
verwendet werden.
Sie müssen diese Aufgabe ausführen, wenn Sie eine Migration von
Version 6.0 durchführen; eine Migration von
Version 6.1 ist nicht erforderlich.
Der
XMLTransformation-Knoten in Version 6.0 wird durch den
XSLTransform-Knoten in
Version
7.0 ersetzt. Bei der Migration eines Nachrichtenflusses, der einen oder mehrere
XMLTransformation-Knoten enthält, sind folgende funktionale Erweiterungen zu beachten:
- Die Formatvorlagensuche und die Suchprioritäten der Zeichensatzinformationen können nicht mehr in den Knoteneigenschaft der WebSphere Message
Broker Toolkit festgelegt werden. Die folgenden festgelegten Suchprioritäten werden übernommen. Die in vorhandenen Nachrichtenflüssen festgelegten Suchprioritäten werden jedoch weiterhin berücksichtigt.
- Der Knoten sucht den Namen der zu verwendenden Formatvorlage, indem er eine Abfrage der einzelnen Einträge in der folgenden Reihenfolge vornimmt:
- Eingabenachricht. Der Knoten durchsucht die XML-Nachrichtendaten nach der Position der Formatvorlage. Die XML-Daten können beispielsweise
folgenden Eintrag enthalten:
<?xml-stylesheet type="text/xsl" href="aaa.xsl"?>
In diesem Fall verwendet der Knoten "aaa.xsl" als Formatvorlagennamen.
- Die lokale Umgebung. Wenn in der Eingabenachricht kein Name für die Formatvorlage gefunden
wird, durchsucht der Knoten die der Nachricht zugeordnete lokale Umgebung nach den
Formatvorlageinformationen, die im Element 'XSL.StyleSheetName' gespeichert sind.
Da das Element
'ComIbmXslXmltStylesheetname' in Version 6.0 als Name der
Formatvorlage verwendet wurde, überprüft der Knoten beide Elemente. Sind beide Werte vorhanden, hat der Wert in 'XSL.StyleSheetName' Vorrang.
- Die Eigenschaften des Knotens. Wenn in der Eingabenachricht oder in der lokalen Umgebung kein
Name für die Formatvorlage gefunden wird, verwendet der Knoten die Eigenschaften
Name der Formatvorlage und
Verzeichnis für Formatvorlagen zum Ermitteln der
richtigen Werte.
- Der Knoten sucht die Zeichensätze, die für die Ausgabenachricht verwendet werden sollen, indem er eine Abfrage der einzelnen folgenden Einträge vornimmt:
- Die lokale Umgebung. Der Knoten durchsucht die der Nachricht zugeordnete lokale Umgebung nach
den Zeichensatzinformationen, die im Element 'XSL.OutputCharSet' gespeichert sind. Geben Sie
beispielsweise den Wert 1200 als Zeichenfolge für
dieses Element an, wenn die Ausgabe der Umwandlung in UTF-8 codiert werden soll.
Da das Element
'ComIbmXslXmltOutputcharset' in Version 6.0 als Ausgabezeichensatz
verwendet wurde, überprüft der Knoten beide Elemente. Sind beide Werte vorhanden, hat der Wert
in 'XSL.OutputCharSet' Vorrang.
- Die Eigenschaften des Knotens. Wenn in der lokalen Umgebung keine Zeichensatzinformationen
gefunden werden, ermittelt der Knoten auf Grundlage der Eigenschaft
Ausgabezeichensatz den korrekten Wert.
Kann der Knoten den Ausgabezeichensatz nicht auf Grundlage einer dieser beiden Quellen ermitteln, weil entweder kein Wert festgelegt ist oder die Auswahlprioritäten auf null gesetzt sind, wird der Standardwert
1208 (UTF-8) verwendet.
- Sie können zusätzliche Knoteneigenschaften festlegen oder mithilfe zusätzlicher
Überschreibungen der lokalen Umgebung die Nachrichtendomäne, den Nachrichtensatz, den
Nachrichtentyp und das Nachrichtenformat der Ausgabenachricht angeben. Wenn Sie einen ResetContentDescriptor-Knoten eingefügt haben, um diese Werte vor der Übergabe der Nachricht an den XSLTransform-Knoten festzulegen, können Sie den Nachrichtenfluss jetzt optimieren, indem Sie den ResetContentDescriptor-Knoten entfernen.