Création d'expressions XPath

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

  1. 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.
  2. Sélectionnez un fichier XML à partir duquel générer l'expression XPath.
  3. 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.
  4. Faites un clic droit dessus et sélectionnez Définir contexte. Il apparaît dans la zone Contexte d'évaluation.
  5. 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.
  6. 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.
  7. 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.
  8. Développez la section Référence de fonctions. Elle contient les options suivantes :
    1. Ensemble de noeuds. Fonctions s'appliquant aux ensembles de noeuds.
    2. Chaîne. Fonctions servant à manipuler des chaînes.
    3. Booléen. Fonctions utilisées pour les opérations booléennes.
    4. Nombre. Fonctions servant à manipuler des valeurs numériques.
    5. XSLT. Fonctions XSLT utilisées dans les expressions XPath.
    6. Défini par l'utilisateur. Fonctions définies par l'utilisateur.
  9. 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.
  10. Développez la section Référence de syntaxe. Elle contient les options suivantes :
    1. Spécificateurs d'axe. Détermine le sens de déplacement dans le document XML.
    2. Tests de noeud. Spécifie quels types de noeuds rechercher.
    3. Opérateurs. Contient les options suivantes :
      1. Ensemble de noeuds. Opérateur servant à combiner ou définir des chemins.
      2. Booléen. Opérateurs servant à comparer des expressions numériques ou de chaîne ou des valeurs booléennes.
      3. Nombre. Opérateurs pouvant servir à manipuler des valeurs numériques.
  11. 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.
  12. 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.
  13. 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
  14. 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 Bouton d'accès à la page de préférences du générateur XPath.
  15. 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.

Que faire ensuite


Commentaires en retour