version 2003
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 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.
4e Dimension tentera de convertir la valeur obtenue dans le type de la variable passée en paramètre.
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.
Exemples
Cette méthode permet de récupérer une valeur d'attribut XML à l'aide de son nom :
C_BLOB(maVarBlob) C_ALPHA(16;$ref_XML_Parent;$ref_XML_Enfant) C_ENTIER LONG($NumLigne) $ref_XML_Parent:=Analyser variable XML(maVarBlob) $ref_XML_Enfant:=Lire premier element XML($ref_XML_Parent) 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 :
Référence
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.