XML_GET_ATTRIBUTE

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

Syntaxe

XML_GET_ATTRIBUTE (Reference, @Attribute)

Syntaxe	Description / format
Reference	Référence de l'élément pour lequel vous souhaitez déterminer la valeur d'attribut Format : littéral de script ou variable de script
Attribute	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.

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

Elle a besoin d'une référence pour pouvoir accéder à l'élément. 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 distingue les types d'attributs "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 récupère la valeur de l'attribut "Nom" (de type Liste) et celle de l'attribut "Titre" (de type Texte). Les contenus "Smith" et "on call 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