SAX OPEN XML ELEMENT ARRAYS
SAX OPEN XML ELEMENT ARRAYS ( documento ; etiqueta {; atribNomesArray ; attribValuesArray} {; atribNomesArray2 ; attribValuesArray2 ; ... ; atribNomesArrayN ; attribValuesArrayN} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| documento | refDoc | 🡒 | Referência do documento aberto |
| etiqueta | String | 🡒 | Nome do elemento a abrir |
| atribNomesArray | Array string | 🡒 | Array de nomes de atributo |
| attribValuesArray | Array string, Array inteiro longo, Array data, Array real, Array imagem, Array booleano | 🡒 | Array of attribute values |
Descrição
O comando SAX OPEN XML ELEMENT ARRAYS permite adicionar um novo elemento no documento XML cuja referência se passa em document como também, opcionalmente, atributos e seus valores em forma de arrays.
Exceto pela compatibilidade com arrays (ver a continuação), este comando es idêntico a SAX OPEN XML ELEMENT. Por favor consulte a descrição deste comando para maior informação sobre seu funcionamento.
SAX OPEN XML ELEMENT ARRAYS aceita arrays de tipo data, numéricos, booleanos e imagem como parâmetros arrayValoresAtrib. 4D automaticamente realiza todas as conversões necessárias; pode configurar estas conversões utilizando o comando XML SET OPTIONS.
Opcionalmente, o comando SAX OPEN XML ELEMENT ARRAYS permite passar pares de atributos e de valores de atributos em forma de arrays nos parâmetros arrayNomsAtrib e arrayValoresAtrib.
Os arrays devem ter sido criados previamente e funcionar em pares de valor atributo/atributo. Pode passar tantos pares de arrays e elementos em cada par quantos queira.
Exemplo
O método abaixo:
ARRAY STRING(80;aNomsAtrib;2)
ARRAY STRING(80;aValoresAtrib;2)
vElement:="Livro"
aNomsAtrib{1}:="Font"
aValoresAtrib{1}:="Arial"
aNomsAtrib{2}:="Style"
aValoresAtrib{2}:="Bold"
SAX OPEN XML ELEMENT ARRAYS($DocRef;vElemento;tNomsAtrib;tValoresAtrib)
... escreverá no documento:
<Book Font="Arial" Style="Bold">