Remerciez-le!

Remerciez @Admin pour avoir partagé cet document gratuitement, de la manière la plus simple, en partageant sur les réseaux sociaux.

GRDF P R O J E T O ME G A GrDF_Tutoriel soapUI_Exemples de WS_V0.doc Ouverture

GRDF P R O J E T O ME G A GrDF_Tutoriel soapUI_Exemples de WS_V0.doc Ouverture du Marché de l'Energie et Gestion de l'Acheminement TUTORIEL SOAPUI POUR LA REALISATION DES TESTS DE WEB SERVICES SUR L’ENVIRONNEMENT HOMOLOGATION Résumé : (nom de fichier = GrDF_Tutoriel soapUI.doc) Ce document a pour objectif de montrer au lecteur comment utiliser le logiciel soapUI afin de se connecter à l’environnement Homologation. . Date limite de validité1 : Accessibilité : Confidentialité : Historique des modifications Version Date Nature de la modification V0 14/04/2011 Initialisation du document 1 Validité permanente si pas de date limite Tutoriel soapUI 2/9 SOMMAIRE 1. OBJECTIF ........................................................................................................................................ 3 2. PRE-REQUIS .................................................................................................................................... 3 2.1. OBTENIR SOAPUI ....................................................................................................................... 3 2.2. FICHIERS FOURNIS PAR GRDF .................................................................................................... 3 3. CONFIGURATION ......................................................................................................................... 3 3.1. CREATION DU MAGASIN DE CONFIANCE .................................................................................... 3 3.2. INSTALLATION DU CERTIFICAT .................................................................................................. 3 4. CREATION D’UN PROJET ........................................................................................................... 4 4.1. INSTALLATION DES WSDL ........................................................................................................ 4 4.2. CREATION DE TESTS ................................................................................................................... 5 4.2.1. Création d’une suite de tests ................................................................................................. 5 4.2.2. Test du web service RecupererDonneesPCE ......................................................................... 6 4.2.3. Vérification de l’URL ............................................................................................................ 9 4.3. EXECUTION DU TEST .................................................................................................................. 9 Tutoriel soapUI 3/9 1. OBJECTIF L’objectif de ce document est d’expliquer l’utilisation de soapUI dans le cadre de tests de web services sur l’environnement Homologation. soapUI est un logiciel très puissant utilisé pour le développement et les tests de web services. Il existe en deux versions : une version pro payante et une version gratuite. Nous utiliserons la version gratuite dans ce document. 2. PRE-REQUIS 2.1. Obtenir soapUI soapUI peut être obtenu à l’adresse suivante : http://www.soapui.org Dans ce document, nous utiliserons la version 3.0.1 mais la version la plus récente lors de la rédaction est la 3.6.1. Le logiciel doit être installé et opérationnel pour la suite du document. 2.2. Fichiers fournis par GrDF Le lecteur doit être en possession des fichiers suivants : - WSDL - Certificats pour Homologation - Des jeux de données pour Homologation 3. CONFIGURATION 3.1. Création du magasin de confiance Les deux certificats (ca.pem et OMEGA-cassl.pem) permettant de valider nos certificats doivent être importés dans le magasin de confiance de soapUI. L’import de ces certificats se fait via les deux commandes suivantes : keytool -import -alias ca-root -file ca.pem -keystore trustore.jks keytool -import -alias ca-int -file OMEGA-cassl.pem -keystore truststore.jks Important : Noter le mot de passe du magasin 3.2. Installation du certificat Aller dans File > Preferences > SSL Settings dans soapUI. Tutoriel soapUI 4/9 Nous allons utiliser le certificat fourni au format pfx. Le mot de passe est le nom du fichier sans l’extension. Il est également nécessaire de configurer le magasin de confiance. 4. CREATION D’UN PROJET 4.1. Installation des WSDL En premier lieu, il convient de créer un projet soapUI. Pour cela, aller dans File > New soapUI Project. Tutoriel soapUI 5/9 Le projet créé apparait dans la liste des projets de soapUI. Pour ajouter un WSDL, réaliser un clic droit sur le projet choisir la fonction « Add WSDL » puis sélectionner un WSDL livré. Recommencer l’opération pour les autres WSDL. 4.2. Création de tests 4.2.1. Création d’une suite de tests Effectuer un clic droit sur le nom du projet et choisir « New TestSuite ». Tutoriel soapUI 6/9 Ensuite, effectuer un clic droit sur la suite de tests nouvellement créée. 4.2.2. Test du web service RecupererDonneesPCE Pour créer une requête de test, il convient de respecter les étapes suivantes : 1) Double-cliquer sur le nom du cas de test créé (« Tests WS » dans notre cas). 2) Effectuer un clic droit dans la fenêtre qui vient d’apparaitre (la partie vide au milieu). 3) Choisir Append Step > Test Request 4) Entrer le nom du test. Nous allons tester le web service RecupererDonneesPCE dans ce tutoriel. Tutoriel soapUI 7/9 5) Choisir l’opération adéquate Cocher les cases conformément à la capture ci-dessous L’outil va alors créer un squelette de requête Tutoriel soapUI 8/9 L’étape suivant consiste à remplir les champs conformément aux guides d’implémentation et en fonction des jeux de données fournis par GrDF dans le fichier Synthèse JDD en utilisant les données relatives au PCE a. Note importante : Il faut impérativement supprimer la balise <soapenv :Header/> générée par soapUI en raison d’une règle de sécurité. Tutoriel soapUI 9/9 4.2.3. Vérification de l’URL Le dernier point à vérifier est l’url : https://homologation-services.gazdefrance-distribution.com:7022 4.3. Exécution du test Pour lancer un test, il cliquer sur la flèche verte. Si tout est correctement configuré, OMEGA doit renvoyer une réponse similaire à la capture ci-dessous. uploads/s1/ grdf-tutoriel-soapui-exemples-de-ws-v0.pdf