
	バージョン 4.2.5	検索索引目次 \| PDF ブック \| ホーム上へ戻る次へ

— ステートメント —

PARSE XML

`PARSE XML` `operand1` [`INTO` [`PATH` `operand2`] [`NAMEoperand3`] [`VALUEoperand4`]]
[`NORMALIZE`]`NAMESPACE` `operand5PREFIX` `operand6`]
`statement...`
`END-PARSE`	`(structured mode only)`
[`LOOP`]	`(reporting mode only)`

このドキュメントでは、次のトピックについて説明します。

機能
構文説明
例

構文図で使用されている記号については、「構文記号」を参照してください。

関連機能グループ：「インターネットと XML」

機能

PARSE XML ステートメントを使用すると、Natural プログラムから XML ドキュメントを解析できるようになります。『プログラミングガイド』の「インターネットおよび XML アクセス用のステートメント」も参照してください。

スタティック変数の長さを決定することはできないため、PARSE ステートメントを使用するときはダイナミック変数を使用することをお勧めします。スタティック変数を使用すると、変数に書き込まれる値が切り捨てられる可能性があります。

Unicode サポートの詳細については、『Unicode およびコードページのサポート』ドキュメントの「PARSE XML」を参照してください。

マークアップ

（ASCII ベースシステムで）XML ドキュメントの異なるデータタイプを表すためにパス文字列で使用されるマーキングを次に示します。

マーキング	XML データ	パス文字列内の位置
?	処理命令（`<?XML...?>` を除く）	末尾
!	コメント	末尾
C	CDATA セクション	末尾
@	属性（メインフレームでは §）	属性名の前
/	終了タグまたはパス内の親名セパレータ	末尾または親名の間
$	解析したデータ - データ文字列	末尾

パス文字列でこの追加のマークアップを使用することにより、出力ドキュメントで XML ドキュメントの各種要素をより容易に識別できます。

グローバル名前空間

グローバル名前空間を指定するには、接頭辞としてのコロン（:）および空の URI を使用してください。

構文説明

オペランド定義テーブル：

オペランド	構文要素			フォーマット			ステートメント参照	ダイナミック定義
`operand1`	C	S		A	U	B	可	不可
`operand2`		S		A	U	B	可	可
`operand3`		S		A	U	B	可	可
`operand4`		S		A	U	B	可	可
`operand5`		S	A	A	U	B	可	可
`operand6`		S	A	A	U	B	可	可

構文要素の説明：

