|
XML_REMOVE_CHILDREN |
Lecture ou modification d'objets |
XML_SET_ATTRIBUTE |
|
Fonction de script : Détermination d'un élément quelconque
XML_SELECT_NODE(Reference, Element)
|
Syntaxe |
Description / format |
|---|---|
|
Référence |
Référence à l'élément servant de point de départ |
|
Elément |
Nom de l'élément recherché, accompagné du chemin à partir du point de départ |
|
Codes retour |
|---|
|
Référence à l'élément recherché. |
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. L'élément (indiqué avec son chemin) est recherché à partir de cet emplacement.
Les références sont utilisées par certains scripts pour se positionner dans le document XML et le modifier. La toute première référence est celle retournée par XML_OPEN. Elle renvoie à l'élément racine. Elle peut être utilisée par XML_SELECT_NODE pour déterminer un élément directement à partir de cet emplacement. La fonction de script peut également obtenir son descripteur à l'aide de XML_GET_FIRST_CHILD ou de XML_GET_NEXTSIBLING. Vous disposez donc de moyens souples pour accéder aux éléments des structures très complexes.
Attention : la recherche porte uniquement sur les éléments qui constituent un sous-élément du point de départ.
L'exemple détermine un élément directement à partir de l'élément racine "Content". 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
Rubriques connexes :
Eléments de script - Lecture ou modification d'objets
Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle