XMLGet

XML要素や属性の値

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

構文：

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

パラメータ：

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

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

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

/要素名［［インデックス］］ ［/要素名［［インデックス］］ ... ］

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

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

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

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

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

戻り値：

文字列 …… XMLの解析に成功した場合、要求される要素/属性の値が返ります。

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

• True …… Nullが返ります。

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

注意事項：

• XMLGet関数は、CDATAのコンテンツをサポートします。XMLタグにCDATA部を記述するには、タグの値としてCDATAシーケンス全体を配置してください。

• XMLGetを使用して属性値を取得した場合、属性名がエイリアス名を接頭辞として付加していない場合、名前空間を指定することなく、値を取得しようとします。そして、そのような属性が見つからない場合、Magic xpaはそのコンテナ要素と同じ名前空間URI（URI）を使用して再び取得を試みます。

• XMLGet関数を使用する場合、XMLレスポンス内のコメント行は自動的に削除されます。コメントは、(スキーマで定義されていないため)データ構造の一部ではないので、これは仕様になります。従って、XMLパーザはこれらを無視します。コメント行の使用したい場合は、コメントを定義する代わりに、それを含めた要素を定義することで実現できます。

例：

XMLGet の例

例外：

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

関連トピック：

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