`operand1`	`operand1` は対象の XML ドキュメントを表します。 XML ドキュメントを解析中に変更することはできません。解析中に XML ドキュメントを変更（例えば、書き込み）しようとすると、エラーメッセージが表示されます。
`operand2`	`operand2` は XML ドキュメントのデータの `PATH` を表します。 `PATH` には、識別された XML 部分の名前、すべての親の名前、および XML 部分のタイプが含まれます。注意: `PATH` で指定された情報を使用して、ツリービューを容易に満たすことができます。「例 1 - `operand2` の使用」も参照してください。
`operand3`	`operand3` は XML ドキュメントのデータ要素の `NAME` を表します。 `NAME` が値を持たない場合、それに関連するダイナミック変数は `*length()=0`（空白で満たされたスタティック変数）に設定されます。「例 2 - `operand3` の使用」も参照してください。
`operand4`	`operand4` は XML ドキュメントのデータ要素の内容（`VALUE`）を表します。値がない場合、所定のダイナミック変数は `*length()=0,`（空白で満たされたスタティック変数）に設定されます。「例 3 - `operand4` の使用」も参照してください。
`operand5` および`operand6` NORMALIZE NAMESPACE PREFIX	`NAMESPACE` URI または URI（`operand5`）および名前空間 `PREFIX`（`operand6`）はランタイム中にコピーされます。したがって、`PARSE XML` ループ内の名前空間マッピング配列の修正はパーサに影響しません。
	`operand5` および`operand6` はオカレンス数の等しい 1 次元配列です。名前空間正規化は `PARSE` ステートメントの機能です。 XML では、要素名に対応する名前空間を定義できます。 <myns:myentity xmlns:myns="http://myuri" /> `NAMESPACE` 定義は次の部分で構成されます。名前空間 `PREFIX`（この場合、`myns`）名前空間を定義する URI（`myuri`）名前空間 `PREFIX` は要素名の一部です。つまり、`PARSE` ステートメントに対して、そして特に`operand2` に対して、生成された `PATH` 文字列は名前空間 `PREFIX` に依存します。 Natural プログラム内のパスが特定のタグを示すために使用される場合、XML ドキュメントで正しい `NAMESPACE`（URI）を異なる `PREFIX` とともに使用すると失敗します。名前空間正規化では、すべての名前空間 `PREFIX` は、`NAMESPACE` 節で定義されているデフォルト値に設定できます。最初のエントリは、URI が複数回指定される場合に使用されます。 XML ドキュメントで複数の `PREFIX` が使用される場合、最初のものだけが出力に考慮されます。残りは無視されます。 `NAMESPACE` 節には、名前空間 URI と接頭辞のペアが含まれます。次に例を示します。 uri(1) := 'http://namespaces.softwareag.com/natural/demo' pre(1) := 'nat:' XML ドキュメント内に `NAMESPACE` が定義されている場合、パーサによってその名前空間（URI）が正規化テーブルに存在するかどうかがチェックされます。正規化テーブルの接頭辞は、XML ドキュメントに定義された名前空間の代わりに、`PARSE` ステートメントからのすべての出力データに対して使用されます。以下の項目も参照してください。例 4 - `operand5` と`operand6` の使用例 5 - 名前空間正規化での`operand5` と`operand6` の使用
	PREFIX に関する追加情報：また、接頭辞定義には次の点が適用されます。名前空間正規化配列の接頭辞定義は、置換される文字列であるため、常にコロン（:）で終了する必要があります。 `PREFIX` または URI は、名前空間正規化配列には 1 回だけ存在できます。 `PREFIX` または `NAMESPACE` URI に末尾の空白が含まれる場合（例えば、スタティック変数の使用時）、外部パーサが呼び出される前に、末尾の空白は削除されます。名前空間正規化での `PREFIX` 定義にコロン（:）のみが含まれる場合、`NAMESPACE PREFIX` は削除されます。

例 1 - `operand2` の使用

次のような XML コードがあるとします。

myxml := '<?xml version="1.0"  ?>'-
         '<employee personnel-id="30016315" >'-
         '<full-name>'-
         '<!--this is just a comment-->'-
         '<first-name>RICHARD</first-name>'-
         '<name>FORDHAM</name>'-
         '</full-name>'-
         '</employee>'

これは、次の Natural コードで処理されます。

PARSE XML myxml INTO PATH mypath
  PRINT mypath
END-PARSE

次の出力を生成します。

employee
employee/@personnel-id
employee/full-name
employee/full-name/!
employee/full-name/first-name
employee/full-name/first-name/$
employee/full-name/first-name//
employee/full-name/name
employee/full-name/name/$
employee/full-name/name//
employee/full-name//
employee//

例 2 - `operand3` の使用

次のような XML コードがあるとします。

myxml := '<?xml version="1.0"  ?>'-  
         '<employee personnel-id="30016315" >'-
         '<full-name>'-
         '<!--this is just a comment-->'-
         '<first-name>RICHARD</first-name>'-
         '<name>FORDHAM</name>'-
         '</full-name>'-
         '</employee>'

これは、次の Natural コードで処理されます。

PARSE XML myxml INTO PATH mypath NAME myname
  DISPLAY (AL=39) mypath myname
END-PARSE

注意:
次の出力を生成します。

               MYPATH                                MYNAME
----------------------------------    -----------------------------------


employee                              employee
employee/@personnel-id                personnel-id
employee/full-name                    full-name
employee/full-name/!
employee/full-name/first-name         first-name
employee/full-name/first-name/$
employee/full-name/first-name//       first-name 
employee/full-name/name               name
employee/full-name/name/$
employee/full-name/name//             name
employee/full-name//                  full-name
employee//                            employee

例 3 - `operand4` の使用

次のような XML コードがあるとします。

