Manuel des Scripts Automation Engine > Organisation fonctionnelle > Lecture ou modification d'objets > XML_GET_ATTRIBUTE

XML_GET_ATTRIBUTE

Fonction de script : indication la valeur d'un attribut d'un élément.

Syntaxe

XML_GET_ATTRIBUTE (Reference, @Attribute)

Syntaxe	Description / format
Référence	Référence à l'élément dont vous souhaitez déterminer la valeur d'attribut Format : littéral de script ou variable de script
Attribut	Nom de l'attribut commençant par "@" Format : littéral de script ou variable de script

Codes retour
Contenu de l'attribut. " " - L'attribut n'a aucune valeur ou l'élément ne comporte pas d'attribut.

Commentaires

Cette fonction de script permet de lire la valeur d'attribut d'un élément dans un document XML.

Pour que la fonction de script accède à l'élément, une référence doit lui être transmise. Cette référence est fournie par des éléments de scripts qui peuvent être positionnés dans le document XML, comme XML_GET_FIRST_CHILD, XML_GET_NEXTSIBLING, XML_SELECT_NODE ou XML_OPEN.

La documentation structurée comporte deux types d'attribut distincts, "Texte" et "Liste", tous deux lisibles par XML_GET_ATTRIBUTE.

Il n'existe pas de limite pour la valeur retournée.

Exemples

L'exemple suivant permet de déterminer la valeur de l'attribut "Nom" (de type Liste) et celle de l'attribut "Titre" (de type Texte). Les contenus "Henri" et "Disposition 2012" sont affichés dans le rapport d'activation.

:SET &XMLDOCU# = XML_OPEN(DOCU,"ON_CALL","@Details")

: SET &HND# = XML_GET_FIRST_CHILD(&XMLDOCU#)
: SET &HND# = XML_GET_NEXTSIBLING(&HND#)
: SET &NAME# = XML_GET_ATTRIBUTE(&HND#, "@Name")
: PRINT "attribute value: &NAME#"
: SET &TITLE# = XML_GET_ATTRIBUTE(&HND#, "@Title")
: PRINT "attribute value: &TITLE#"

:XML_CLOSE

Rubriques connexes :

Eléments de script - Lecture ou modification d'objets

Documentation structurée

www.w3c.org/TR/xmlbase

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle