DOM Create XML Ref

4D - Documentation   Français   English   German   Español   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente

versión 2004


DOM Create XML Ref (root{; nameSpace}{; nameSpaceName; nameSpaceValue}{; nameSpaceName2; nameSpaceValue2; ...; nameSpaceNameN; nameSpaceValueN}) String

ParámetroTipoDescripción
raizCadenaNombre del elemento raíz
nomEspacioCadenaValor del espacio de nombre (namespace)
nSNomCadenaNombre del espacio de nombre
nSValorCadenaValor de espacio de nombre
ResultadoCadenaReferencia del elemento XML raíz

Descripción

El comando DOM Create XML Ref crea un árbol XML vacío en memoria y devuelve su referencia.

Pase en el parámetro raiz el nombre del elemento raíz del árbol XML.

Pase en el parámetro opcional nomEspacio la declaración del valor del espacio de nombre (namespace) del árbol (por ejemplo "http://www.4dhispano.com").

En este caso, debe colocarle un prefijo con el espacio del nombre al parámetro raiz, seguido de: (por ejemplo, "MiNombreEspacio:MiRaiz").

Nota: El espacio de nombre es una cadena que permite garantizar la unicidad de los nombres de las variables XML. Por lo general, se utiliza un URL como http://www.misitio.com/miurl. El URL no necesariamente tiene que ser válido, pero tiene que ser único.

Puede declarar uno o varios espacios de nombre adicionales en el árbol XML generado, con la ayuda de pares nSNombre/nSValor. Puede pasar tantos pares nombre/valor de espacio de nombre como quiera.

Importante: Recuerde llamar al comando DOM CLOSE XML con el fin de liberar memoria cuando termine de utilizar el árbol XML.

Ejemplos

1. Creación de un árbol XML simple:

   C_STRING (16;vRefElem)
   vRefElem:=DOM Create XML Ref("MiRaiz")

Este código produce el siguiente resultado:

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

2. Creación de un árbol XML con un espacio de nombre:

   C_STRING (16;vRefElem)
   $Raiz:="MiNombreEspacio:MiRaiz"
   $Nombreespacio:="http://www.4DHispano.com/tech/nombreespacio"
   vRefElem:=DOM Create XML Ref($Raiz;$Nombreespacio)

Este código da el siguiente resultado:

<Minombreespacio:Miraiz xmlns:Minombreespacio="http://www.4DHispano.com/tech/nombreespacio"/>

3. Creación de un árbol XML con varios espacios de nombre:

   C_STRING (16;vRefElem)
   C_STRING (80;$aNSNom1;$aNSNom2;$aNSValor1;$aNSValor2)
   $Raiz:="MiNombreEspacio:MiRaiz"
   $Nombreespacio:="http://www.4DHispano.com/tech/nombreespacio"
   $aNSNom1:="NSNom1"
   $aNSNom2:= "NSNom2"
   $aNSValor1:="http://www.4DHispano.com/Prod/nombreespacio"
   $aNSValor2:="http://www.4DHispano.com/Mkt/nombreespacio"
   vRefElem:=DOM Create XML Ref($Raiz;$Nombreespacio;$aNSNom1;$aNSValor1;$aNSNom2;$aNSValor2)

Este código produce el siguiente resultado:

<MiNombreEspacio:MiRaiz xmlns:MiNombreEspacio="http://www.4DHispano.com/tech/nombreEspacio"
NSNom1="http://www.4DHispano.com/Prod/nombreespacio"
NSNom2="http://www.4DHispano.com/Mkt/nombreespacio"/>

Ver también

DOM CLOSE XML, DOM SET XML OPTIONS.

Variables y conjuntos sistema

Si el comando se ejecutó correctamente, la variable sistema OK toma el valor 1. De lo contrario, toma el valor 0 y se genera un error.


4D - Documentation   Français   English   German   Español   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente