GRDF

PROJET OMEGA

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.

1
Date limite de validité :
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

GrDF_Tutoriel soapUI_Exemples de WS_V0.doc

Tutoriel soapUI

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

2/9
Tutoriel soapUI

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.

3/9
Tutoriel soapUI

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.

4/9
Tutoriel soapUI

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 ».

5/9
Tutoriel soapUI

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.

6/9
Tutoriel soapUI

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

7/9
Tutoriel soapUI

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é.

8/9
Tutoriel soapUI

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.

9/9