DOM SET XML ATTRIBUTE

DOM SET XML ATTRIBUTE ( refElemento ; nomeAtrib ; valorAtrib {; nomeAtrib2 ; valorAtrib2 ; ... ; nomeAtribN ; valorAtribN} )

Parâmetro	Tipo		Descrição
refElemento	Text	→	Referência de elemento XML
nomeAtrib	Text	→	Atributo a estabelecer
valorAtrib	Text, Boolean, Integer, Real, Time, Date	→	Novo valor de atributo

Descrição

O comando DOM SET XML ATTRIBUTE permite adicionar uno ou vários atributos ao elemento XML cuja referência se passa no parâmetro refElemento. Também permite definir o valor de cada atributo definido.

Passe nos parâmetros nomeAtrib e valorAtrib respectivamente o atributo a escrever e seu valor (em forma de variáveis, campos, ou valores literais). Pode passar tantos atributos/valores como queira.

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

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

Exemplo

Na seguinte fonte XML:

<Book>
   <Title>O melhor vendedor</Title>
</Book>

Se for executado o código abaixo:

 vAtrNom:="Font"
 vAtrVal:="Verdana"
 DOM SET XML ATTRIBUTE(vRefElem;vAtrNom;vAtrVal)

Obtemos:

<Book>
   <Title Font=Verdana>O melhor vendedor</Title>
</Book>

Variáveis e conjuntos do sistema

Se o comando tiver sido executado corretamente, a variável sistema Ok assume o valor 1. Se ocorrer um erro, assume o valor 0.

Ver também

DOM GET XML ATTRIBUTE BY INDEX
DOM GET XML ATTRIBUTE BY NAME
DOM REMOVE XML ATTRIBUTE
XML SET OPTIONS