Requêtes XPath
Un document XML se compose d’une hiérarchie d’éléments. Une requête XPath permet de parcourir les éléments et les attributs d’un document XML.
Par exemple pour rechercher les paragraphes dans le document XML suivant :
<body>
<p>The quick brown fox.</p>
<p>Jumped over the lazy dogs.</p>
</body>
La recherche XPath renvoie deux résultats pour la requête XPath suivante :
body/p
Si vous avez spécifié une valeur d’attribut pour l’un des éléments :
<body>
<p>The quick brown fox.</p>
<p audience = "admin">Jumped over the lazy dogs.</p>
</body>
Incluez la valeur d’attribut dans la recherche :
body/p[@audience='admin']
La recherche XPath renvoie un résultat.
Le tableau suivant contient une liste d’exemples de requêtes XPath :
|
Requête XPath |
Recherche |
|---|---|
|
/task |
L'élément <task> où il s'agit d'un nœud de niveau supérieur dans un fichier XML |
|
//task |
L'élément <task> n'importe où dans un fichier XML |
|
//task[@id='shovellingsnow'] |
Un élément <task> où l'attribut d'ID a pour valeur shovellingsnow |
|
task/title |
Tous les éléments <title> qui sont les descendants directs des éléments <task> |
|
task//title |
Tous les éléments <title> figurant dans un élément <task> |
Pour plus d’informations sur XPath, consultez http://www.w3.org/TR/xpath/
Barre d’outils XPath
1)Ouvrez la barre d’outils XPath (Affichage > Barres d’outils > XPath).
Barre d’outils XPath
2)Dans le champ XPath, saisissez la requête et cliquez sur Exécuter.
Les résultats de la requête s’affichent dans le conteneur XPath Builder.
Conteneur XPath Builder
Query Builder est également une interface conviviale permettant de créer des requêtes XPath. Dans le Query Builder, vous pouvez créer (à l’aide de la fonctionnalité de suggestion automatique) et exécuter une requête XPath.
Vous pouvez également spécifier l’étendue de la recherche :
•Fichier actuel
•Tous les fichiers ouverts
•Dossier sélectionné
•Livre ou mappage DITA : cette option est disponible si vous choisissez un mappage ou un livre DITA Map dans le gestionnaire de ressources
Suggestion automatique
La fonction de suggestion automatique fournit les composants suggérés que vous pouvez ajouter à la requête XPath lors de sa création.
Par exemple, dans le XML suivant :
<body>
<p>The quick brown fox.</p>
<p audience = "admin">Jumped over the lazy dogs.</p>
</body>
1)Dans le champ du Query Builder, commencez par saisir entrer une barre oblique (/).
Dès que vous entrez la barre oblique, les suggestions suivantes s’affichent :
Suggestions automatiques
2)Utilisez les touches fléchées pour sélectionner l’option et appuyez sur Entrée pour insérer le composant dans la requête.
3)Pour ajouter un autre élément à la requête, entrez une barre oblique.
Pour ajouter un attribut, vous pouvez également saisir un crochet d’ouverture ([).
La liste de suggestions automatiques contient les composants suivants d’une requête XPath :
Elément (indicateur orange)
Eléments à la position actuelle dans le document actif.
Attribut (indicateur bleu)
Attributs à la position actuelle dans le document actif.
Axes (indicateur vert)
Un axe est une définition du nœud par rapport au nœud actif. Par exemple, parent, enfant, ancêtre.
Cliquez sur la liste déroulante à droite de l’option Activer les suggestions automatiques et décochez l’option Axes pour masquer les axes disponibles dans la liste de suggestions automatiques.
remarque : Vous pouvez choisir de désactiver la fonction de suggestions automatiques dans le Query Builder.
Cliquez sur l’icône Enregistrer pour enregistrer les résultats actuels de la requête XPath.