DOM Create XML Ref
DOM Create XML Ref ( root {; nameSpace} {; nameSpaceName ; nameSpaceValue} {; nameSpaceName2 ; nameSpaceValue2 ; ... ; nameSpaceNameN ; nameSpaceValueN} ) : Text
| 引数 | 型 | 説明 | |
|---|---|---|---|
| root | Text | → | ルート要素名 |
| nameSpace | Text | → | 名前空間の値 |
| nameSpaceName | Text | → | 名前空間名 |
| nameSpaceValue | Text | → | 名前空間値 |
| 戻り値 | Text | ← | ルートXML要素参照 |
説明
DOM Create XML Ref コマンドは空のXMLツリーをメモリに作成し、その参照を返します。
root 引数にはXMLツリーのルート要素名を渡します。
オプションのnameSpace 引数にはツリーの名前空間値の定義を渡します (例えば“http://www.4d.com”)。
root引数に名前空間名とコロン、そしてルート要素名を結合した文字列を渡せることができます (例えば“MyNameSpace:MyRoot”)。この場合、名前空間を指定するnameSpace引数は必須となります。
Note: 名前空間は文字列で、XML変数名がユニークであることを保証するために使用されます。一般的に、http://www.mysite.com/myurlのようなURLが使用されます。URLが有効である必要はありませんが、ユニークでなければなりません。
nameSpaceName/nameSpaceValue のペアを使用して、生成されたXMLツリーの中で1つ以上の追加の名前空間を定義できます。
重要: XMLツリーへの作業が終了したら、メモリを解放するために、DOM CLOSE XML コマンドを呼び出してください。
例題 1
ひとつのXMLツリーを作成します:
var vElemRef : Text
vElemRef:=DOM Create XML Ref("MyRoot")
このコードは以下の結果を生成します:
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<MyRoot/>
例題 2
１つの名前空間をもつXMLツリーを作成します:
var vElemRef : Text
$Root:="MyNameSpace:MyRoot"
$Namespace:="http://www.4D.com/tech/namespace"
vElemRef:=DOM Create XML Ref($Root;$Namespace)
このコードは以下の結果を生成します:
<MyNameSpace:MyRoot xmlns:MyNameSpace="http://www.4D.com/tech/namespace"/>
例題 3
複数の名前空間を持つXMLツリーを作成します:
var vElemRef : Text
var $aNSName1;$aNSName2;$aNSValue1;$aNSValue2 : Text
$Root:="MyNameSpace:MyRoot"
$Namespace:="http://www.4D.com/tech/namespace"
$aNSName1:="NSName1"
$aNSName2:="NSName2"
$aNSValue1:="http://www.4D.com/Prod/namespace"
$aNSValue2:="http://www.4D.com/Mkt/namespace"
vElemRef:=DOM Create XML Ref($Root;$Namespace;$aNSName1;$aNSValue1;$aNSName2;$aNSValue2)
このコードは以下の結果を生成します:
<MyNameSpace:MyRoot xmlns:MyNameSpace="http://www.4D.com/tech/nameSpace"
NSName1="http://www.4D.com/Prod/namespace"
NSName2="http://www.4D.com/Mkt/namespace"/>
システム変数およびセット
コマンドが正しく実行されるとシステム変数OKに1が設定され、そうでなければ0が設定されてエラーが生成されます。