事前定義マッピング関数

メッセージ・マップで使用するための、いくつかの事前定義マッピング関数が用意されています。

この表には、メッセージ・マップと共に使用することのできる事前定義マッピング関数の詳細が載せられています。
名前 パラメーター Return 注
cdata-element 1 つのストリング なし 以下のターゲット・メッセージ・ドメイン内に、CData コンテンツを持つ XML エレメントを作成します。
  • XMLNSC
  • SOAP
  • XMLNS
  • XML
  • JMSMap
  • JMSStream
以下に例を示します。
msgmap:cdata-element('<date><month>05
</month><day>11</day><year>2008</year></date>')
db-path 以下のシグニチャーがサポートされています。

msgmap:db-path(databasePath)

msgmap:db-path(databasePath, delimiter)

なし データベース・パスが XML NCName 形式に準拠していない場合に使用されます。 例えば、データベース・パスに「#」や「$」のような文字が含まれている場合が該当します。

databasePath は $db:select ステートメント、$db:insert ステートメント、$db:update ステートメント、$db:delete ステートメント、$db:proc ステートメント、または $db:func ステートメントのいずれかへの参照です。

delimiter はデータベース・パス内のセグメント同士の間で使用されるストリング・リテラルです。 delimiter のデフォルト値は「.」です。

以下に例を示します。
msgmap:db-path(“$db:select.DB#1.SCH$#1.
CustInfo.Name”)
この例では、デフォルト値「.」が区切り文字として使用されています。
msgmap:db-path(“$db:select/DB#1/SCH$#1/
Cust.Info/Name”, “/”)
この例では、データベース表名にデフォルト値が含まれているので、「/」が区切り文字として使用されています。
occurrence メッセージまたはデータベースからのソース・フィールド ソース・フィールドの索引。 ソースが、特定のオカレンスで特定のステートメントを繰り返し実行する場合に、条件ステートメント中でしばしば使用されます。 以下に例を示します。
msgmap:occurrence
($source/po:purchaseOrder
/items)=2
これは、2 番目のフィールド
po:purchaseOrder
が処理中であることを意味します。 特定のソース・オカレンスを指定する場合には、以前の例と同様のコードを使用してください。 ターゲットに索引値のみを割り当てる場合、以下のコードを指定できます。
msgmap:occurrence
($source/po:purchaseOrder
/items)
exact-type

1- メッセージまたはデータベースからのソース・フィールド
2- ネーム・スペース接頭部
3- タイプの名前

ソースが指定されたタイプで、指定されたネーム・スペースにあるときに True です。 特定のソース・タイプについて特定のステートメントを実行するために、条件内でしばしば使用されます。 以下に例を示します。
msgmap:exact-type
($source/tn1:msg2,'tn1',
'extendedMsgType')
ネーム・スペース接頭部を「*」とすることができます。この文字は、タイプの名前のみが検査されることを示します。 以下に例を示します。
msgmap:exact-type($source/tn1:msg2,'*',
'extendedMsgType')
エレメント
$source/tn1:msg2
が任意の名前空間に
 extendedMsgType
のタイプを持つ場合、TRUE を返します。
empty-element() なし なし 空のタグを持つ XML エレメントを作成します。 例えば、エレメントの名前が MyElement で、MyElement のマッピング式が msgmap:empty-element() に設定された場合、出力メッセージには内容を持たないエレメントが含まれます。
<MyElement/>
この関数は、XML エレメントのためだけに呼び出してください。
element-from-bitstream 以下のシグニチャーがサポートされています。

msgmap:element-from-bitstream(StreamRef)

msgmap:element-from-bitstream(StreamRef, typeExp,
   setExp, formatExp)

msgmap:element-from-bitstream(StreamRef, typeExp,
   setExp, formatExp, encodingExp, ccsidExp)

msgmap:element-from-bitstream(StreamRef, typeExp,
   setExp, formatExp, encodingExp, ccsidExp, options)

なし

ビット・ストリームの構文解析に使用されます。 この関数は、メッセージ・エレメント・ターゲットのためだけに呼び出すことができます。 構文解析されたビット・ストリームは、ターゲット・メッセージ・ツリー内にターゲット・エレメントとして配置されます。

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 であり、評価されて整数となります。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        最終更新
        
        最終更新 : 2012-08-03 11:56:12


参照トピック参照トピック | バージョン 7.0.0.5 | ar25650_