Rubrique parente : Envoi de données à une application publiée en utilisant des URL

Remarque Pour obtenir des informations complémentaires sur les concepts de cette rubrique, reportez-vous à l'introduction aux services Web et au tutoriel. Les services Web LabVIEW ne sont disponibles que dans les systèmes de développement complet et professionnel de LabVIEW.

Les clients Web utilisent des URL pour échanger des données avec les services Web publiés. Les mappages d'URL et les chaînes de requête font partie des URL :

  • Mappage d'URL : utilisé comme identifiant par le serveur Web hôte pour diriger une requête HTTP à un VI de méthode HTTP ou un fichier statique spécifique. Chaque VI de méthode HTTP et fichier statique a un mappage d'URL.
  • Chaîne de requête : identifie et assigne des valeurs aux paramètres d'entrée du connecteur du VI de méthode HTTP. Vous pouvez ajouter des paramètres d'entrée à la fin d'un mappage d'URL en ajoutant un point d'interrogation, l'étiquette d'une commande, un signe égal et la valeur à assigner à la commande.

Pour un VI de méthode HTTP appelé Additionner.vi, LabVIEW définit automatiquement le mappage d'URL à /Additionner. Si le VI contient les entrées a et b, l'URL et la chaîne de requête /Additionner?b=2&a=3 assignent des valeurs aux entrées. Dans cet exemple, l'URL utilisée par un client est http://127.0.0.1:8080/ServiceWeb/Additionner?b=2&a=3.

Remarque Au lieu d'utiliser les mappages d'URL par défaut, vous pouvez personnaliser des mappages d'URL pour affecter comment les valeurs sont assignées aux paramètres d'entrée d'un VI de méthode HTTP.

Omission des valeurs de paramètres d'entrée dans les chaînes de requête

Un client peut omettre n'importe quel paramètre d'entrée de la chaîne de requête. Si un client omet la valeur d'un paramètre d'entrée, le service Web utilise la valeur par défaut stockée dans le VI pour le terminal d'entrée. Par exemple, étant donné un VI de méthode HTTP appelé Additionner.vi doté de commandes étiquetées a et b, les requêtes HTTP utilisant les mappages d'URL et les chaînes de requête suivants sont valides :

  • /Additionner?b=2&a=3
  • /Additionner?a=3 (utilise la valeur par défaut de la commande b)
  • /Additionner?b=2 (utilise la valeur par défaut de la commande a)
  • /Additionner (utilise les valeurs par défaut des deux commandes)

Personnalisation de mappages d'URL

En général, vous pouvez utiliser les mappages d'URL par défaut pour un service Web. Cependant, dans certains cas d'utilisation avancés, vous voudrez peut-être personnaliser le mappage d'URL d'un VI de méthode HTTP. Effectuez les étapes suivantes pour configurer un mappage d'URL personnalisé pour un VI de méthode HTTP :

  1. Cliquez avec le bouton droit sur l'élément service Web du projet et sélectionnez Propriétés.
  2. Naviguez jusqu'à la page Paramètres des VIs de méthode HTTP de la boîte de dialogue Propriétés du service Web.
  3. Dans la table de VIs, sélectionnez le VI de méthode HTTP dont vous voulez personnaliser le mappage d'URL.
  4. Sur l'onglet Mappage d'URL, désélectionnez l'option Utiliser le mappage d'URL standard pour pouvoir éditer le champ URL. Vous pouvez alors éditer la partie de l'URL qui suit le nom du service Web et la ressource Web à laquelle le VI appartient, le cas échéant. Autrement dit, vous ne pouvez éditer ni l'adresse IP, ni le port, ni le nom du service Web, ni le nom de la ressource Web (s'il y en a une).

Vous pouvez configurer la chaîne de mappage d'URL à n'importe quelle valeur tant que cette valeur commence par une barre oblique et utilise la syntaxe HTTP standard. Vous pouvez ajouter des paramètres d'entrée à la fin d'un mappage d'URL en lui ajoutant une barre oblique, un deux-points et l'étiquette d'une entrée du connecteur du VI de méthode HTTP associé. Remarquez que cette syntaxe est différente de celle utilisée pour ajouter des chaînes de requête à des mappages d'URL par défaut afin de définir des valeurs de paramètres.

/Additionner/:a/:b est un exemple de chaîne de mappage d'URL personnalisée. La chaîne de mappage d'URL /Additionner est la base du mappage d'URL, et /:a/:b configure les paramètres d'entrée du VI de méthode HTTP. Si le mappage d'URL ne contient pas de paramètre d'entrée à passer au VI de méthode HTTP, tous les terminaux d'entrée du VI doivent avoir des valeurs par défaut.

Transmission de multiples fragments à l'aide de mappages d'URL

Vous pouvez créer une URL de navigation personnalisée qui assigne plusieurs fragments de l'URL à un seul terminal d'entrée de chaîne du VI de méthode HTTP. Cette technique est utile pour transmettre des chemins de fichier ou d'autres valeurs hiérarchiques à l'aide d'une URL de navigation.

Par exemple, /:x/*y crée un paramètre d'entrée pour une commande libellée x et une commande libellée y lorsqu'elles sont ajoutées à un mappage d'URL. Vous pouvez alors ajouter une valeur, comme /test/C/directory à la fin de l'URL de navigation personnalisée qui correspond au paramètre d'entrée /:x/*y que vous avez ajouté au mappage d'URL. Dans cet exemple, x est assigné la valeur test et y la valeur C/directory. Le paramètre d'entrée qui contient plus d'un fragment doit se trouver à la fin de l'URL de navigation personnalisée.