DOM SET XML ATTRIBUTE
DOM SET XML ATTRIBUTE ( 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 SET XML ATTRIBUTE 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 SET XML ATTRIBUTE(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.
Voir aussi
DOM GET XML ATTRIBUTE BY INDEX
DOM GET XML ATTRIBUTE BY NAME
DOM REMOVE XML ATTRIBUTE
XML SET OPTIONS