DOM Chercher element XML

4D - Documentation   Français   English   German   4e Dimension, Commandes par thèmes   4e Dimension, Liste alphabétique des commandes   4e Dimension, Constantes par thèmes   Retour   Précédent   Suivant

version 2004


DOM Chercher element XML (refElément; xChemin) refElément

ParamètreTypeDescription
refElémentChaîneRéférence d'élément XML
xCheminTexte | BLOBChemin XPath de l'élément à chercher
RésultatrefElémentRéférence de l'élément trouvé (le cas échéant)

Description

La commande DOM Chercher element XML vous permet de rechercher un élément XML spécifique dans une structure XML. La recherche débute à l'élément désigné par le paramètre refElément.

Le noeud XML à chercher est défini par le paramètre xChemin, exprimé en notation XPath (cf. paragraphe "Utilisation de la notation XPath" dans la section Présentation des commandes XML). Il est possible d'utiliser des éléments indexés.

Note : Conformément à la norme XML, la recherche différencie les majuscules et les minuscules.

La commande retourne en résultat la référence XML de l'élément trouvé.

Exemple

Cet exemple permet de rechercher rapidement un élément XML et d'afficher sa valeur :

   vTrouvé:=DOM Chercher element XML(vRefElem;"Items/Book[15]/Title")
   DOM LIRE VALEUR ELEMENT XML(vTrouvé;valeur)
   ALERTE("La valeur de l'élément est : \""+valeur+"\"")

La même recherche peut également être effectuée ainsi :

   vTrouvé:=DOM Chercher element XML(vRefElem;"Items//Book[15]")
   vTrouvé:=DOM Chercher element XML(vTrouvé;"Book/Title")
   DOM LIRE VALEUR ELEMENT XML(vTrouvé;valeur)
   ALERTE("La valeur de l'élément est : \""+valeur+"\"")

Note : Comme vous pouvez le constater dans l'exemple ci-dessus, le chemin XPath doit toujours débuter par le nom de l'élément courant. Cette précision est importante lorsque vous manipulez des chemins XPath relatifs.

Référence

DOM Compter elements XML, DOM Creer element XML.

Variables et ensembles système

Si la commande a été exécutée correctement, la variable système OK prend la valeur 1, sinon elle prend la valeur 0 et une erreur est générée.

Gestion des erreurs

Une erreur est générée lorsque :

la référence de l'élément n'est pas valide

le chemin xPath passé n'est pas valide.


4D - Documentation   Français   English   German   4e Dimension, Commandes par thèmes   4e Dimension, Liste alphabétique des commandes   4e Dimension, Constantes par thèmes   Retour   Précédent   Suivant