DOM Create XML Ref

DOM Create XML Ref ( racine {; nameSpace} {; nSNom ; nSValeur} {; nSNom2 ; nSValeur2 ; ... ; nSNomN ; nSValeurN} ) : Text

Paramètre	Type		Description
racine	Text	→	Nom de l’élément racine
nameSpace	Text	→	Valeur de l’espace de nommage (Namespace)
nSNom	Text	→	Nom d’espace de nommage
nSValeur	Text	→	Valeur d’espace de nommage
Résultat	Text	←	Référence de l’élément XML racine

Description

La commande DOM Create XML Ref crée un arbre XML vide en mémoire et retourne sa référence.

Passez dans le paramètre racine le nom de l’élément racine de l’arbre XML.

Passez dans le paramètre facultatif nameSpace la déclaration de la valeur de l’espace de nommage (namespace) de l’arbre (par exemple “http://www.4d.com”).
A noter qu'il est possible de préfixer le paramètre racine avec le nom de l’espace de nommage, suivi de : (par exemple “MonNameSpace:MaRacine”). Dans ce cas, le paramètre nameSpace précisant la valeur de l’espace de nommage est obligatoire.

Note : L’espace de nommage (namespace) est une chaîne de caractères permettant de garantir l’unicité des noms de variables XML. En général, un URL du type http://www.monsite.com/monurl est utilisé. Il n’est pas nécessaire que l’URL soit valide sur le site, il faut juste qu’il soit unique.

Vous pouvez déclarer un ou plusieurs espace(s) de nommage supplémentaire(s) dans l’arbre XML généré, à l’aide de couples nSNom / nSValeur. Vous pouvez passer autant de couples nom / valeur d’espace de nommage que vous voulez.

Important : N'oubliez pas d'appeler la commande DOM CLOSE XML afin de libérer la mémoire lorsque vous avez terminé d'utiliser l'arbre XML.

Exemple 1

Création d’un arbre XML simple :

 var vRefElem : Text
 vRefElem:=DOM Create XML Ref("MaRacine")

Ce code produit le résultat suivant :

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

Exemple 2

Création d’un arbre XML avec un espace de nommage :

 var vRefElem : Text
 $Racine:="MonNameSpace:MaRacine"
 $Namespace:="http://www.4D.com/tech/namespace"
 vRefElem:=DOM Create XML Ref($Racine;$Namespace)

Ce code produit le résultat suivant :

<MonNameSpace:MaRacine xmlns:MonNameSpace="http://www.4D.com/tech/namespace"/>

Exemple 3

Création d’un arbre XML avec plusieurs espaces de nommage :

 var vRefElem : Text
 var $aNSNom1;$aNSNom2;$aNSValeur1;$aNSValeur2 : Text
 $Racine:="MonNameSpace:MaRacine"
 $Namespace:="http://www.4D.com/tech/namespace"
 $aNSNom1:="NSNom1"
 $aNSNom2:="NSNom2"
 $aNSValeur1:="http://www.4D.com/Prod/namespace"
 $aNSValeur2:="http://www.4D.com/Mkt/namespace"
 vRefElem:=DOM Create XML Ref($Racine;$Namespace;$aNSNom1;$aNSValeur1;$aNSNom2;$aNSValeur2)

Ce code produit le résultat suivant :

<MonNameSpace:MaRacine xmlns:MonNameSpace="http://www.4D.com/tech/nameSpace"
NSNom1="http://www.4D.com/Prod/namespace"
NSNom2="http://www.4D.com/Mkt/namespace"/>

Variables et ensembles système

Si la commande a été exécutée correctement, la variable système OK prend la valeur 1, sinon elle prend la valeur 0 et une erreur est générée.

Voir aussi

DOM CLOSE XML
DOM SET XML DECLARATION

Propriétés

Numéro de commande	861
Thread safe	✓
Modifie les variables	OK, error