DOM SET XML ELEMENT VALUE

versión 2004.4 (Modificado)

DOM SET XML ELEMENT VALUE (refElement{; xRuta; valorElement{; *})

El comando DOM SET XML ELEMENT VALUE le permite modificar el valor del elemento definido por refElement.

Si pasa el parámetro opcional xRuta, usted elige utilizar la notación XPath para indicar el elemento a modificar (para mayor información sobre esta notación, consulte el párrafo "Uso de la notación XPath" en la sección Presentación de los comandos XML). En este caso, debe pasar la referencia de un elemento XML raíz en refElement y la ruta XPath del elemento a modificar en xPath.

En valorElement, pase una cadena o una variable (o un campo) que contenga el nuevo valor del elemento especificado:

• Si pasa una cadena, el valor será utilizado tal como en la estructura XML.

• Si pasa una variable o un campo, 4D procesará el valor, dependiendo del tipo de valorElement. Todos los tipos de datos pueden ser utilizados, a excepción de los arrays, imágenes y punteros.

Cuando se pasa el parámetro opcional asterisco (*), indica que el valor del elemento debe ser definido bajo la forma de CDATA. La forma especial CDATA permite escribir texto sin formato (ver ejemplo 2).

1. En la siguiente fuente XML:

<Book>
   <Title>El mejor vendedor</Title>
</Book>

Si se ejecuta el siguiente código, con vRefElem contiene la referencia del elemento "Titulo":

   DOM SET XML ELEMENT VALUE(vRefElem;"El Perdedor")

Obtenemos:

<Book>
   <Title>El Perdedor</Title>
</Book>

2. En la siguiente fuente XML:

<Maths>
   <Postulate>1+2=3</Postulate>
</Maths>

Queremos escribir el texto "12<18" en el elemento <Postulate>. Esta cadena no puede escribirse en XML porque el carácter "<" no se acepta. Este carácter debe transformarse entonces en "&lt;" o debe utilizarse la forma CDATA. Si vElemRef indica el nodo XML <Postulate>:

      ` Forma normal
   DOM SET XML ELEMENT VALUE(vElemRef;"12<18")

Obtenemos:

<Maths>
   <Postulate>12 &lt; 18</Postulate>
</Maths>

      ` CDATA form
   DOM SET XML ELEMENT VALUE(vElemRef;"12<18";*)

We get:

<Maths>
   <Postulate><![CDATA[12 < 18]]></Postulate>
</Maths>

DOM GET XML ELEMENT VALUE.

Si el comando ha sido ejecutado correctamente, la variable sistema OK toma el valor 1. Si ocurre un error, toma el valor 0 y se genera un error (por ejemplo, si la referencia del elemento es inválida).