メッセージ・マップで使用するための、いくつかの事前定義マッピング関数が用意されています。
| 名前 | パラメーター | Return | 注 |
|---|---|---|---|
| cdata-element | 1 つのストリング | なし | 以下のターゲット・メッセージ・ドメイン内に、CData コンテンツを持つ XML エレメントを作成します。
|
| db-path | 以下のシグニチャーがサポートされています。 msgmap:db-path(databasePath) |
なし | データベース・パスが XML NCName 形式に準拠していない場合に使用されます。 例えば、データベース・パスに「#」や「$」のような文字が含まれている場合が該当します。 databasePath は $db:select ステートメント、$db:insert ステートメント、$db:update ステートメント、$db:delete ステートメント、$db:proc ステートメント、または $db:func ステートメントのいずれかへの参照です。 delimiter はデータベース・パス内のセグメント同士の間で使用されるストリング・リテラルです。 delimiter のデフォルト値は「.」です。 以下に例を示します。
この例では、デフォルト値「.」が区切り文字として使用されています。
この例では、データベース表名にデフォルト値が含まれているので、「/」が区切り文字として使用されています。 |
| occurrence | メッセージまたはデータベースからのソース・フィールド | ソース・フィールドの索引。 | ソースが、特定のオカレンスで特定のステートメントを繰り返し実行する場合に、条件ステートメント中でしばしば使用されます。
以下に例を示します。
これは、2 番目のフィールド
が処理中であることを意味します。 特定のソース・オカレンスを指定する場合には、以前の例と同様のコードを使用してください。 ターゲットに索引値のみを割り当てる場合、以下のコードを指定できます。
|
| exact-type | 1- メッセージまたはデータベースからのソース・フィールド |
ソースが指定されたタイプで、指定されたネーム・スペースにあるときに True です。 | 特定のソース・タイプについて特定のステートメントを実行するために、条件内でしばしば使用されます。 以下に例を示します。
ネーム・スペース接頭部を「*」とすることができます。この文字は、タイプの名前のみが検査されることを示します。
以下に例を示します。
エレメント
が任意の名前空間に
のタイプを持つ場合、TRUE を返します。 |
| empty-element() | なし | なし | 空のタグを持つ XML エレメントを作成します。 例えば、エレメントの名前が MyElement で、MyElement のマッピング式が msgmap:empty-element() に設定された場合、出力メッセージには内容を持たないエレメントが含まれます。
この関数は、XML エレメントのためだけに呼び出してください。 |
| element-from-bitstream | 以下のシグニチャーがサポートされています。 msgmap:element-from-bitstream(StreamRef) |
なし | ビット・ストリームの構文解析に使用されます。 この関数は、メッセージ・エレメント・ターゲットのためだけに呼び出すことができます。 構文解析されたビット・ストリームは、ターゲット・メッセージ・ツリー内にターゲット・エレメントとして配置されます。 StreamRef はストリームの BLOB に対する参照で、 $source/BLOB または $db:select.dsn.schema.table.column などです。 typeExp は、メッセージ本文の名前を示すストリング・リテラルで purchaseOrder などであり、オプションでネーム・スペース URI によって修飾されて {http://www.ibm.com}:purchaseOrder などとなります。 setExp は、メッセージ・セットの名前を示すストリング・リテラルで、PurchaseOrder などです。 formatExp は、メッセージのワイヤー形式を示すストリング・リテラルで、XML1 などです。 encodingExp および ccsidExp は、 評価されて ESQL ENCODING および CCSID 定数に対応する値を持つ整数となります。 options は ESQL 定数または ESQL 定数の bit-or であり、評価されて整数となります。 |