Envoi de demandes de service à l'aide de fichiers WSDL

Vous pouvez envoyer des demandes à des services basés sur SOAP, JMS (Java Messaging Service), WebSphere MQ et Microsoft .NET qui utilisent un fichier WSDL (Web Service Description Language) pour indiquer le contenu de la demande de service.

Avant de commencer

Vérifiez que vous disposez d'un fichier WSDL valide, accessible soit sur le système de fichiers, dans l'espace de travail, à une URL spécifique, soit dans un IBM® WebSphere Service Registry and Repository ou un référentiel UDDI (Universal Description Discovery and Integration).

Vérifiez que les fichiers WSDL utilisent la syntaxe correcte pour l'environnement de test. Le client de service générique peut ne pas fonctionner avec certains fichiers WSDL.

Si le service utilise l'authentification SSL (Secure Sockets Layer), créez une configuration SSL avant d'envoyer la demande. Pour plus d'informations, voir Création de configurations SSL.

Si le service utilise la sécurité SOAP pour le chiffrement, la signature, ou d'autres algorithmes de sécurité, vous devez d'abord configurer l'environnement avec les bibliothèques et les fichiers de configuration appropriés, puis créer un profil de sécurité pour le WSDL. Pour plus d'informations, voir Configuration de l'environnement pour la sécurité SOAP et Création de profils de sécurité pour des fichiers WSDL.

Pour importer un fichier WSDL à partir d'un site sécurisé nécessitant l'authentification mutuelle, vous devez disposer du fichier de clés dans l'espace de travail.

Pourquoi et quand exécuter cette tâche

Lorsque vous créez un appel à partir d'un fichier WSDL, l'appel est automatiquement configuré avec les points d'extrémité SOAP, JMS, WebSphere MQ, ou Microsoft .NET disponibles dans le fichier WSDL. Sélectionnez la configuration de transport correspondante sur la page Transport de la demande.
Remarque : Pour les exigences spécifiques relatives à la prise en charge de Microsoft .NET, voir Création de configurations de transport Microsoft .NET.

Procédure

Pour envoyer une demande de service basée sur un fichier WSDL :

  1. Cliquez sur le bouton Ouvrir le client de services générique Ouvrir le bouton Client de service générique dans la barre d'outils et sélectionnez la page Demandes.
  2. Cliquez sur Ajouter Bouton Ajouter et sélectionnez la méthode pour importer un fichier WSDL ou cliquez sur le bouton de raccourci correspondant sur la page principale.
    • Cliquez sur Ajouter un WSDL à partir de l'espace de travail pour ajouter un fichier WSDL à partir de l'espace de travail local.
    • Cliquez sur Ajouter un WSDL à partir du système de fichiers pour ajouter un fichier WSDL à partir du système de fichiers.
    • Cliquez sur Ajouter un WSDL à partir d'une URL pour télécharger et importer un fichier WSDL en ligne à partir du Web.
    • Cliquez sur Ajouter un WSDL à partir d'un référentiel WSRR pour importer ajouter un WSDL à partir de WebSphere Service Registry and Repository. Entrez l'URL du WebSphere Service Registry and Repository et cliquez sur Connexion. Vous pouvez cliquer sur Rechercher Rechercher pour parcourir le contenu du référentiel.
    • Cliquez sur Ajouter un WSDL à partir d'un référentiel UDDI pour importer un fichier WSDL à partir d'un référentiel UDDI (Universal Description Discovery and Integration). Entrez l'URL du référentiel UDDI et cliquez sur Connexion. Vous pouvez cliquer sur Filtrer Filtrer et sur Rechercher Rechercher pour parcourir le contenu du référentiel.
    Remarque : Si vous importez le fichier WSDL à partir d'un site sécurisé nécessitant l'authentification par certificat, cliquez sur Importer les propriétés puis, pour Fichier de clés, sélectionnez le fichier de clés contenant le certificat à fournir au serveur et, pour Mot de passe de fichier de clés, entrez le mot de passe.
  3. Cliquez sur OK. Le fichier WSDL est ajouté à la Bibliothèque des demandes.
  4. Dans la Bibliothèque des demandes, développez le fichier WSDL, la liaison et l'opération, et sélectionnez l'élément d'appel. Le client de service générique présente trois étapes : Editer les données, Appeler et Afficher la réponse. Les détails pour l'appel sont affichés sous l'étape Editer les données.
  5. Sur la page Message, utilisez les vues Formulaire, Arborescence ou Source pour éditer le contenu de la demande. Chaque vue propose un affichage différent des mêmes données. Si vous voulez ajouter ou supprimer des éléments XML dans les vues Formulaire ou Arborescence, cliquez sur Schéma > Validation et assistance afin de respecter une définition XSD (XML Schema Definition) indiquée dans le catalogue de schémas.
  6. Sur la page Transport, spécifiez la configuration de transport pour la demande. Les informations de transport à partir du fichier WSDL sont importées automatiquement dans la configuration de transport.

    Pour Microsoft .NET, sélectionnez la configuration de transport correspondante et indiquez l'emplacement du fichier soaclient.exe.config. Ce fichier doit être créé manuellement. Pour plus d'informations, voir Création de configurations de transport Microsoft .NET.

    Remarque : Si vous utilisez IBM Security AppScan, seuls les protocoles de transport HTTP et .Net sont disponibles.
  7. Sur la page Pile de demande, indiquez si vous souhaitez remplacer les algorithmes de sécurité ou de traitement appliqués à la demande sortante pour le fichier WSDL. Cliquez sur Afficher la pile de réponse pour ajouter une page Pile de réponse afin d'éditer les algorithmes de sécurité ou de traitement pour les réponses entrantes.
    Remarque : Ces paramètres s'appliquent uniquement à la demande en cours. Pour éditer la pile de demande ou de réponse pour toutes les demandes utilisant le fichier WSDL en cours, cliquez sur Editer la sécurité WSDL pour ouvrir l'Editeur de sécurité WSDL.
  8. Lorsque vous êtes prêt à envoyer la demande de service, cliquez sur Appeler. Le client de service générique envoie la demande et affiche le retour de message sous l'étape Afficher la réponse.

Que faire ensuite

Les demandes qui aboutissent sont enregistrées et ajoutées à la liste Historique des demandes. Si vous utilisez IBM Rational Performance Tester ou IBM Rational Service Tester for SOA Quality, vous pouvez créer un test de service en cliquant sur le bouton Générer la suite de tests (Générer la suite de tests).

Retour d'informations