SAX OPEN XML ELEMENT
SAX OPEN XML ELEMENT ( documento ; etiqueta {; nomAtrib ; valorAtrib} {; nomAtrib2 ; valorAtrib2 ; ... ; nomAtribN ; valorAtribN} )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| documento | DocRef | 🡒 | Referencia del documento abierto |
| etiqueta | Cadena | 🡒 | Nombre del elemento a abrir |
| nomAtrib | Cadena | 🡒 | Nombre del atributo |
| valorAtrib | Cadena | 🡒 | Valor del atributo |
Descripción
El comando SAX OPEN XML ELEMENT permite añadir un nuevo elemento en el documento XML referenciado por document como también, opcionalmente, atributos y sus valores.
El elemento añadido está “abierto” en el documento (la etiqueta de fin no está añadida). Para cerrar un elemento creado utilizando este comando, debe:
- Utilizar el comando SAX CLOSE XML ELEMENT, o
- Cerrar el documento XML. En este caso, 4D añadirá automáticamente las etiquetas XML de cierre necesarias.
En etiqueta, pase el nombre del elemento a crear. Este nombre sólo puede contener letras, números y los caracteres “.”, “-“,”_” y “:”. Si se pasa un caracter inválido en etiqueta, se generará un error.
Opcionalmente, el comando permite pasar uno o varios pares de atributos/valores (en forma de variables, campos o valores literales) utilizando los parámetros nomAtrib y valorAtrib. Puede pasar tantos pares atributo/valor como quiera.
Ejemplo
La siguiente instrucción:
vElement:="Libro"
SAX OPEN XML ELEMENT($DocRef;vElement)
... escribirá la siguiente línea en el documento:
<book< pre=""></book<>
Gestión de errores
Si se pasa en tag un carácter inválido, se genera un error.