4D v14.3

DOM Find XML element

Página Inicial

 
4D v14.3
DOM Find XML element

DOM Find XML element 


 

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

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.

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.

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)

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.

Um erro é gerado quando:

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

 
PROPRIEDADES 

Produto: 4D
Tema: XML DOM
Número 864

Este comando modifica a variável sistema OKEste comando modifica a variável sistema Error

 
HISTÓRIA 

Modificado: 4D v11 SQL

 
VER TAMBÉM 

DOM Count XML elements
DOM Create XML element

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)