4D v14.3

DOM Creer ref XML

Accueil

 
4D v14.3
DOM Creer ref XML

DOM Creer ref XML 


 

DOM Creer ref XML ( racine {; nameSpace} {; nSNom ; nSValeur} {; nSNom2 ; nSValeur2 ; ... ; nSNomN ; nSValeurN} ) -> Résultat 
Paramètre Type   Description
racine  Chaîne in Nom de l’élément racine
nameSpace  Chaîne in Valeur de l’espace de nommage (Namespace)
nSNom  Chaîne in Nom d’espace de nommage
nSValeur  Chaîne in Valeur d’espace de nommage
Résultat  Chaîne in Référence de l’élément XML racine

La commande DOM Creer ref XML 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 FERMER XML afin de libérer la mémoire lorsque vous avez terminé d'utiliser l'arbre XML.

Création d’un arbre XML simple :

 C_TEXTE(vRefElem)
 vRefElem:=DOM Creer ref XML("MaRacine")

Ce code produit le résultat suivant :

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

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

 C_TEXTE(vRefElem)
 $Racine:="MonNameSpace:MaRacine"
 $Namespace:="http://www.4D.com/tech/namespace"
 vRefElem:=DOM Creer ref XML($Racine;$Namespace)

Ce code produit le résultat suivant :

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

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

 C_TEXTE(vRefElem)
 C_TEXTE($aNSNom1;$aNSNom2;$aNSValeur1;$aNSValeur2)
 $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 Creer ref XML($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"/>

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.

 
PROPRIÉTÉS 

Produit : 4D
Thème : XML DOM
Numéro : 861
Nom intl. : DOM Create XML Ref

Cette commande modifie la variable système OKCette commande modifie la variable système Error

 
HISTORIQUE 

Créé : 4D 2004

 
VOIR AUSSI  

DOM FERMER XML
DOM FIXER DECLARATION XML

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v11 SQL Release 6)
4D - Langage ( 4D v12.4)
4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v13.5)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)