DOM Create XML Ref

DOM Create XML Ref ( raiz {; nomEspacio} {; nSNom ; nSValor} {; nSNom2 ; nSValor2 ; ... ; nSNomN ; nSValorN} ) : Text

Parámetro	Tipo		Descripción
raiz	Text	→	Nombre del elemento raíz
nomEspacio	Text	→	Valor del espacio de nombre (namespace)
nSNom	Text	→	Nombre del espacio de nombre
nSValor	Text	→	Valor de espacio de nombre
Resultado	Text	←	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”).

Note que es posible poner un prefijo al parámetro raiz con el nombre del espacio seguido de dos puntos : (por ejemplo “MiNombreEspacio:MiRaiz”). En este caso, el parámetro nomEspacio especificando el valor del espacio de nombre es obligatorio.

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.

Ejemplo 1

Creación de un árbol XML simple:

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

Este código produce el siguiente resultado:

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

Ejemplo 2

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

 var vRefElem : Text
 $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"/>

Ejemplo 3

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

 var vRefElem : Text
 var 80;$aNSNom1;$aNSNom2;$aNSValor1;$aNSValor2 : Text
 $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"/>

Variables y conjuntos del 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.

Ver también

DOM CLOSE XML
DOM SET XML DECLARATION

Propiedades

Número de comando	861
Hilo seguro	✓
Modifica variables	OK, error