Altova MobileTogether Designer

Navigation: Commandes de menu > Projet

Fonctions XPath/XQuery

Accueil Préc Haut Suivant

Ouvre le dialogue Fonctions XPath qui regroupe toutes les fonctions XPath définies par l'utilisateur. Ces fonctions XPath peuvent être utilisées dans toutes les expressions XPath du projet. Vous pouvez ajouter et supprimer des fonctions en utilisant les icônes correspondantes dans la barre d'outils du dialogue. Pour éditer la définition d'une fonction, cliquez sur le bouton Éditer l'expression XPath de la fonction.

Ajouter une nouvelle fonction XPath définie par l'utilisateur

L'ajout d'une nouvelle fonction définie par l'utilisateur nécessite deux étapes : (i) la déclaration de la fonction et (ii) la définition de la fonction.

Pour ajouter une nouvelle fonction, procéder comme suit : cliquer sur Ajouter dans la barre outils du dialogue (voir capture d'écran ci-dessus). Le dialogue de Nouvelle fonction XPath s'affiche (capture d'écran ci-dessous).

Dans ce dialogue, vous pouvez déclarer le nom de la fonction, spécifier le nombre de paramètres de fonction (arguments) et leurs types et spécifier le type de retour de la fonction. Dans la capture d'écran ci-dessus, nous avons déclaré une fonction pour convertir un nombre décimal de Celsius en Fahrenheit. La fonction prend un paramètre, qui est l'entrée de la valeur Celsius en tant que décimale. Elle sortira une valeur décimale, la température Fahrenheit. L'étape suivante définit ce que la fonction effectue. Après la déclaration de la fonction (capture d'écran ci-dessus), cliquer sur OK. Le dialogue Éditer la fonction XPath s'affiche (capture d'écran ci-dessous), qui contient le modèle de la fonction nouvellement déclarée et dans laquelle vous pouvez à présent définir la fonction.

Saisir la définition de la fonction entre les parenthèses. Dans la définition indiquée dans la capture d'écran ci-dessus, $a est le paramètre d'entrée. Cliquer sur OK une fois que vous avez terminé. La fonction sera ajoutée à la liste des fonctions définies par l'utilisateur dans le dialogue de Fonctions XPath et peut être utilisée dans toutes les expressions XPath du projet.

Note :

Les fonctions XPath définies par l'utilisateur ne doivent pas nécessairement être placées dans un espace de nom séparé. Par conséquent, aucun préfixe d'espace de nom n'est nécessaire lors de la définition ou l'appel d'une fonction définie par l'utilisateur. L'espace de nom XPath par défaut est utilisé pour toutes les fonctions XPath/XQuery, y compris les fonctions d'extension et les fonctions définies par l'utilisateur. Pour éviter toute ambiguïté en ce qui concerne les fonctions intégrées, nous vous recommandons d'écrire les fonctions définies par l'utilisateur en lettres majuscules.