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
Propriedades
| Número do comando | 866 |
| Thread-seguro | ✓ |
| Modificar variáveis | OK |