XMLBlobGet

 

XML要素またはXML 属性の値

要素パスに基づいたXML要素またはXML属性の値を取得します。

構文:

XMLBlobGet(世代番号, ファイル番号, 要素パス, 属性名, 存在確認)

パラメータ:

  • 世代番号 …… タスクの階層位置を表す番号。カレントのタスクが0、親タスクが1、その親タスクが2 などとなります。

  • ファイル番号  …… 指定されたタスクの(「XMLダイレクトアクセス」または、「項目」が設定された)[入出力ファイル]テーブルの番号

  • 要素パス …… XML 要素のパスを表す文字列。 パス文字列の構文は、以下の通りです。

 

/要素名[[インデックス]] [/要素名[[インデックス]] ... ]

 

  • 要素名 …… XML 要素の名前です。エイリアスを指定することができます。エイリアスは、「all:My_Element」のように、コロン(:)で要素名と分けて指定します。

  • インデックス …… 複数存在する中の特定の要素を示すインデックス。インデックス値は、1以上の値を指定してください。

要素パスのスラッシュ「/」は、区切り文字です。

  • 属性名 …… 指定された要素の中に定義されたXML属性名

  • 存在確認 …… (オプション)要求する要素/属性が見つかった場合に知らせるかどうかを指定する論理値

戻り値:

BLOB値 …… XMLの解析に成功した場合、要求される要素の値が返ります。

失敗した場合、[存在確認]オプションの設定内容に基づいて以下の内容を返します。

  • True …… Nullが返ります。

  • False(または指定されていない場合) …… 空白が返ります。

例:

XMLBlobGet の例

例外:

リッチクライアントタスクではサポートされません。

関連トピック:

XML のネームスペース , XML 関数のエラーコード , XMLGet