DOM SET XML ELEMENT VALUE
DOM SET XML ELEMENT VALUE ( elementRef {; xPath}; elementValue {; *} )
| 引数 | 型 | 説明 | |
|---|---|---|---|
| elementRef | Text | → | XML要素参照 |
| xPath | Text | → | XML要素のXPathパス |
| elementValue | Text, Variable | → | 要素の新しい値 |
| * | 演算子 | → | 指定時: 値をCDATAに設定 |
説明
DOM SET XML ELEMENT VALUE コマンドを使用して、elementRef で指定した要素の値を更新できます。
オプションのxPath 引数を渡すと、更新する要素の指定にXPath記法を指定したことになります (この記法に関する詳細は、XPath記法のサポート (DOM) を参照してください)。以下のパス式がサポートされます:
| 式 | アクション |
|---|---|
| / | rootノードを指定します(絶対パス) |
| para[1] | コンテキストノードの最初のパラ子を指定します |
| para[last()] | コンテキストノードの最後のパラ子を指定します |
この場合、elementRef 引数にはルートXML 要素の参照を渡し、変更する要素のXPath パスをxPath 引数に渡す必要があります。
互換性に関する注意: v18 R3 以降、4D のXPath 実装はよりXPathに準拠したに変更されました。 互換性上の理由から、以前の標準でない実装は変換されたデータベースではデフォルトでは維持されます。変換されたデータベースにおいて拡張された機能を利用するためには、 互換性ページの互換性オプションの標準XPath を使用するオプションを選択してください。
elementValue には新しい値を格納した文字列、変数またはフィールドを渡します:
- 文字列を渡した場合、値はXML構造の中でそのまま使用されます。
- 変数またはフィールドを渡した場合、4DはelementValue の型に基づき値を処理します。配列やピクチャ、ポインタを除くすべてのデータタイプを使用できます。If elementValue がundefined に評価されてしまった場合、4D は空の文字列を使用します。
オプションのアスタリスクを渡すと、要素の値はCDATAセクションに設定されます。テキストをそのまま挿入するために特別なCDATAの形式が使用されます (例題 2参照)。
注: elementRef で指定された要素がDOM SET XML ELEMENT VALUE コマンドで処理されたBLOB の場合、それは自動でBase64 にエンコードされます。この場合DOM GET XML ELEMENT VALUE は自動で逆の処理を行います。
行末文字の処理についての注意
XML処理のルールに準拠するため、行末文字シークエンス(CRとCRLF)は全てLF文字に変換されます。
例題 1
以下のXMLソースで:
<Book>
<Title>The Best Seller</Title>
</Book>
vElemRef が“Title”要素への参照を持つときに以下のコードを実行すると:
DOM SET XML ELEMENT VALUE(vElemRef;"The Loser")
以下のようになります:
<Book>
<Title>The Loser</Title>
</Book>
例題 2
以下のXMLソースがあるとき:
<Maths>
<Postulate>1+2=3</Postulate>
</Maths>
// Normal form
DOM SET XML ELEMENT VALUE(vElemRef;"12<18")
このコードを実行すると、次のようになります:
<Maths>
<Postulate>12 < 18</Postulate>
</Maths>
// CDATA form
DOM SET XML ELEMENT VALUE(vElemRef;"12<18";*)
このコードを実行すると、次のようになります:
<Maths>
<Postulate><![CDATA[12 < 18]]></Postulate>
</Maths>
システム変数およびセット
コマンドが正しく実行されるとシステム変数OKに1が設定され、そうでなければ0が設定されてエラーが生成されます (例えば要素参照が無効な時など)。