<xpath>
構文
<xpath name="xpath"
source="request.MetaDataXML"
property="context.Result" context="/staff/doc"
expression="name[@last='Marston']"/>
エディタは、属性の値を二重引用符で囲みます。このため、属性値に引用符を含める必要がある場合は、ここで示しているように、それらを一重引用符にする必要があります。
属性と要素
必須項目。XPath 式の実行対象とする XML を含むストリームを生成する式。通常、source 属性によりコンテキストまたは要求のプロパティを指定します。
必須項目。評価結果の配置先とするプロパティ (通常はコンテキスト・プロパティ)。
必須項目。ドキュメント・コンテキスト。
必須項目。XPath 式。
オプション。ドキュメントの接頭語マッピングを指定します。これは、接頭語とネームスペースのマッピングをカンマ区切りで記述したリストです。この後の説明を参照してください。最大 255 文字の文字列を指定します。
オプション。スキーマ仕様。最大 255 文字の文字列を指定します。
"一般的な属性と要素" を参照してください。
"一般的な属性と要素" を参照してください。
説明
<xpath> 要素を使用するビジネス・プロセスでは、ターゲットの XML ドキュメントで XPath 式を評価できます。
<xpath> 要素を実行すると、source ストリームが処理されて XPath ドキュメントが生成され、XPath 式が順に評価されます。BPL ランタイム・エンジンは自動的にドキュメントの存続期間を管理し、処理が可能な限り効率的になるようこれらをキャッシュします。
各 prefixmappings エントリは、接頭語、空白、接頭語がマッピングされる URI として定義されます。これは特に、ドキュメントがデフォルトのネームスペースを xmlns="http://somenamespaceuri" 構文で定義しているにもかかわらず、明示的な接頭語マッピングを指定していない場合に有効です。次の prefixmappings 文字列は、myprefix という接頭語を http://somenamespaceuri という URI にマッピングします。文字列中の空白文字に注意してください。
prefixmappings="myprefix http://somenamespaceuri"
BPL の <xpath> 要素は、スカラ値 (単一のテキスト、数値、データなど) を生成する XPath 式のサポートを目的としています。XPath DOM を生成する式を処理することが目的ではありません。つまり、式により DOM が生成される場合、ターゲットのプロパティは更新されません。DOM プログラミングは BPL の範囲外です。ビジネスでこのような処理を必要とする場合は、XPath をコード・ブロックまたはユーティリティ・クラスの呼び出しで実行する必要があります。
