SAX OPEN XML ELEMENT

4D v20 R7


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

Gestión de errores

Si se pasa en tag un carácter inválido, se genera un error.

Ver también

SAX CLOSE XML ELEMENT
SAX OPEN XML ELEMENT ARRAYS