DOM SET XML ELEMENT VALUE

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 2004.4 (Modificado)


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

ParámetroTipoDescripción
refElementCadenaReferencia del elemento XML
xRutaTextoRuta XPath del elemento XML
valorElementCadena | VariableNuevo valor del elemento
**Si se pasa: definir el valor en CDATA

Descripción

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).

Nota: si el elemento designado por refEement es un BLOB procesado por el comando DOM SET XML ELEMENT VALUE, ha sido codificado automáticamente en base64. Sin embargo, como DOM GET XML ELEMENT VALUE no realiza automáticamente reversa de la operación, deberá utilizar el comando DECODE.

Ejemplos

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";*)

Obtenemos:

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

Ver también

DOM GET XML ELEMENT VALUE.

Variables y conjuntos sistema

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).


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