4D Doc Center : DOM ECRIRE NOM ELEMENT XML

4D v14.3

DOM ECRIRE NOM ELEMENT XML


DOM ECRIRE NOM ELEMENT XML ( 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 ECRIRE NOM ELEMENT XML 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 ECRIRE NOM ELEMENT XML(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).