SAX OPEN XML ELEMENT
SAX OPEN XML ELEMENT ( documento ; etiqueta {; nomeAtrib ; valorAtributo} {; nomeAtrib2 ; valorAtributo2 ; ... ; nomeAtribN ; valorAtributoN} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| documento | Time | → | Referência do documento aberto |
| etiqueta | Text | → | Nome do elemento a abrir |
| nomeAtrib | Text | → | Nome de atributo |
| valorAtributo | Text | → | 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< pre=""></book<>
Gestão de erros
Se passar em tag um caractere inválido, se gera um erro.