XML_SELECT_NODE

Fonction de script : Identifie un élément quelconque

Syntaxe

XML_SELECT_NODE (Reference, Element)

Syntaxe	Description / format
Reference	Référence de l'élément servant de point de départ Format : littéral de script ou variable de script
Element	Nom de l'élément avec le chemin du point de départ Format : littéral de script ou variable de script

Codes retour
Référence de l'élément recherché. " " : l'élément recherché n'existe pas.

La fonction de script identifie un élément quelconque dans le document XML.

Un descripteur doit être transmis à la fonction de script pour qu'elle se positionne au niveau d'un élément. Cet élément constitue le point de départ de la recherche dans la structure. A partir de là, l'élément est recherché à partir de cet emplacement.

Des éléments de script spécifiques utilisent des descripteurs pour se positionner dans le document XML et le modifier. Le tout premier descripteur est celui retourné par XML_OPEN. Il renvoie à l'élément racine. Il peut être utilisé par XML_SELECT_NODE pour identifier directement un élément. La fonction de script peut aussi recevoir son descripteur de XML_GET_FIRST_CHILD ou de XML_GET_NEXTSIBLING. Ceci montre qu'il existe différentes façons d'accéder aux éléments dans des structures ramifiées.

Notez que la recherche porte uniquement sur les éléments qui sont des sous-élément du point de départ.

Exemple

L'exemple identifie un élément directement à partir de l'élément racine "Content" de la documentation structurée. Le texte de l'élément "Objets" est affiché dans le rapport d'activation.

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

:SET &HND# = XML_SELECT_NODE(&XMLDOCU#, "Description/Objects")
:SET &TEXT# = XML_GET_NODE_TEXT(&HND#)
:PRINT "Text of the element: &TEXT#"

:XML_CLOSE