XMLTransformation ノードを含むメッセージ・フローをマイグレーションする場合に、WebSphere® Message Broker バージョン
7.0 がノード・プロパティーを使用して優先順位を検索する方法を確認します。
このタスクを実行する必要があるのは、バージョン 6.0 からマイグレーションする場合です。バージョン 6.1 からのマイグレーションは必要ありません。
バージョン 6.0 の XMLTransformation ノードは、バージョン
7.0 で XSLTransform ノードに置き換えられました。 1 つ以上の XMLTransformation ノードを含むフローをマイグレーションする場合は、次の機能拡張を考慮に入れます。
- WebSphere Message Broker Toolkit 内のノード・プロパティーで、スタイル・シート検索および文字セット情報の優先順位を設定することはできなくなりました。 以下の固定検索優先順位が採用されます。 ただし、既存のフローに設定された検索優先順位は順守されます。
- このノードは、使用されるスタイル・シートの名前を、以下の各項目について順番に問い合わせることにより検索します。
- 入力メッセージ。 ノードは、スタイルシートのロケーション情報を求めてメッセージ XML データを検索します。 例えば、XML データに以下のエントリーが含まれているとします。
<?xml-stylesheet type="text/xsl" href="aaa.xsl"?>
このノードは、スタイルシート名として "aaa.xsl" を使用します。
- ローカル環境。 入力メッセージにスタイルシート名が見つからない場合、ノードは、XSL.StyleSheetName と呼ばれるエレメント内に保管されているスタイルシート情報に関する現行メッセージと関連したローカル環境を検索します。
バージョン 6.0 ではエレメント ComIbmXslXmltStylesheetname がスタイルシート名に使用されているので、現行ノードでは両方のエレメントを検査します。 両方が存在する場合、XSL.StyleSheetName 内の値が優先されます。
- ノードのプロパティー。 入力メッセージまたはローカル環境内にスタイルシート名が見つからない場合、ノードは、「スタイルシート名」プロパティーおよび 「スタイルシート・ディレクトリー」プロパティーを使用して、正しい値を判別します。
- このノードは、出力メッセージに使用する文字セットを、以下の各項目について順番に問い合わせることにより検索します。
- ローカル環境。 ノードは、XSL.OutputCharSet と呼ばれるエレメント内に保管されている文字セット情報に関する現行メッセージと関連したローカル環境を検索します。例えば、変換の出力を UTF-16 としてエンコードするには、このエレメント内のストリングとして値 1200 を入力します。
バージョン 6.0 ではエレメント ComIbmXslXmltOutputcharset が出力文字セットに使用されているので、現行ノードでは両方のエレメントを検査します。 両方が存在する場合、XSL.OutputCharSet の値が優先されます。
- ノードのプロパティー。 ローカル環境内で文字セット情報が見つからない場合、ノードは、「出力文字セット」プロパティーを使用して、正しい値を判別します。
値が設定されていないか、選択優先順位がゼロに設定されているために、ノードがこれらの 2 つのソースのどちらからも出力文字セットを判別できない場合は、デフォルト値
1208 (UTF-8) が使用されます。
- 追加のノード・プロパティーを設定するか、または追加のローカル環境指定変更を使用して、出力メッセージのメッセージ・ドメイン、メッセージ・セット、メッセージ・タイプ、およびメッセージ形式を指定することができます。 メッセージを XSLTransform ノードに渡す前に、これらの値を設定するための ResetContentDescriptor ノードを組み込んだ場合、次に、ResetContentDescriptor ノードを除去することによってメッセージ・フローを最適化することができます。