CA Process Automation システム関数 › applyXPath

applyXPath

XPath クエリを使用して XML データを抽出し、クエリの結果のノードをリスト表示する XML フラグメントを返します。

構文

sXML = applyXPath(xmlData, xpathQuery, namespaceAware, returnArray)

引数

xmlData (String)

XPath クエリを実行する XML を定義します。

xpathQuery (String)

実行する XPath クエリを定義します。

namespaceAware (Boolean)

（オプション） XPath クエリを適用する前にネーム スペースを削除するかどうかを指定します。

値：

True： CA Process Automation は XPath クエリを適用する前に名前スペースを削除しません。

False： CA Process Automation は XPath クエリを適用する前に名前スペースを削除して、クエリをシンプルにします。

デフォルト： はい

returnArray （ブール）

（オプション）結果の配列を返すか、単一の文字列を返すかを指定します。

値：

True： 関数は結果の配列を返します。

False： 関数は、文字列内に連結された複数の結果を含む単一の文字列を返します。

デフォルト： いいえ

注： XPath クエリによって一致が検出されない場合は、空白の配列が返されます。

戻り値と例

returnArray 引数の値に基づく以下のいずれかの戻り値。

• returnArray が false の場合：

  sXML (String)

  returnArray 引数を省略するか、それを False に設定した場合、クエリによってこの値が返されます。 戻り値は、ノードをリスト表示する XML フラグメントです。 例：

  Process.xpathResult = applyXPath(Process.bookXML, "/bookstore/book[2]", true, false);
  

• returnArray が true の場合：

  sXMLArray (C2OValueArray)

  returnArray 引数を True に設定した場合、エリによってこの値が返されます。 戻り値は C2OValueArray で、各要素はノードの XML フラグメントになっています。 例：

  Process.xpathArrayResult = applyXPath(Process.bookXML, "/bookstore/book", true, true);