myxml := '<?xml version="1.0"  ?>'-  
         '<employee personnel-id="30016315" >'-
         '<full-name>'-
         '<!--this is just a comment-->'-
         '<first-name>RICHARD</first-name>'-
         '<name>FORDHAM</name>'-
         '</full-name>'-
         '</employee>'

これは、次の Natural コードで処理されます。

PARSE XML myxml INTO PATH mypath VALUE myvalue
  DISPLAY (AL=39) mypath myvalue
END-PARSE

次の出力を生成します。

               MYPATH                                MYVALUE
----------------------------------    -----------------------------------


employee
employee/@personnel-id                30016315
employee/full-name
employee/full-name/!                  this is just a comment
employee/full-name/first-name
employee/full-name/first-name/$       RICHARD
employee/full-name/first-name//
employee/full-name/name
employee/full-name/name/$             FORDHAM
employee/full-name/name//
employee/full-name//
employee//

例 4 - `operand5` と`operand6` の使用

次のような XML コードがあるとします。

myxml := '<?xml version="1.0"  ?>'-
         '<nat:employee nat:personnel-id="30016315"'-
         ' xmlns:nat="http://namespaces.softwareag.com/natural/demo">'-
         '<nat:full-Name>'-
         '<nat:first-name>RICHARD</nat:first-name>'-
         '<nat:name>FORDHAM</nat:name>'-
         '</nat:full-Name>'-
         '</nat:employee>'

これは、次の Natural コードで処理されます。

PARSE XML myxml INTO PATH mypath
  PRINT mypath
END-PARSE

次の出力を生成します。

nat:employee
nat:employee/@nat:personnel-id
nat:employee/@xmlns:nat
nat:employee/nat:full-Name
nat:employee/nat:full-Name/nat:first-name
nat:employee/nat:full-Name/nat:first-name/$  
nat:employee/nat:full-Name/nat:first-name//
nat:employee/nat:full-Name/nat:name
nat:employee/nat:full-Name/nat:name/$
nat:employee/nat:full-Name/nat:name//
nat:employee/nat:full-Name//
nat:employee//

例 5 - 名前空間正規化での`operand5` と`operand6` の使用

NORMALIZE NAMESPACE を使用すると、例 4 のような NAMESPACE PREFIX の異なる同じ XML ドキュメントでまったく同じ出力が生成されます。

XML コード：

myxml := '<?xml version="1.0"  ?>'-
         '<natural:employee natural:personnel-id="30016315"'-
         ' xmlns:natural="http://namespaces.softwareag.com/natural/demo">'-  
         '<natural:full-Name>'-
         '<natural:first-name>RICHARD</natural:first-name>'-
         '<natural:name>FORDHAM</natural:name>'-
         '</natural:full-Name>'-
         '</natural:employee>'

Natural コード：

uri(1) := 'http://namespaces.softwareag.com/natural/demo'
pre(1) := 'nat:'
*
PARSE XML myxml INTO PATH mypath NORMALIZE NAMESPACE uri(*) PREFIX pre(*)  
  PRINT mypath
END-PARSE

上記プログラムの出力：

nat:employee
nat:employee/@nat:personnel-id
nat:employee/@xmlns:nat
nat:employee/nat:full-Name
nat:employee/nat:full-Name/nat:first-name
nat:employee/nat:full-Name/nat:first-name/$  
nat:employee/nat:full-Name/nat:first-name//
nat:employee/nat:full-Name/nat:name
nat:employee/nat:full-Name/nat:name/$
nat:employee/nat:full-Name/nat:name//
nat:employee/nat:full-Name//
nat:employee//

検索索引目次 | PDF ブック | ホーム上へ戻る次へ

PARSE XML

機能

マークアップ

グローバル名前空間

関連するシステム変数

構文説明

例

例 1 - operand2 の使用

例 2 - operand3 の使用

例 3 - operand4 の使用

例 4 - operand5 とoperand6 の使用

例 5 - 名前空間正規化でのoperand5 とoperand6 の使用

例 1 - `operand2` の使用

例 2 - `operand3` の使用

例 3 - `operand4` の使用

例 4 - `operand5` と`operand6` の使用

例 5 - 名前空間正規化での`operand5` と`operand6` の使用