4D v16.3

DOM Chercher element XML

Accueil

 
4D v16.3
DOM Chercher element XML

DOM Chercher element XML 


 

DOM Chercher element XML ( refElément ; xChemin {; tabRefEléments} ) -> Résultat 
Paramètre Type   Description
refElément  Chaîne in Référence d’élément XML
xChemin  Texte in Chemin XPath de l’élément à chercher
tabRefEléments  Tableau chaîne in Liste des références d’éléments trouvés (le cas échéant)
Résultat  Chaîne in Référence de l’élément trouvé (le cas échéant)

La commande DOM Chercher element XML vous permet de rechercher des éléments XML spécifiques 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 DOM). 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é.

Lorsque le tableau chaîne tabRefEléments est passé, la commande le remplit avec la liste des références XML trouvées. Dans ce cas, la commande retourne en résultat le premier élément du tableau tabRefEléments. Ce paramètre est utile lorsque plusieurs éléments de même nom existent à l’emplacement désigné par le paramètre xChemin.

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.

Soit la structure XML suivante :

<Racine>
   <Elem1>
      <Elem2>aaa</Elem2>
      <Elem2>bbb</Elem2>
      <Elem2>ccc</Elem2>
   </Elem1>
</Racine>

Le code suivant permet de récupérer la référence de chaque élément Elem2 dans le tableau tAtrouvés :

 TABLEAU TEXTE(tAtrouvés;0)
 vTrouvé:=DOM Chercher element XML(vRefElem;"/Racine/Elem1/Elem2";tAtrouvés)

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.

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.



Voir aussi  

DOM Compter elements XML
DOM Creer element XML

 
PROPRIÉTÉS 

Produit : 4D
Thème : XML DOM
Numéro : 864
Nom intl. : DOM Find XML element

Cette commande modifie la variable système OKCette commande modifie la variable système ErrorCommande(s) éligible(s) à l'exécution dans un process préemptif

 
HISTORIQUE 

Modifié : 4D v11 SQL

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)