4D Doc Center : SAX GET XML ELEMENT

4D v14.3

SAX GET XML ELEMENT


SAX GET XML ELEMENT ( documento ; nome ; prefixo ; nomesAtributos ; valoresAtributos )

Parâmetro	Tipo	Descrição
documento	DocRef	Referência do documento aberto
nome	cadeia	Element name
prefixo	cadeia	Namespace
nomesAtributos	Array cadeia	Attribute names
valoresAtributos	Array cadeia	Attribute values

Descrição

O comando SAX GET XML ELEMENT devolve diversa informação relativa ao elemento nome presente no documento XML referenciado por documento. Este comando deve ser chamado com os eventos XML Start Element ou XML End Element SAX. No caso específico de XML End Element, os parâmetros de atributos não são manipulados. Para maior informação sobre os eventos SAX, consulte a descrição do comando SAX Get XML node.

O parâmetro nome contém o nome do elemento.

O parâmetro prefixo devolve o espaço de nome (namespace) do elemento. Este parâmetro está vazio se nenhum espaço de nome estiver associado ao elemento.

O comando preenche o array nomsAtributos com os nomes dos atributos do elemento objetivo. Se for necessário, o comando cria e dimensiona automaticamente o array.

O comando também preenche o array valoresAtributos com os valores dos atributos do elemento objetivo. Se for necessário, o comando cria e dimensiona automaticamente o array.

Exemplo

Consideremos o código XML abaixo:

 <ElementoRaiz>

 <Filho Att1="111"Att2="222"Att3="333">MeuTexto</Filho>

 </ElementoRaiz>

Quando executar a seguinte instrução:

SAX GET XML ELEMENT(DocRef;vNome;vPrefixo;tAttrNomes;tAttrValores)

...vNome conterá “Filho”
vPrefix conterá “”
tAttrNomes{1} conterá “Att1”, tAttrNomes{2} conterá “Att2”, tAttrNomes{3} conterá “Att3”
tAttrValores{1} conterá “111”, tAttrValores{2} conterá “222”, tAttrValores{3} conterá “333”

Variáveis e conjuntos do sistema

Se o comando tiver sido executado corretamente, a variável sistema Ok assume o valor 1. Do contrário, assume o valor e se gera um erro.