4D v16.3
DOM Find XML element
- 4D - Langage
-
- XML DOM
-
- Présentation des commandes XML DOM
- DOM Append XML child node
- DOM Append XML element
- DOM CLOSE XML
- DOM Count XML attributes
- DOM Count XML elementsMod
- DOM Create XML element
- DOM Create XML element arrays
- DOM Create XML Ref
- DOM EXPORT TO FILE
- DOM EXPORT TO VAR
- DOM Find XML element
- DOM Find XML element by ID
- DOM Get first child XML element
- DOM Get last child XML element
- DOM Get next sibling XML element
- DOM Get parent XML element
- DOM Get previous sibling XML element
- DOM Get Root XML element
- DOM GET XML ATTRIBUTE BY INDEX
- DOM GET XML ATTRIBUTE BY NAME
- DOM GET XML CHILD NODES
- DOM Get XML document ref
- DOM GET XML ELEMENT NAME
- DOM GET XML ELEMENT VALUE
- DOM Get XML elementMod
- DOM Get XML information
- DOM Insert XML element
- DOM Parse XML source
- DOM Parse XML variable
- DOM REMOVE XML ATTRIBUTE
- DOM REMOVE XML ELEMENT
- DOM SET XML ATTRIBUTE
- DOM SET XML DECLARATION
- DOM SET XML ELEMENT NAME
- DOM SET XML ELEMENT VALUE
DOM Find XML element
| DOM Find XML element ( refElément ; xChemin {; tabRefEléments} ) -> Résultat | ||||||||
| Paramètre | Type | Description | ||||||
| refElément | Chaîne |
|
Référence d’élément XML | |||||
| xChemin | Texte |
|
Chemin XPath de l’élément à chercher | |||||
| tabRefEléments | Tableau chaîne |
|
Liste des références d’éléments trouvés (le cas échéant) | |||||
| Résultat | Chaîne |
|
Référence de l’élément trouvé (le cas échéant) | |||||
La commande DOM Find XML element 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 Find XML element(vRefElem;"Items/Book[15]/Title")
DOM GET XML ELEMENT VALUE(vTrouvé;valeur)
ALERT("La valeur de l’élément est : \""+valeur+"\"")La même recherche peut également être effectuée ainsi :
vTrouvé:=DOM Find XML element(vRefElem;"Items/Book[15]")
vTrouvé:=DOM Find XML element(vTrouvé;"Book/Title")
DOM GET XML ELEMENT VALUE(vTrouvé;valeur)
ALERT("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 :
ARRAY TEXT(tAtrouvés;0)
vTrouvé:=DOM Find XML element(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.
Produit : 4D
Thème : XML DOM
Numéro :
864
Modifié : 4D v11 SQL
4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)
