TOTVSTEC

Árvore de páginas


Retorna um elemento filho da estrutura.

Sintaxe

XmlGetChild( < oParent >, < nChild > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

oParent

bloco de código

Indica o nó no qual será utilizado como base para obter um nó filho.

X


nChild

numérico

Indica o índice do nó que desejamos obter.

X


Retorno

Nome

Tipo

Descrição

oRet

objeto

Retorna o objeto que representa o filho da estrutura, de acordo com o índice passado no parâmetro <nChild>

Observações

  • Ao especificar um elemento qualquer do objeto para a função, na qual irá usar como base para retornar o nó filho indicado pelo segundo parâmetro passado para a função.
  • Pode-se utilizar essa função para alterar o posicionamento do objeto, para algum nó filho do atual, na estrutura do objeto XML - EXtensible Markup Language (Linguagem extensível de formatação).
  • Se for usado como retorno o mesmo objeto passado em <oParent>, seu conteúdo será substituído pelo conteúdo do elemento procurado, não sendo possível recuperar a informação anterior.

Exemplos

#INCLUDE "TOTVS.CH"
#INCLUDE "XMLXFUN.CH"
User Function ExeXML1()
Local cError   := ""
Local cWarning := ""
Local oScript

//Gera o Objeto XML ref. ao script
oScript := XmlParser( GeraXML(), "_", @cError, @cWarning )
oScript := XmlGetChild( oScript:_PEDIDO, 5 )

//Tranforma o Objeto XML em arquivo
SAVE oScript XMLFILE "\teste.xml"

Return oScript

Static Function GeraXML() // Script XML a gerar objeto
Local cScript := '<?xml version="1.0" encoding="UTF-8"?>'
cScript += "<pedido>"
cScript += "  <NomeCliente>Microsiga Software S/A</NomeCliente>"
cScript += "  <Endereco>Av. Braz Leme</Endereco>"
cScript += "  <Numero>1361</Numero>"
cScript += "  <Data>22-03-2005</Data>"
cScript += "  <Itens>"
cScript += "    <Item>"
cScript += "      <Produto>Prothues</Produto>"
cScript += "      <Quantidade>1</Quantidade>"
cScript += "      <Preco>100.00</Preco>"
cScript += "    </Item>"
cScript += "    <Item>"
cScript += "      <Produto>ERP</Produto>"
cScript += "      <Quantidade>0</Quantidade>"
cScript += "      <Preco>0</Preco>"
cScript += "    </Item>"
cScript += "  </Itens>"
cScript += "</pedido>"
Return cScript

Veja também

  • Sem rótulos