Le langage XPath (XML Path Language) est un sous-langage XSL uniquement destiné à identifier ou traiter des éléments d'un document XML source. Une expression XPath peut être utilisée pour effectuer une recherche sur un document XML et en extraire des informations provenant des noeuds (toute partie d'un document, tel qu'un élément ou un attribut).
Vous pouvez lancer l'assistant d'expression XPath de l'une des manières suivantes :
- A partir du menu contextuel de tout attribut select ou match d'un fichier XSL. Sélectionnez l'attribut, cliquez dessus avec le bouton droit de la souris et cliquez sur Expression XPath.
- Depuis n'importe lequel des assistants d'éditeur XSL où vous pouvez spécifier une expression XPath pour une valeur de zone. Dans l'assistant approprié, cliquez sur le bouton XPath.
Pour plus d'informations sur XPath, voir www.w3.org/TR/xpath
.
Pour créer une expression XPath à l'aide de l'assistant d'expression XPath, effectuez les opérations suivantes :
- Lancez l'assistant d'expression XPath à l'aide de l'une des méthodes décrites précédemment.
- Sélectionnez un fichier XML à utiliser pour générer votre expression XPath.
- Dans la page Arborescence source, sélectionnez le noeud destiné à être votre 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 tout noeud contenu dans le noeud racine.
- Cliquez dessus avec le bouton droit de la souris et cliquez sur Définir le contexte. Il apparaît dans la zone Contexte d'évaluation.
- La zone vide sous la zone Contexte d'évaluation contient votre expression XPath. Vous pouvez la créer ou la modifier en sélectionnant les options appropriées à partir des pages d'arborescence source et de référence dans l'assistant d'expression XPath.
- La page Arborescence source répertorie tous les noeuds (comme les attributs et les éléments) dans votre document XML. Sélectionnez le noeud que vous voulez rechercher, cliquez dessus avec le bouton droit de la souris et cliquez sur Ajouter à l'expression. Le noeud apparaîtra dans la zone d'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 Référence de fonctions. Vous y trouverez les options suivantes :
- Ensemble de noeud. Fonctions qui s'appliquent aux ensembles de noeuds.
- Chaîne. Fonctions utilisées pour gérer les chaînes.
- Booléen. Fonctions utilisées pour les mathématiques booléennes.
- Nombre. Fonctions utilisées pour manipuler les valeurs numériques.
- XSLT. Fonctions XSLT utilisées dans les expressions XPath.
- Défini par l'utilisateur. Fonctions définies par l'utilisateur.
- Développez l'option Référence de fonctions que vous voulez utiliser puis cliquez dessus avec le bouton droit de la souris et cliquez sur Ajouter à l'expression pour l'ajouter à votre expression XPath. Pour plus d'informations sur chaque option, vous pouvez la sélectionner et 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 Référence de syntaxe . Vous y trouverez les options suivantes :
- Spécificateurs d'axe. Détermine la direction de déplacement au sein de votre document XML.
- Tests de noeud. Spécifie quels types de noeuds rechercher.
- Opérateurs. Contient les options suivantes :
- Ensemble de noeuds. Opérateurs utilisés pour combiner ou définir des chemins
- Booléen. Opérateurs utilisés pour comparer des expressions numériques ou de chaîne ou des valeurs booléennes.
- Nombre. Opérateurs utilisés pour manipuler des valeurs numériques.
- Développez l'option Référence de syntaxe que vous voulez utiliser puis cliquez dessus avec le bouton droit de la souris et cliquez sur Ajouter à l'expression pour l'ajouter à votre expression XPath. Pour plus d'informations sur chaque option, vous pouvez la sélectionner et 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 peut être appelé en cliquant sur Ctrl
+ espace. Cliquez deux fois sur l'option que vous voulez ajouter à votre expression XPath
- Votre expression XPath est automatiquement évaluée lorsque vous la créez. Les résultats apparaîtront au format de noeud dans la page Arborescence de résultats. Cliquez sur l'onglet Source du résultat si vous voulez afficher vos résultats au format code source. Si vous ne voulez pas que votre expression XPath soit automatiquement évaluée lorsque vous la saisissez, vous pouvez modifier cette option dans la page de préférences du générateur d'expression XPath. Cliquez sur le bouton Page de préférences du générateur XPath
pour y accéder.
- Cliquez sur OK lorsque vous avez terminé votre expression XPath.
Si vous avez lancé l'assistant d'expression XPath en utilisant l'éditeur XSL, votre expression XPath apparaît dans votre fichier XSL après avoir cliqué sur OK.
Si vous l'avez lancé à l'aide de l'assistant d'éditeur XSL, elle apparaîtra dans la zone que vous avez créée.