4D Doc Center : DOM Create XML element

Home

4D v14.3

DOM Create XML element


DOM Create XML element ( ElementRef ; xPath {; attrName ; attrWert} {; attrName2 ; attrWert2 ; ... ; attrNameN ; attrWertN} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
ElementRef	String	Referenz auf Root XML Element
xPath	Text	Pfad xPath des zu erstellenden XML Elements
attrName	String	Zu setzendes Attribut
attrWert	String, Boolean, Lange Ganzzahl, Zahl, Zeit, Datum	Wert des neuen Attributs
Funktionsergebnis	String	Referenz auf erstelltes XML Element

Beschreibung

Die Funktion DOM Create XML element erstellt ein neues Element im XML Element, definiert in ElementRef im Pfad, definiert in xPath und fügt bei Bedarf Attribute hinzu.

In ElementRef übergeben Sie die Referenz auf das Root Element, z.B. erstellt mit DOM Create XML Ref.

In xPath übergeben Sie den Zugriffspfad im XML Format des zu erstellenden Elements. In diesem Fall ist das XPath Format verwendbar. Weitere Informationen dazu finden Sie im Abschnitt Überblick über XML DOM Befehle. Gibt es keine Elemente des Pfads, werden sie angelegt.

Im Parameter xPath können Sie direkt den Namen eines Eintrags übergeben, um vom aktuellen Eintrag einen Untereintrag zu erstellen (siehe Beispiel 3).

Hinweis: Haben Sie einen oder mehrere Namensbereiche für den Baum gesetzt, definiert in ElementRef (siehe Befehl DOM Create XML Ref), muss dem Parameter xPath der Name des verwendeten Bereichs vorangestellt werden (zum Beispiel “MyNameSpace:MyElement”).

In den optionalen Parametern attrName und attrWert können Sie Paare Attribute/Attributwerte in Form von Variablen, Feldern oder tatsächlichen Werten übergeben. Sie können beliebig viele Paare übergeben.

Sie können jetzt in attrWert auch einen Wert übergeben, der nicht vom Typ Text ist, das kann Boolean, Ganzzahl, Zahl, Datum oder Zeit sein. 4D steuert die Umwandlung in Text gemäß den folgenden Vorgaben:

Typ	Beispiel für konvertierten Wert
Boolean	"Wahr" oder "Falsch" (nicht übersetzt)
Ganzzahl	"123456"
Zahl	"12.34" (Dezimaltrenner ist immer ".")
Datum	"2006-12-04T00:00:00Z" (RFC 3339 Standard)
Zeit	"5233" (Anzahl Sekunden)

Die Funktion gibt als Ergebnis die XML Referenz des erstellten Elements zurück.

Beispiel 1

Sie wollen folgendes Element erstellen:

 <?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<RootElement>
   <Elem1>
      <Elem2>
         <Elem3> </Elem3>
         <Elem3> </Elem3>
      </Elem2>
   </Elem1>
</RootElement>

Dazu schreiben Sie:

 C_TEXT(vRootRef;vElemRef)

 vRootRef:=DOM Create XML Ref("RootElement")

 vxPath:="/RootElement/Elem1/Elem2/Elem3"

 vElemRef:=DOM Create XML element(vRootRef;vxPath)

 vxPath:="RootElement/Elem1/Elem2/Elem3[2]"

 vElemRef:=DOM Create XML element(vRootRef;vxPath)

Beispiel 2

Sie wollen folgendes Element mit Attributen erstellen:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<RootElement>
   <Elem1>
      <Elem2>
         <Elem3 Font=Verdana Size=10> </Elem3>
      </Elem2>
   </Elem1>
</RootElement>

Dazu schreiben Sie:

 C_TEXT(vRootRef;vElemRef)

 C_TEXT($aAttrName1;$aAttrName2;$aAttrVal1;$aAttrVal2)

 $aAttrName1:="Font"

 $aAttrName2:="Size"

 $aAttrVal1:="Verdana"

 $aAttrVal2:="10"

 

 vRootRef:=DOM Create XML Ref("RootElement")

 vxPath:="/RootElement/Elem1/Elem2/Elem3"

 vElemRef:=DOM Create XML element(vRootRef;vxPath;$aAttrName1;$aAttrVal1;

 $aAttrName2;$aAttrVal2)

Beispiel 3

Sie wollen folgende Struktur erstellen und exportieren:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<Root>
   <Elem1>Hello</Elem1>
</Root>

Dazu verwenden Sie die Syntax, die auf einem einfachen Eintragsnamen basiert. Dazu schreiben Sie:

 C_TEXT($root)

 C_TEXT($ref1)

 

 $root:=DOM Create XML Ref("Root")

 $ref1:=DOM Create XML element($root;"Elem1")

 DOM SET XML ELEMENT VALUE($ref1;"Hello")

 DOM EXPORT TO FILE($root;"mydoc.xml")

 DOM CLOSE XML($root)

Systemvariablen und Mengen

Bei korrekt ausgeführtem Befehl wird die Systemvariable OK auf 1 gesetzt, sonst auf 0 (Null) und ein Fehler wird zurückgegeben.

Fehlerverwaltung

Ein Fehler wird erzeugt, wenn:

Die Referenz auf das Root Element ungültig ist.
Der Name des zu erstellenden Elements ungültig ist, z.B. wenn er mit einer Zahl beginnt.