4D Doc Center : SAX OPEN XML ELEMENT

4D v13.4

SAX OPEN XML ELEMENT


SAX OPEN XML ELEMENT ( documento ; etiqueta {; nomeAtrib ; valorAtributo} {; nomeAtrib2 ; valorAtributo2 ; ... ; nomeAtribN ; valorAtributoN} )

Parâmetro	Tipo	Descrição
documento	DocRef	Referência do documento aberto
etiqueta	cadeia	Nome do elemento a abrir
nomeAtrib	cadeia	Nome de atributo
valorAtributo	cadeia	Valor do atributo

Descrição

O comando SAX OPEN XML ELEMENT permite adicionar um novo elemento no documento XML referenciado por documento, assim como, opcionalmente, atributos e seus valores.

O elemento adicionado está “aberto” no documento (a etiqueta de final não foi adicionada). Para fechar um elemento criado utilizando este comando, deve:

Utilizar o comando SAX CLOSE XML ELEMENT, ou
Fechar o documento XML. Neste caso, 4D adicionará automaticamente as etiquetas XML de fechamento necessárias.

Em etiqueta, passe o nome do elemento a criar. Este nome apenas pode conter letras, números e os caracteres “.”, “-“,”_” e “:”. Se for passado um caractere inválido em etiqueta, se gerará um erro.

Opcionalmente, o comando permite passar um ou vários pares de atributos/valores (em forma de variáveis, campos ou valores literais) utilizando os parâmetros nomeAtributo e valorAtributo. Pode passar tantos pares atributo/valor como queira.

Exemplo

A seguinte instrução:

 vElement:="Livro"

 SAX OPEN XML ELEMENT($DocRef;vElement)

... escreverá a linha abaixo no documento:

<Book

Gestão de erros

Se passar em tag um caractere inválido, se gera um erro.