4D Doc Center : DOM Create XML Ref

Home

4D v14.3

DOM Create XML Ref


DOM Create XML Ref ( Root {; Namensraum} {; NameBerName ; NameBerWert} {; NameBerName2 ; NameBerWert2 ; ... ; NameBerNameN ; NameBerWertN} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
Root	String	Name des Root Elements
Namensraum	String	Wert von Namensbereich
NameBerName	String	Name von Namensbereich
NameBerWert	String	Wert von Namensbereich
Funktionsergebnis	String	Referenz auf Root XML Element

Beschreibung

Die Funktion DOM Create XML Ref erstellt im Speicher einen leeren XML Baum und gibt dessen Referenz zurück.

Im Parameter Root übergeben Sie den Namen des Root Elements im XML Baum.

Übergeben Sie im optionalen Parameter Namensbereich die Deklaration des Wertes für den Namensbereich des Baums, z.B. “http:www.4d.com”.
Beachten Sie, dass Sie dem Parameter Root den Namen des Namensbereichs, gefolgt von einem Doppelpunkt, voranstellen können, z.B. “MeinNamensbereich:MeinRoot“.
In diesem Fall ist der Parameter Namensbereich, der den Wert Namensbereich angibt, zwingend.

Hinweis: Über Namensbereich können Sie sicherstellen, dass die XML Variablennamen einmalig sind. Das ist in der Regel eine URL wie http://www.mysite.com/myurl. Die URL muss nicht unbedingt gültig sein, sie muss jedoch einmalig sein.

Sie können über das Paar NameBerName/NameBerWert einen oder mehrere zusätzliche Namensbereiche im angelegten XML Baum festlegen. Sie können beliebig viele Paare übergeben.

Wichtig: Benötigen Sie die Funktion nicht länger, denken Sie daran, den Befehl DOM CLOSE XML mit dieser Referenz aufzurufen, um den Speicher wieder freizumachen.

Beispiel 1

Einen einzelnen XML Baum erstellen:

 C_TEXT(vElemRef)

 vElemRef:=DOM Create XML Ref("MyRoot")

Diese Methode erzeugt folgendes Ergebnis:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?> 
<MyRoot/>

Beispiel 2

Einen XML Baum mit einem einzelnen Namensbereich erstellen:

 C_TEXT(vElemRef)

 $Root:="MyNameSpace:MyRoot"

 $Namespace:="http://www.4D.com/tech/namespace"

 vElemRef:=DOM Create XML Ref($Root;$Namespace)

Diese Methode erzeugt folgendes Ergebnis:

<MyNameSpace:MyRoot xmlns:MyNameSpace="http://www.4D.com/tech/namespace"/>

Beispiel 3

Einen XML Baum mit mehreren Namensbereichen erstellen:

 C_TEXT(vElemRef)

 C_TEXT($aNSName1;$aNSName2;$aNSValue1;$aNSValue2)

 $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)

Diese Methode erzeugt folgendes Ergebnis :

<MyNameSpace:MyRoot xmlns:MyNameSpace="http://www.4D.com/tech/nameSpace"
NSName1="http://www.4D.com/Prod/namespace"
NSName2="http://www.4D.com/Mkt/namespace"/>

Systemvariablen und Mengen

Bei korrekt ausgeführter Funktion wird die Variable OK auf 1 gesetzt, sonst auf 0 (Null) und ein Fehler wird generiert.