DOM Create XML element

4D - Documentation   Français   English   German   Español   English   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 11 (Modificado)


DOM Create XML element (elementRef; xPath{; attrName; attrValue}{; attrName2; attrValue2; ...; attrNameN; attrValueN}) String

ParámetroTipoDescripción
refElementCadenaReferencia del elemento XML raíz
xRutaTextoRuta XPath del elemento XML a crear
nomAtributoCadenaAtributo a definir
valorAtributoCadena| ValorNuevo valor del atributo
ResultadoCadenaReferencia del elemento XML creado

Descripción

El comando DOM Create XML element permite crear un nuevo elemento en el elemento XML refElement en la ubicación definida por el parámetro xRuta y añadirle atributos si es necesario.

Pase en refElement la referencia del elemento raíz (creado, por ejemplo con la ayuda del comando DOM Create XML Ref).

En xRuta, pase la ruta de acceso del elemento a crear en notación XPath (ver el párrafo "Uso de la notación XPath" en la sección Overview of XML Commands). Si los elementos de la ruta de acceso no existen, son creados.

Es posible pasar directamente en xRuta un nombre de elemento simple con el fin de crear un subelemento a partir del elemento actual (ver el ejemplo 3).

Nota: Si usted ha definido uno o más espacios de nombre (namespaces) para el árbol designado por refElement (ver el comando DOM Create XML Ref), debe prefijar el parámetro xRuta del nombre de espacio a utilizar (por ejemplo, "MiNombreEspacio:MiElemento").

Puede pasar en los parámetros opcionales nomAtributo y valorAtributo un par atributo/valor (en forma de variables, campos o valores literales). Puede pasar tantos pares como quiera.

El parámetro valorAtributo puede ser de tipo texto o de otro tipo (Booleano, entero, real, hora o fecha). Si pasa un valor de un tipo diferente al tipo texto, 4D se encarga de la conversión a texto, de acuerdo a los siguientes principios:

TipoEjemplo de valor convertido
Booleano"true" o "false" (no traducido)
Entero"123456"
Real"12.34" (el separador decimal siempre es ".")
Fecha"2006-12-04T00:00:00Z" (norma RFC 3339)
Hora"5233" (Número de segundos)

El comando devuelve en resultado la referencia XML del elemento creado.

Ejemplos

1. Queremos crear el siguiente elemento:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<RootElement>
   <Elem1>
      <Elem2>
         <Elem3> </Elem3>
         <Elem3> </Elem3>
      </Elem2>
   </Elem1>
</RootElement>

Para hacerlo, simplemente escribimos:

   C_STRING(16;vRefRaiz;vRefElem)
   vRefRaiz:=DOM Create XML Ref ("RootElement") 
   vxPath:="/RootElement/Elem1/Elem2/Elem3"
   vRefElem:=DOM Create XML element(vRefRaiz;vxPath) 
   vxPath:="/RootElement/Elem1/Elem2/Elem3[2]"
   vRefElem:=DOM Create XML element(vRefRaiz;vxPath) 

2. Queremos crear el siguiente elemento (contiene los atributos):

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<RootElement>
   <Elem1>
      <Elem2>
         <Elem3 Font=Verdana  Size=10> </Elem3>
      </Elem2>
   </Elem1>
</RootElement>

Para hacerlo, simplemente escribimos:

   C_STRING(16;vRefRaiz;vRefElem)
   C_STRING(80;$aAtribNom1;$aAtribNom2;$aAtribVal1;$aAtribVal2)
   $aAtribNom1:="Font"
   $aAtribNom2:="Size"
   $aAtribVal1:="Verdana"
   $aAtribVal2:="10"

   vRefRaiz:=DOM Create XML Ref("RootElement") 
   vxPath:="/RootElement/Elem1/Elem2/Elem3"
   vRefElem:=DOM Create XML element(vRefRaiz;vxPath;$aAtribNom1;$aAtribVal1;$aAtribNom2;$aAtribVal2)

3. Queremos crear y exportar la siguiente estructura:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<Root>
   <Elem1>Hola</Elem1>
</Root>

Queremos utilizar la sintaxis basada en un nombre de elemento simple. Para hacerlo, simplemente escribimos:

   C_STRING(16;$root)
   C_STRING(16;$ref1)

   $root:=DOM Create XML Ref ("Raíz")
   $ref1:=DOM Create XML element($root;"Elem1")
   DOM SET XML ELEMENT VALUE($ref1;"Hola")
   DOM EXPORT TO FILE($root;"midoc.xml")
   DOM CLOSE XML($root)

Ver también

DOM Get XML element, DOM REMOVE XML ELEMENT.

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.

Gestión de errores

Se genera un error cuando:

La referencia del elemento raíz no es válida.

El nombre del elemento a crear es inválido (por ejemplo, si comienza por un número).


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