SAX ADD XML ELEMENT VALUE
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:
var vBMiBLOB : Blob
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.