SAX ADD XML ELEMENT VALUE

4D v20 R7


SAX ADD XML ELEMENT VALUE ( documento ; datos {; *} )

Parámetro	Tipo	Descripción
documento	DocRef	Referencia del documento abierto
datos	Texto, Variable	Texto o variable a insertar en el documento
*	Operador	Si se pasa: codificar los caracteres especiales Si se omite: no codificación

Descripción

El comando SAX ADD XML ELEMENT VALUE añade directamente en el documento XML referenciado por documento los datos sin convertirlos. Este comando es equivalente, por ejemplo, a insertar un archivo adjunto en el cuerpo de un e-mail.

En datos, puede pasar directamente una cadena de caracteres, o una variable 4D. El contenido de la variable se convertirá en texto antes de incluirse en el documento XML. Si datos se evalúa como indefinido, 4D utiliza una cadena vacía. Si quiere codificar el contenido de datos, debe utilizar el comando BASE64 ENCODE. En este caso, por su puesto, debe pasar un BLOB en datos.

Por defecto, el comando codifica los caracteres especiales (< > ” ’...) contenidos en los parámetros datos a menos que usted haya desactivado este mecanismo para el proceso actual utilizando el comando XML SET OPTIONS pasando el valor XML Raw data a la opción XML String encoding. Por ejemplo:

XML SET OPTIONS($docRef;XML string encoding;XML raw data)

En este contexto, para forzar la codificación de parámetros especiales durante la llamada de SAX ADD XML ELEMENT VALUE, debe pasar el parámetro opcional *.

Para que este comando funcione correctamente, debe estar abierto un elemento. De lo contrario, se generará un error.

Ejemplo

Este ejemplo inserta el archivo whitepaper.pdf en el elemento XML abierto:

 C_BLOB(vBMiBLOB)

 DOCUMENT TO BLOB("c:\\libroblanco.pdf";vBMiBLOB)

 SAX ADD XML ELEMENT VALUE($DocRef;vBMiBLOB)

Variables y conjuntos del sistema

Si el comando se ejecuta correctamente, la variable sistema OK toma el valor 1. De lo contrario toma el valor 0 y se genera un error.

Ver también

SAX GET XML ELEMENT VALUE
XML SET OPTIONS