4D v16.3
DOM SET XML ELEMENT VALUE
- Manual de lenguaje 4D
-
- XML DOM
-
- Presentación de los comandos XML DOM
- DOM Append XML child node
- DOM Append XML element
- DOM CLOSE XML
- DOM Count XML attributes
- DOM Count XML elementsUpd
- DOM Create XML element
- DOM Create XML element arrays
- DOM Create XML Ref
- DOM EXPORT TO FILE
- DOM EXPORT TO VAR
- DOM Find XML element
- DOM Find XML element by ID
- DOM Get first child XML element
- DOM Get last child XML element
- DOM Get next sibling XML element
- DOM Get parent XML element
- DOM Get previous sibling XML element
- DOM Get Root XML element
- DOM GET XML ATTRIBUTE BY INDEX
- DOM GET XML ATTRIBUTE BY NAME
- DOM GET XML CHILD NODES
- DOM Get XML document ref
- DOM GET XML ELEMENT NAME
- DOM GET XML ELEMENT VALUE
- DOM Get XML elementUpd
- DOM Get XML information
- DOM Insert XML element
- DOM Parse XML source
- DOM Parse XML variable
- DOM REMOVE XML ATTRIBUTE
- DOM REMOVE XML ELEMENT
- DOM SET XML ATTRIBUTE
- DOM SET XML DECLARATION
- DOM SET XML ELEMENT NAME
- DOM SET XML ELEMENT VALUE
DOM SET XML ELEMENT VALUE
| DOM SET XML ELEMENT VALUE ( elementRef {; xRuta}; valorElement {; *} ) | ||||||||
| Parámetro | Tipo | Descripción | ||||||
| elementRef | Cadena |
|
Referencia del elemento XML | |||||
| xRuta | Texto |
|
Ruta XPath del elemento XML | |||||
| valorElement | Cadena, Variable |
|
Nuevo valor del elemento | |||||
| * | Operador |
|
Si se pasa: definir el valor en CDATA | |||||
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 DOM). 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 se utilizará 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 de tipo BLOB, DOM SET XML ELEMENT VALUE lo codifica automáticamente en base64. Sin embargo, el comando DOM GET XML ELEMENT VALUE realiza automáticamente la operación inversa.
Para cumplir con las reglas de procesamiento XML, todas las secuencias de caracteres de fin de línea CR y CRLF se convierten en caracteres LF.
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>
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 “<” 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 < 18</Postulate> </Maths>
` CDATA form
DOM SET XML ELEMENT VALUE(vElemRef;"12<18";*)Obtenemos:
<Maths> <Postulate><![CDATA[12 < 18]]></Postulate> </Maths>
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).
Producto: 4D
Tema: XML DOM
Número
868
Modificado: 4D 2004.4
Modificado: 4D v11 SQL
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)
