DOM Create XML Ref
DOM Create XML Ref ( raiz {; nomeEspaço} {; nSNome ; nSValor} {; nSNome2 ; nSValor2 ; ... ; nSNomeN ; nSValorN} ) -> Resultado
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| raiz | Text | → | Nome do elemento raiz |
| nomeEspaço | Text | → | Valor do espaço de nome (namespace) |
| nSNome | Text | → | Nome do Namespace |
| nSValor | Text | → | Valor do Namespace |
| Resultado | Text | ← | 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:
var vRefElem : Text
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:
var vRefElem : Text
$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:
var vRefElem : Text
var 80;$aNSNom1;$aNSNom2;$aNSValor1;$aNSValor2 : Text
$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.