4D Doc Center : DOM Create XML Ref

4D v14.3

DOM Create XML Ref


DOM Create XML Ref ( raiz {; nomeEspaço} {; nSNome ; nSValor} {; nSNome2 ; nSValor2 ; ... ; nSNomeN ; nSValorN} ) -> Resultado

Parâmetro	Tipo	Descrição
raiz	cadeia	Nome do elemento raiz
nomeEspaço	cadeia	Valor do espaço de nome (namespace)
nSNome	cadeia	Nome do Namespace
nSValor	cadeia	Valor do Namespace
Resultado	cadeia	Raiz XML do elemento referência

Descrição

O comando DOM Create XML Ref cria uma árvore XML vazia na memória e retorna sua referência.

Passe no parâmetro raiz o nome do elemento raiz da árvore XML.

Passe no parâmetro opcional nomeEspaço a declaração do valor do espaço de nome (namespace) do árvore (por exemplo “http://www.4dhispano.com”).

Note que é possível pôr um prefixo ao parâmetro raiz com o nome do espaço seguido de dois pontos: (por exemplo “MeuNomeEspaço:MinhaRaiz”). Neste caso, o parâmetro nomeEspaço especificando o valor do espaço de nome é obrigatório.

Nota: O espaço de nome é uma cadeia que permite garantir a unicidade dos nomes das variáveis XML. Em geral, são utilizadas uma URL como http://www.meuwebsite.com/minhaurl. A URL não necessariamente tem que ser válida, mas tem que ser única.

Pode declarar um ou vários espaços de nome adicionais na árvore XML gerada, com a ajuda de pares nSNome/nSValor. Pode passar tantos pares nome/valor de espaço de nome quantos queira.

Importante: Lembre de chamar ao comando DOM CLOSE XML com o objetivo de liberar memória quando termine de utilizar a árvore XML.

Exemplo 1

Criação de uma árvore XML simples:

 C_TEXT(vRefElem)

 vRefElem:=DOM Create XML Ref("MiRaiz")

Este código produz o seguinte resultado:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?> 
<MiRaiz/>

Exemplo 2

Criação de uma árvore XML com um espaço de nome:

 C_TEXT(vRefElem)

 $Raiz:="MeuNomeEspaco:MinhaRaiz"

 $Nomeespaco:="http://www.4DHispano.com/tech/nomeespaco"

 vRefElem:=DOM Create XML Ref($Raiz;$Nomeespaco)

Este código da o seguinte resultado:

<Meunomeespaco:Minharaiz xmlns:Meunomeespaco="http://www.4DHispano.com/tech/nomeespaco"/>

Exemplo 3

Criação de uma árvore XML com vários espaços de nome:

 C_TEXT(vRefElem)

 C_TEXT(80;$aNSNom1;$aNSNom2;$aNSValor1;$aNSValor2)

 $Raiz:="MeuNomeEspaco:MinhaRaiz"

 $Nomeespaco:="http://www.4DHispano.com/tech/nomeespaco"

 $aNSNom1:="NSNom1"

 $aNSNom2:="NSNom2"

 $aNSValor1:="http://www.4DHispano.com/Prod/nomeespaco"

 $aNSValor2:="http://www.4DHispano.com/Mkt/nomeespaco"

 vRefElem:=DOM Create XML Ref($Raiz;$Nomeespaco;$aNSNom1;$aNSValor1;$aNSNom2;$aNSValor2)

Este código produz o seguinte resultado:

<MeuNomeEspaco:MinhaRaiz xmlns:MeuNomeEspaco="http://www.4DHispano.com/tech/nomeEspaco"
NSNom1="http://www.4DHispano.com/Prod/nomeespaco"
NSNom2="http://www.4DHispano.com/Mkt/nomeespaco"/>

Variáveis e conjuntos do sistema

Se o comando foi executado corretamente, a variável sistema Ok assume o valor 1. Do contrário, assume o valor 0 e um erro é gerado.