versión 2004
DOM Create XML Ref (root{; nameSpace}{; nameSpaceName; nameSpaceValue}{; nameSpaceName2; nameSpaceValue2; ...; nameSpaceNameN; nameSpaceValueN}) String
Parámetro | Tipo | Descripción | |
raiz | Cadena | Nombre del elemento raíz | |
nomEspacio | Cadena | Valor del espacio de nombre (namespace) | |
nSNom | Cadena | Nombre del espacio de nombre | |
nSValor | Cadena | Valor de espacio de nombre | |
Resultado | Cadena | Referencia 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.