4D Doc Center : DOM ECRIRE ATTRIBUT XML

4D v14.3

DOM ECRIRE ATTRIBUT XML


DOM ECRIRE ATTRIBUT XML ( refElément ; nomAttribut ; valeurAttribut {; nomAttribut2 ; valeurAttribut2 ; ... ; nomAttributN ; valeurAttributN} )

Paramètre	Type	Description
refElément	Chaîne	Référence d’élément XML
nomAttribut	Chaîne	Attribut à définir
valeurAttribut	Chaîne, Booléen, Entier long, Réel, Heure, Date	Nouvelle valeur d’attribut

Description

La commande DOM ECRIRE ATTRIBUT XML permet d’ajouter un ou plusieurs attribut(s) à l’élément XML dont la référence est passée dans le paramètre refElément. Elle permet également de définir la valeur de chaque attribut défini.

Passez dans les paramètres nomAttribut et valeurAttribut respectivement l’attribut à écrire et sa valeur (sous forme de variables, champs ou valeurs littérales). Vous pouvez passer autant de couples attribut/valeur que vous voulez.
Le paramètre valeurAttribut peut être de type texte ou d'un autre type (booléen, entier, réel, heure ou date). Si vous passez une valeur d'un type autre que texte, 4D se charge de la conversion en texte, selon les principes suivants :

Type	Exemple de valeur convertie
Booléen	"true" ou "false" (non traduit)
Entier	"123456"
Réel	"12.34" (le séparateur décimal est toujours ".")
Heure	"5233" (nombre de secondes)
Date	"2006-12-04T00:00:00Z" (norme RFC 3339)

Exemple

Soit la source XML suivante :

<Book>
   <Title>The Best Seller</Title>
</Book>

Si le code suivant est exécuté :

 vAttrName:="Font"

 vAttrVal:="Verdana"

 DOM ECRIRE ATTRIBUT XML(vRefElem;vAttrName;vAttrVal)

Nous obtenons :

<Book>
   <Title Font=Verdana>The Best Seller</Title>
</Book>

Variables et ensembles système

Si la commande a été exécutée correctement, la variable système OK prend la valeur 1, sinon elle prend la valeur 0 et une erreur est générée.