versión 2004
SAX OPEN XML ELEMENT (document; tag{; attribName; attribValue}{; attribName2; attribValue2; ...; attribNameN; attribValueN})
Parámetro | Tipo | Descripción | |
document | 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
Ver también
SAX CLOSE XML ELEMENT, SAX OPEN XML ELEMENT ARRAYS.
Gestión de errores
Si se pasa en tag un carácter inválido, se genera un error.