4D Doc Center : DOM Append XML child node

Home

4D v14.3

DOM Append XML child node


DOM Append XML child node ( ElementRef ; KindTyp ; KindWert ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
ElementRef	Text	XML Element Referenz
KindTyp	Lange Ganzzahl	Typ des anzuhängenden Kindelements
KindWert	Text, BLOB	Text oder Variable (Text oder BLOB), dessen Wert als Kindknoten eingefügt werden soll.
Funktionsergebnis	Text	Referenz des Kind XML Elements

Beschreibung

Die Funktion DOM Append XML child node hängt den Wert KindWert an den in ElementRef definierten XML Knoten an.

Der Typ des erstellten Knotens wird im Parameter KindTyp definiert. Sie können eine der nachfolgenden Konstanten unter dem Thema XML übergeben:

Konstante	Typ	Wert
XML CDATA	Lange Ganzzahl	7
XML comment	Lange Ganzzahl	2
XML DATA	Lange Ganzzahl	6
XML DOCTYPE	Lange Ganzzahl	10
XML ELEMENT	Lange Ganzzahl	11
XML processing instruction	Lange Ganzzahl	3

In KindWert übergeben Sie die einzufügenden Daten. Sie können einen String oder eine 4D Variable übergeben (String oder BLOB). Der Inhalt dieses Parameters wird immer in Text konvertiert.

Hinweis: Gibt der Parameter ElementRef den Dokumentknoten an (Knoten auf der obersten Ebene), fügt die Funktion einen Knoten "Doctype" vor allen anderen Knoten ein. Das gleiche gilt auch für Arbeitsanweisungen und Kommentare. Sie werden immer vor dem Root Knoten, aber nach dem Doctype Knoten, eingefügt.

Beispiel 1

Knoten vom Typ Text hinzufügen:

 Reference:=DOM Create XML element(elementRef;"myElement")

 DOM SET XML ELEMENT VALUE(Reference;"Hallo")

 temp:=DOM Create XML element(Reference;"br")

 temp:=DOM Append XML child node(Reference;XML DATA;"New")

 temp:=DOM Create XML element(Reference;"br")

 temp:=DOM Append XML child node(Reference;XML DATA;"York")

Ergebnis:

<myElement>Hallo<br/>New<br/>York</myElement>

Beispiel 2

Knoten vom Typ Arbeitsanweisung hinzufügen:

 $Txt_instruction:="xml-stylesheet type = \"text/xsl\" href=\"style.xsl\""

 Reference:=DOM Append XML child node(elementRef;XML Processing Instruction;$Txt_instruction)

Ergebnis (vor dem ersten Element eingefügt):

<?xml-stylesheet  type="text/xsl" href="style.xsl"?>

Beispiel 3

Knoten vom Typ Kommentar hinzufügen:

Reference:=DOM Append XML child node(elementRef;XML Comment;"Hallo Welt")

Ergebnis:

<!--Hallo Welt-->

Beispiel 4

Knoten vom Typ CDATA hinzufügen:

Reference:=DOM Append XML child node(elementRef;XML CDATA;"12 < 18")

Ergebnis:

<element><![CDATA[12  < 18]]></element>

Beispiel 5

Knoten vom Typ Doctype declaration hinzufügen oder ersetzen:

Reference:=DOM Append XML child node(elementRef;XML DOCTYPE;"Books SYSTEM \"Book.DTD\"")

Ergebnis (vor dem ersten Element eingefügt):

<!DOCTYPE Books SYSTEM  "Book.DTD">

Beispiel 6

Knoten vom Typ Element hinzufügen oder ersetzen:

Ist der Parameter KindWert ein XML Fragment, wird er als Kindknoten eingefügt:
Reference:=DOM Append XML child node(elementRef;XML ELEMENT;"<child>simon</child><child>eva</child>")

Ergebnis:
```
<parent>
     <child>simon</child>
    <child>eva</child>
</parent>
```
andernfalls wird ein neues leeres Kindelement angefügt
Reference:=DOM Append XML child node(elementRef;XML ELEMENT;"tbreak")

Ergebnis:
```
<parent>
     <tbreak/>
 </parent>
```

Ist der Inhalt von KindWert nicht gültig, wird ein Fehler zurückgegeben.