4D Doc Center : DOM Find XML element

4D v14.3

DOM Find XML element


DOM Find XML element ( refElemento ; xPath {; arrRefElementos} ) -> Resultado

Parâmetro	Tipo	Descrição
refElemento	cadeia	Referência de elemento XML
xPath	Texto	Rota XPath do elemento a procurar
arrRefElementos	Array cadeia	Lista de referências de elementos encontradas (se aplicável)
Resultado	cadeia	Referência do elemento encontrado (se aplicável)

Descrição

O comando DOM Find XML element permite buscar os elementos XML específicos em uma estrutura XML. A pesquisa começa pelo elemento determinado pelo parâmetro refElemento.

O nó XML a buscar está definido pelo parâmetro xPath, expresso em notação XPath (ver o parágrafo “Uso da notação XPath” na seção Visão Geral dos comandos XML DOM). É possível utilizar elementos indexados.

Nota: De acordo com a norma XML, a pesquisa diferencia as maiúsculas das minúsculas.

O comando retorna a referência XML do elemento encontrado.

Quando passar o array cadeia arrRefElementos, o comando o preenche com a lista das referências XML encontradas. Neste caso, o comando retorna o primeiro elemento do array arrRefElementos. Este parâmetro é útil quando existirem vários elementos com o mesmo nome na localização determinada pelo parâmetro xRota.

Exemplo 1

Este exemplo permite buscar rapidamente um elemento XML e mostrar seu valor:

 vEncontrado:=DOM Find XML element(vRefElem;"Items/Book[15]/Title")

 DOM GET XML ELEMENT VALUE(vEncontrado;valor)

 ALERT("O valor do elemento é: \""+valor+"\"")

A mesma pesquisa também pode ser realizada desta forma:

 vEncontrado:=DOM Find XML element(vElemRef;"Items/Book[15]")

 vEncontrado:=DOM Find XML element(vEncontrado;"Book/Title")

 DOM GET XML ELEMENT VALUE(vEncontrado;valor)

 ALERT("O valor do elemento é: \""+valor+"\"")

Nota: Como é mostrado no exemplo anterior, a rota XPath deve sempre começar pelo nome do elemento atual. Esta precisão é importante quando maneja rotas XPath relativas.

Exemplo 2

Dada a seguinte estrutura XML:

<Root>
   <Elem1>
      <Elem2>aaa</Elem2>
      <Elem2>bbb</Elem2>
      <Elem2>ccc</Elem2>
   </Elem1>
</Root>

O código abaixo permite recuperar a referência de cada elemento Elem2 no array arrEncontrados:

 ARRAY TEXT(16;arrEncontrados;0)

 vFound:=DOM Find XML element(vRefElem;"/Raiz/Elem1/Elem2";arrEncontrados)

Variáveis e conjuntos do sistema

Se o comando for executado corretamente, a variável sistema OK assume o valor1. Do contrário, assume o valor 0 e um erro é gerado.

Gestão de erros

Um erro é gerado quando:

O elemento de referência é inválido
A rota xPath especificada é inválida.