DOM Create XML element

DOM Create XML element ( refElemento ; xRota {; nomeAtrib ; valorAtrib} {; nomeAtrib2 ; valorAtrib2 ; ... ; nomeAtribN ; valorAtribN} ) : Text

Parâmetro	Tipo		Descrição
refElemento	Text	→	Referência do elemento Root XMLK
xRota	Text	→	Caminho xRota do elemento XML a ser criado
nomeAtrib	Text	→	Atributo a estabelecer
valorAtrib	Text, Boolean, Integer, Real, Time, Date	→	Novo valor de atributo
Resultado	Text	←	Referência do elemento XML criado

Descrição

O comando DOM Create XML element permite criar um novo elemento no elemento XML refElemento na localização definida pelo parâmetro xRota e lhe adicionar atributos se é necessário.

Passe em refElemento a referência do elemento raiz (criado, por exemplo com a ajuda do comando DOM Create XML Ref).

Em xRota, passe a rota de acesso do elemento a criar em notação XPath (para saber mais veja a seção [#title id="733" anchor="4967352"/] ). São admitidas as expressões de rota abaixo:

Expressão	Ação
/	Determina o nodo raiz (rota absoluta)
para[1]	Determina o primerro filho "para" do nodo de contexto
para[last()]	Determina o último filho "para" do nodo de contexto

Nota de compatibilidade: a partir da v18 R3, a implementação de XPath em 4D é mais compatível. Por razões de compatibilidade, a implementação não padrão anterior se mantém de forma pré-determinada nos bancos de dados convertidos. Se quiser se beneficiar das funcionalidades extendidas em seus bancos de dados convertidos, deve selecionar a opção de compatibilidade Utilizar XPath normal de Página Compatibilidade.

É possível passar diretamente em xRota um nome de elemento simples com o objetivo de criar um subelemento a partir do elemento atual (ver o exemplo 3).

Se os elementos da rota de acesso não existirem, são criados. Se já existirem os elementos de rota, um novo nodo é agregado.

Nota: Se você definiu um ou mais espaços de nome (namespaces) para a árvore designada por refElemento (ver o comando DOM Create XML Ref ), deve prefixar o parâmetro xRota do nome de espaço a utilizar (por exemplo, “MeuNomeEspaço:MeuElemento”).

Pode passar nos parâmetros opcionais nomAtrib e valorAtrib um par atributo/valor (em forma de variáveis, campos ou valores literais). Pode passar tantos pares quantos queira.

O parâmetro valorAtrib pode ser de tipo texto ou de outro tipo (Booleano, inteiro, real, hora ou data). Se passar um valor de um tipo diferente ao tipo texto, 4D cuida da conversão para texto, de acordo aos seguintes princípios:

Tipo	Exemplo do valor convertido
Boolean	"true" ou "false"
Inteiro	"123456"
Real	"12.34" (o separador decimal é sempre ".")
Data	"2006-12-04T00:00:00Z" (norma RFC 3339)
Hora	"5233" (número de segundos)

O comando retorna como resultado a referência XML do elemento criado.

Exemplo 1

se quisermos criar o elemento abaixo:

Para fazer isso, simplesmente escrevemos:

 var vRootRef;vElemRef : Text
 vRootRef:=DOM Create XML Ref("RootElement")
 vxPath:="/RootElement/Elem1/Elem2/Elem3[2]"
 vElemRef:=DOM Create XML element(vRootRef;vxPath)

Exemplo 2

Se quisermos criar o elemento abaixo (contém os atributos): [#codeXML]







[#/codeRAW]

Para fazer isso, simplesmente ecrevemos:

 var vRootRef;vElemRef : Text
 var $aAttrName1;$aAttrName2;$aAttrVal1;$aAttrVal2;$aAttrVal3 : Text

$aAttrName1:="Font"
 $aAttrName2:="Size"
 $aAttrVal1:="Verdana"
 $aAttrVal2:="10"
 $aAttrVal3:="8"
 
 vRootRef:=DOM Create XML Ref("RootElement")
 vxPath:="/RootElement/Elem1/Elem2/Elem3"
 vElemRef:=DOM Create XML element(vRootRef;vxPath;$aAttrName1;$aAttrVal1;$aAttrName2;$aAttrVal2)
 vElemRef:=DOM Create XML element(vRootRef;vxPath;$aAttrName1;$aAttrVal1;$aAttrName2;$aAttrVal3)

Se quiser inserir um elemento depois, pode escrever:

 vxPath:="/RootElement/Elem1/Elem2/Elem3[2]"
 vElemRef:=DOM Create XML element(vRootRef;vxPath;"Font";"Arial")

Temos então:

Exemplo 3

Queremos criar e exportar a seguinte estrutura:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<Root>
   <Elem1>Olá</Elem1>
</Root>

Queremos utilizar a sintaxe baseada em um nome de elemento simples. Para fazer isso, simplesmente escrevemos:

 var $root : Text
 var $ref1 : Text
 
 $root:=DOM Create XML Ref("Raiz")
 $ref1:=DOM Create XML element($root;"Elem1")
 DOM SET XML ELEMENT VALUE($ref1;"Olá")
 DOM EXPORT TO FILE($root;"meudoc.xml")
 DOM CLOSE XML($root)

Variáveis e conjuntos do sistema

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

Gestão de erros

Um erro é gerado quando:

• A referência do elemento raiz não for válida.
• O nome do elemento a ser criado for inválido (por exemplo, se começar por um número).

Ver também

DOM Create XML element arrays
DOM Get XML element
DOM REMOVE XML ELEMENT