DOM LIRE ATTRIBUT XML PAR NOM

4D v20 R7


DOM LIRE ATTRIBUT XML PAR NOM ( refElément ; nomAttribut ; valeurAttribut )

Paramètre	Type	Description
refElément	Chaîne	Référence d’élément XML
nomAttribut	Chaîne	Nom d’attribut
valeurAttribut	Variable	Valeur de l’attribut

Description

La commande DOM LIRE ATTRIBUT XML PAR NOM permet de connaître la valeur d’un attribut désigné par son nom.

Passez dans refElément la référence d’un élément XML et dans nomAttribut le nom d’attribut dont vous voulez connaître la valeur. La valeur est retournée dans le paramètre valeurAttribut. 4D tentera de convertir la valeur obtenue dans le type de la variable passée en paramètre. Si le type de la variable n'est pas défini, la valeur est retournée par défaut en type texte.

Si aucun attribut nomAttribut n’existe dans l’élément XML, une erreur est retournée. Si plusieurs attributs de l’élément XML portent le nom spécifié, seule la valeur du premier attribut est retournée.

Exemple

Cette méthode permet de récupérer une valeur d’attribut XML à l’aide de son nom :

 C_BLOB(maVarBlob)

 C_TEXTE($ref_XML_Parent;$ref_XML_Enfant)

 C_ENTIER LONG($NumLigne)

 

 $ref_XML_Parent:=DOM Analyser variable XML(maVarBlob)

 $ref_XML_Enfant:=DOM Lire premier element XML enfant($ref_XML_Parent)

 DOM LIRE ATTRIBUT XML PAR NOM($ref_XML_Enfant;"N";$NumLigne)

Si cette méthode est appliquée à l’exemple ci-dessous, $NumLigne contient la valeur 1 :

Variables et ensembles système

Si la commande a été correctement exécutée, la variable système OK prend la valeur 1. Si une erreur se produit, elle prend la valeur 0.

Voir aussi

DOM LIRE ATTRIBUT XML PAR INDEX
DOM SUPPRIMER ATTRIBUT XML