4D v16.3

DOM Create XML Ref

Inicio

 
4D v16.3
DOM Create XML Ref

DOM Create XML Ref 


 

DOM Create XML Ref ( raiz {; nomEspacio} {; nSNom ; nSValor} {; nSNom2 ; nSValor2 ; ... ; nSNomN ; nSValorN} ) -> Resultado 
Parámetro Tipo   Descripción
raiz  Cadena in Nombre del elemento raíz
nomEspacio  Cadena in Valor del espacio de nombre (namespace)
nSNom  Cadena in Nombre del espacio de nombre
nSValor  Cadena in Valor de espacio de nombre
Resultado  Cadena in Referencia del elemento XML raíz

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.

Creación de un árbol XML simple:

 C_TEXT(vRefElem)
 vRefElem:=DOM Create XML Ref("MiRaiz")

Este código produce el siguiente resultado:

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

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

 C_TEXT(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"/>

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

 C_TEXT(vRefElem)
 C_TEXT(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"/>

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 

Producto: 4D
Tema: XML DOM
Número 861

Este comando modifica la variable sistema OKEste comando modifica la variable sistema ErrorThis command can be run in preemptive processes

 
HISTORIA 

Creado por: 4D 2004

 
ARTICLE USAGE

Manual de lenguaje 4D ( 4D v16)
Manual de lenguaje 4D ( 4D v16.1)
Manual de lenguaje 4D ( 4D v16.2)
Manual de lenguaje 4D ( 4D v16.3)