4D v16.3
DOM Find XML element
- Manual de linguagem 4D
-
- XML DOM
-
- Visão Geral dos comandos XML DOM
- DOM Append XML child node
- DOM Append XML element
- DOM CLOSE XML
- DOM Count XML attributes
- DOM Count XML elementsUpd
- DOM Create XML element
- DOM Create XML element arrays
- DOM Create XML Ref
- DOM EXPORT TO FILE
- DOM EXPORT TO VAR
- DOM Find XML element
- DOM Find XML element by ID
- DOM Get first child XML element
- DOM Get last child XML element
- DOM Get next sibling XML element
- DOM Get parent XML element
- DOM Get previous sibling XML element
- DOM Get Root XML element
- DOM GET XML ATTRIBUTE BY INDEX
- DOM GET XML ATTRIBUTE BY NAME
- DOM GET XML CHILD NODES
- DOM Get XML document ref
- DOM GET XML ELEMENT NAME
- DOM GET XML ELEMENT VALUE
- DOM Get XML elementUpd
- DOM Get XML information
- DOM Insert XML element
- DOM Parse XML source
- DOM Parse XML variable
- DOM REMOVE XML ATTRIBUTE
- DOM REMOVE XML ELEMENT
- DOM SET XML ATTRIBUTE
- DOM SET XML DECLARATIONS
- DOM SET XML ELEMENT NAME
- DOM SET XML ELEMENT VALUE
DOM Find XML element
| DOM Find XML element ( refElemento ; xPath {; arrRefElementos} ) -> Resultado | ||||||||
| Parâmetro | Tipo | Descrição | ||||||
| refElemento | String |
|
Referência de elemento XML | |||||
| xPath | Texto |
|
Rota XPath do elemento a procurar | |||||
| arrRefElementos | Array string |
|
Lista de referências de elementos encontradas (se aplicável) | |||||
| Resultado | String |
|
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.
Produto: 4D
Tema: XML DOM
Número
864
Modificado: 4D v11 SQL
Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)
