Le langage XPath (XML Path Language)
est un sous-langage de XSL conçu pour identifier ou adresser sans équivoque des parties d'un document
XML source. Une expression XPath peut servir à parcourir l'arbre d'un document
XML et à extraire les informations d'un noeud (toute partie du document, telle qu'un élément ou un attribut).
Pourquoi et quand exécuter cette tâche
Le langage XPath (XML Path Language)
est un sous-langage de XSL conçu pour identifier ou adresser sans équivoque des parties d'un document
XML source. Une expression XPath peut servir à parcourir l'arbre d'un document
XML et à extraire les informations d'un noeud (toute partie du document, telle qu'un élément ou un attribut).
Pour plus d'informations sur
XPath, consultez les ressources suivantes :
Pour créer une expression XPath à l'aide de l'assistant d'expression XPath, procédez
comme suit :
Procédure
- Lancez l'assistant d'expression XPath en utilisant l'une des techniques suivantes :
- Pour un attribut select ou match dans
un fichier XSL, faites un clic droit sur cet attribut et, dans son menu contextuel,
sélectionnez Expression XPath.
- Depuis n'importe lequel des assistants de l'éditeur XSL où vous pouvez spécifier une expression XPath en guise
de valeur de zone. Dans l'assistant approprié, cliquez sur le bouton XPath.
- Sélectionnez un fichier XML à partir duquel générer l'expression XPath.
- Dans la page Arborescence source, sélectionnez le noeud que vous voulez utiliser comme
noeud de contexte. Le noeud de contexte est le point de départ de votre expression XPath ; il peut s'agir du noeud racine du
document ou de tout noeud contenu dans le noeud racine.
- Faites un clic droit dessus et sélectionnez Définir contexte. Il apparaît dans la zone Contexte d'évaluation.
- La zone vide, en dessous de la zone Contexte d'évaluation, est destinée à
contenir votre expression XPath. Vous pouvez créer ou modifier votre expression en sélectionnant les options appropriées dans les pages Arborescence
source et Référence de l'assistant d'expression XPath.
- La page Arborescence source affiche la liste de tous les noeuds (tels que les
attributs et les éléments) de votre document XML. Sélectionnez le noeud que vous voulez rechercher, faites
un clic droit dessus et sélectionnez Ajouter à l'expression. Le noeud apparaît dans la zone de création de l'expression. Vous pouvez répéter ce processus pour tous les noeuds
que vous voulez ajouter à l'expression.
- Cliquez sur l'onglet Référence. La page Référence vous permet de spécifier des fonctions, des opérateurs et un chemin
d'emplacement pour votre expression XPath.
- Développez la section Référence de fonctions. Elle contient les options suivantes :
- Ensemble de noeuds. Fonctions s'appliquant aux ensembles de
noeuds.
- Chaîne. Fonctions servant à manipuler
des chaînes.
- Booléen. Fonctions utilisées pour les opérations
booléennes.
- Nombre. Fonctions servant à manipuler des
valeurs numériques.
- XSLT. Fonctions XSLT utilisées dans les
expressions XPath.
- Défini par l'utilisateur. Fonctions définies
par l'utilisateur.
- Dans la section Référence de fonctions, développez la branche de l'option avec laquelle vous souhaitez
travailler, faites un clic droit dessus et sélectionnez Ajouter à l'expression pour
l'ajouter à votre expression XPath. Pour plus d'informations sur une option, sélectionnez-la ; des informations la concernant
apparaîtront dans la partie inférieure de la page Référence, dans le volet Détails. Vous pouvez également vous référer
aux fichiers de référence associés.
- Développez la section Référence de syntaxe. Elle contient les options suivantes :
- Spécificateurs d'axe. Détermine le sens
de déplacement dans le document XML.
- Tests de noeud. Spécifie quels types de noeuds rechercher.
- Opérateurs. Contient les options suivantes :
- Ensemble de noeuds. Opérateur servant à combiner ou définir des chemins.
- Booléen. Opérateurs servant à comparer des expressions numériques ou de chaîne
ou des valeurs booléennes.
- Nombre. Opérateurs pouvant servir à manipuler des
valeurs numériques.
- Dans la section Référence de syntaxe, développez la branche de l'option avec laquelle vous souhaitez
travailler, faites un clic droit dessus et sélectionnez Ajouter à l'expression pour
l'ajouter à votre expression XPath. Pour plus d'informations sur une option, sélectionnez-la ; des informations la concernant
apparaîtront dans la partie inférieure de la page Référence, dans le volet Détails. Vous pouvez également vous référer
aux fichiers de référence associés.
- Vous pouvez également éditer manuellement votre expression dans la zone
d'expression. L'assistant de contenu est disponible et vous
pouvez l'appeler en cliquant sur Ctrl + Espace. Faites un double clic sur l'option
que vous voulez ajouter à votre
expression XPath.
- Vous pouvez désigner le processeur à utiliser pour évaluer
l'expression XPath. Dans le générateur d'expression XPath, en haut à droite du volet
Arborescence des résultats, cliquez sur l'icône du menu déroulant
et sélectionnez l'une des options suivantes :
- Processeur IBM pour XPath 1.0
- Processeur IBM pour XPath 2.0
- Votre expression XPath est automatiquement évaluée à mesure
que vous la créez. Son résultat apparaît au format noeud, dans le volet
Arborescence des résultats. Cliquez sur l'onglet Source des résultats si vous voulez
voir les résultats de l'expression au format code source. Si vous ne voulez pas que votre expression XPath soit évaluée automatiquement pendant que vous la tapez, vous
pouvez changer ce comportement dans la page de préférences du générateur
d'expression XPath. Pour y accéder,
cliquez sur le bouton Page de préférences du générateur XPath
.
- Cliquez sur OK lorsque vous avez terminé votre expression XPath.
Résultats
Si vous avez lancé l'assistant d'expression XPath en utilisant l'éditeur XSL, votre expression XPath
apparaît dans votre fichier XSL une fois que vous avez cliqué sur OK.
Si vous l'avez lancé depuis un assistant de l'éditeur XSL, elle apparaît dans la zone pour laquelle
vous l'avez créée.