DOM Creer ref XML

4D - Documentation   Français   English   German   Español   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant

version 2004


DOM Creer ref XML (racine{; nameSpace}{; nSNom; nSValeur}{; nSNoms; nSValeurs; ...; nSNomN; nSValeurN}) Chaîne

ParamètreTypeDescription
racineChaîneNom de l'élément racine
nameSpaceChaîneValeur de l'espace de nommage (Namespace)
nSNomChaîneNom d'espace de nommage
nSValeurChaîneValeur d'espace de nommage
RésultatChaîneRéférence de l'élément XML racine

Description

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").

Dans ce cas, vous devez préfixer le paramètre racine avec le nom de l'espace de nommage, suivi de : (par exemple "MonNameSpace:MaRacine").

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.

Exemples

(1) Création d'un arbre XML simple :

   C_ALPHA (16;vRefElem)
   vRefElem:=DOM Creer ref XML("MaRacine")

Ce code produit le résultat suivant :

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

(2) Création d'un arbre XML avec un espace de nommage :

   C_ALPHA (16;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"/>

(3) Création d'un arbre XML avec plusieurs espaces de nommage :

   C_ALPHA (16;vRefElem)
   C_ALPHA (80;$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"/>

Référence

DOM ECRIRE OPTIONS XML, DOM FERMER XML.

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.


4D - Documentation   Français   English   German   Español   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant