Une requête XPATH permet de désigner un élément ou un ensemble d'éléments dans une structure arborescente. La syntaxe XPATH retenue pour être utilisée dans l'interrogation des valeurs résultats complexes d'un service Web est non contextuelle ; elle se limite à définir un chemin absolu permettant d'accéder soit à un élément terminal, soit à un élément multiple ([]), soit à un élément auquel sont associés des attributs.
La chaîne décrivant la requête débute toujours par le caractère "/". Ensuite, ce même caractère est utilisé comme caractère de séparation entre un élément père et un élément fils. Le nom des éléments est propre à la définition du résultat complexe de l'opération et du service Web utilisés. Ces informations peuvent être trouvées dans la boîte de dialogue du gestionnaire d'objets Modifier un service Web.
Les éléments multiples ([]) doivent porter un indice précisant le numéro du poste entre crochets (constante numérique ou variable numérique).
Exemple:
L'inscription du service Web GoogleSearch déclare trois opérations dont l'opération doGoogleSearch.
Celle-ci se caractérise par un paramètre résultat de type complexe (structure arborescente) nommé return.
La structure arborescente complète du résultat est la suivante :
return
|_ Bool documentFiltering
|_ Alpha searchComments
|_ Entier estimatedTotalResultsCount
|_ Bool estimateIsExact
|_ resultElements
| |_#[]
| |_ Alpha summary
| |_ Alpha URL
| |_ Alpha snippet
| |_ Alpha title
| |_ Alpha cachedSize
| |_ Bool relatedInformationPresent
| |_ Alpha hostName
| |_ Alpha hostName
| |_ directoryCategory
| | |_ Alpha fullViewableName
| | |_ Alpha specialEncoding
| |_ Alpha directoryTitle
|_ Alpha searchQuery
|_ Entier startIndex
|_ Entier endIndex
|_ Alpha searchTips
|_ directoryCategories
| |_#[]
| |_ Alpha fullViewableName
| |_ Alpha specialEncoding
|_ Réel searchTime
Dans le cadre de la consommation d'un service Web, les éléments pour lesquels une valeur peut être retournée sont les éléments terminaux de la structure arborescente. Dans celle-ci, ces éléments sont précédés par le type de la valeur retournée. La valeur associée à l'un de ces éléments peut être récupérée à l'aide de l'ordre SW_RECUP_VAL.
Pour récupérer la valeur de l'élément terminal snippet, la requête XPATH utilisée comme paramètre de l'ordre SW_RECUP_VAL est la suivante :
/return/resultElements/#[indice]/snippet
La valeur retournée est de type ALPHA. Aucune longueur exacte n'étant précisée par le service Web, la variable réceptrice devra être dimensionnée de façon judicieuse.
Il est à noter que l'élément # est un élément multiple ; par conséquent, il doit porter un indice. Pour connaître le nombre de postes valides pour cet élément #, il faut utiliser l'ordre SW_COMPTER_VAL avec la requête XPATH suivante :
/return/resultElements/#
La valeur retournée par l'ordre SW_COMPTER_VAL est toujours une variable numérique.
Remarque : La casse doit être respectée dans l'utilisation du nom de ces éléments.