DOM SET XML ELEMENT NAME
DOM SET XML ELEMENT NAME ( refElément ; nomElément )
| Paramètre | Type | Description | |
|---|---|---|---|
| refElément | Chaîne | 🡒 | Référence d’élément XML |
| nomElément | Chaîne | 🡒 | Nouveau nom de l’élément |
Description
La commande DOM SET XML ELEMENT NAME permet de modifier le nom de l’élément désigné par refElément.
Passez dans refElément la référence de l’élément à renommer et dans nomElément le nouveau nom de l’élément. Bien entendu, la commande se charge de modifier les balises d’ouverture et de fermeture de l’élément.
Exemple
Soit la source XML suivante :
<Book>
<Title>The Best Seller</Title>
</Book>
Si le code suivant est exécuté, en admettant que vRefElem contienne la référence de l’élément ‘Book’ :
DOM SET XML ELEMENT NAME(vRefElem;"BestSeller")
Nous obtenons :
<BestSeller>
<Title>The Best Seller</Title>
</BestSeller>
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.
Gestion des erreurs
Une erreur est générée lorsque :
- la référence de l’élément n’est pas valide
- le nouveau nom d’élément n’est pas valide (par exemple, s’il débute par un chiffre).