4D v13.4
DOM Create XML Ref
- 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 elements
- 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
- DOM GET XML ELEMENT NAME
- DOM GET XML ELEMENT VALUE
- 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 ELEMENT NAME
- DOM SET XML ELEMENT VALUE
- DOM SET XML OPTIONS
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 | |||||
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.
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/>
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"/>
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"/>
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.
Produto: 4D
Tema: XML DOM
Número
861
Criado por: 4D 2004
DOM CLOSE XML
DOM SET XML OPTIONS
