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.
Procédure
Pour envoyer une demande de service basée sur un fichier WSDL :
- Cliquez sur le bouton Ouvrir le client de services générique
dans la barre d'outils et sélectionnez la page Demandes.
- Cliquez sur 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 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 et sur
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.
- Cliquez sur OK. Le fichier WSDL est ajouté à la Bibliothèque
des demandes.
- 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.
- 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 afin de respecter une définition XSD (XML Schema
Definition) indiquée dans le catalogue de schémas.
- 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.
- 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.
- 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](../images/icon_gsc_generatetest.gif)
).