以前のバージョンの IBM® Integration Bus のメッセージ・マップをグラフィカル・データ・マップに変換する際、メッセージング・ソリューションでグラフィカル・データ・マップを使用するためには、その前に追加のタスクを完了しておかなければならない場合もあります。
メッセージ・マップをグラフィカル・データ・マップに変換する準備をしている場合は、以下の点を考慮する必要があります。
- グラフィカル・データ・マップは、ブローカーの Java™ 仮想マシン内で実行されます。
ブローカーが正しく構成されていることを確認してください (JVM ヒープ・サイズの設定を参照)。
- グラフィカル・データ・マップのデータベース変換では、IBM Integration Bus に組み込まれた JDBC 接続のサポートが使用されます。
メッセージ・マップというリレーショナル・データベース操作をグラフィカル・データ・マッピング変換に変換するには、グラフィカル・データ・マッピング・エディターでさらに処置を行う必要があります。
詳しくは、データベースの内容のマッピングを参照してください。
- グラフィカル・データ・マップは、ソースとしてのみデプロイできます。
グラフィカル・データ・マップをデプロイするには、以下のようにします。
- 入出力メッセージのためにメッセージ・モデル・スキーマを提供します。
XML メッセージの場合は、XML スキーマ・ファイルを提供する必要があります。
テキスト・メッセージやバイナリー・メッセージの場合は、DFDL スキーマ・ファイルまたはメッセージ・セットを使用してモデルを提供できます。
- メッセージがメッセージ・セット内でモデル化されている場合、グラフィカル・データ・マップを実行するには、グラフィカル・データ・マップのためのメッセージ・セット・スキーマ (.xsdzip ファイル) をデプロイする必要があります。
既存のメッセージ・セットがテキスト形式およびバイナリー形式のみに使用される場合、ブローカー・アーカイブ (BAR) に .dictionary ファイルが含まれる グラフィカル・データ・マップ しかデプロイできません。
この場合は、メッセージ・セットを変更して XMLNSC ドメイン・サポート・オプションを追加で設定する必要があります。こうすることで、.dictionary ファイルと .xsdzip ファイルの両方が含まれるメッセージ・セットが BAR に追加されるようになります。
このオプションを設定しないと、「問題」ビューに警告とクイック・フィックス・アクションが表示されます。
- 変換後のメッセージ・マップに、ユーザーから提供された ESQL プロシージャーの呼び出しが含まれる場合、それらの呼び出しはカスタム ESQL 変換に変換されます。
グラフィカル・データ・マップで ESQL プロシージャーを呼び出すには、特定の要件を満たしている必要があります。
詳しくは、カスタム ESQLを参照してください。以下の側面を考慮する必要があります。
- ESQL モジュールは、ソースとしてデプロイされます。
ブローカー・アーカイブへのファイルの追加を参照してください。
- IBM Integration Bus アプリケーションもライブラリー機能も使用していない場合、ESQL プロシージャーは統合サーバーにデプロイされるので、ESQL プロシージャーには一意的な名前を付ける必要があります。
- ESQL REFERENCE データ・タイプを使用する ESQL プロシージャーを呼び出している箇所は、変換後のグラフィカル・データ・マップでは Task 変換に置き換えられます。
これらの Task 変換はそれぞれ、同等の機能を提供するカスタム XPath 変換、カスタム Java 変換、またはカスタム ESQL 変換に置き換える必要があります。
- 変換後のメッセージ・マップに、事前定義メッセージ・マップ (msgmap:) 関数の呼び出しが含まれている場合、それらの変換はそれぞれ、XPath 変換またはカスタム XPath 変換に変換されます。
それらの置き換えられた変換については、必要な振る舞いを再現しているかどうか、よく検討する必要があります。
メッセージ・マップ関数と同等の XPath がない場合は、グラフィカル・データ・マップ内で Task 変換に置き換えられます。
これらの Task 変換はそれぞれ、必要な振る舞いを再現するカスタム XPath 変換、カスタム Java 変換、またはカスタム ESQL 変換に置き換える必要があります。
以下のメッセージ・マップ関数には、同等の XPath がありません。
- msgmap:element-from-bitstream
- msgmap:cdata-element
- msgmap:db-path
- カスタム XPath 変換で Cast 変換および XML スキーマ関数を使用して、値タイプのキャストを行えます。
詳しくは、CastおよびESQL タイプとスキーマ・タイプを参照してください。
- 欠落エレメント、空エレメント、または nil が設定されたエレメントのための処理を組み込んだ変換用のメッセージ・マップを変換する場合は、ヌル値の処理を参照してください。
これらの変換を実装できるように、以下の XPath 関数が用意されています。
- fn:empty は、エレメントの値が空かどうかをテストします。
- fn:nilled は、XML エレメントに xsi:nil 属性が設定されているかどうかをテストします。
- fn:exists は、エレメントが存在するかどうかをテストします。
xsi:nil 属性が設定された XML エレメントは、存在していると見なされます。
- 変換後のメッセージ・マップに、事前定義 ESQL マップ (esql:) 関数の呼び出しが含まれている場合、それらの呼び出しはそれぞれ、XPath 変換またはカスタム XPath 変換に変換されます。
それらの置き換えられた変換については、必要な振る舞いを再現しているかどうか、よく検討する必要があります。
ESQL マップ関数と同等の XPath がない場合は、グラフィカル・データ・マップ内で Task 変換に置き換えられます。
これらの Task 変換はそれぞれ、必要な振る舞いを再現するカスタム XPath 変換、カスタム Java 変換、またはカスタム ESQL 変換に置き換える必要があります。
以下の ESQL マップ関数には、同等の XPath がありません。
- 一部の数学関数:
- ACOS
- ASIN
- ATAN
- ATAN2
- BITAND
- BITNOT
- BITOR
- BITXOR
- COS
- COSH
- COT
- DEGREES
- EXP
- LN
- LOG
- LOG10
- MOD
- POWER®
- RADIANS
- RAND
- SIGN
- SIN
- SINH
- SQRT
- TAN
- TANH
- 10 進関数:
- 一部のストリング関数:
- LTRIM
- RTRIM
- TRIM-LEADING
- TRIM-TRAILING
- REPLICATE
- SPACE
- 一部のフィールド関数:
- ABITSTREAM
- BITSTREAM
- SAMEFIELD
- 一部の日時関数:
- TIMESTAMP
- CURRENT-GMTDATE
- CURRENT-GMTTIME
- CURRENT-GMTTIMESTAMP
- すべての INTERVAL- 関数
- ESQL LIKE 関数
- ESQL FOLLOWING 形式の ESQL POSITION 関数
- すべての SQL 関数
- UUIDASCHAR および UUIDASBLOB 関数