Introduction

Objet du document

L'objet de ce manuel est de présenter comment installer, paramétrer et utiliser le Simulateur ETS (Injecteur IDB/CLC/SIM/DEL). Cet outil a été développé par KEREVAL et est basé sur la solution SoapUI (outil de test de web-services permettant l'exécution et le contrôle automatisé des échanges SOAP avec une application client ou serveur).

Portée du document

Ce document est à destination des Assurances Maladie Complémentaire (AMC), membre de l'Association INTER-AMC, les membres de l'équipe projet KEREVAL et toute autre partie prenante du projet ROC.

Accès à la documentation

Les livrables se trouvent sur la plate-forme de test, dans la partie "Simulateur ETS":

Ou directement à cette adresse

Le répertoire contient les éléments suivants:

  • Les fichiers paramétrables(XML) des cas de test utilisés par le simulateur(CasDeTestAMC_VX.zip)
  • Le simulateur ETS comprenant 1 projet SoapUI

Installation du simulateur ETS

Pré requis d'installation

La technologie JAVA doit être installée sur la machine où sera déployé le simulateur. Si vous ne possédez pas JAVA, vous pouvez l'installer à partir de l'URL suivante:

Installation de l'outil SoapUI

L'outil SoapUI peut être téléchargé à partir de l'URL suivante:

Vous arriverez sur la page d'accueil du site. La version de l'outil présenté dans ce manuel est la v5.2.1.

  • Cliquez sur l'onglet «SoapUI» (onglet affiché par défaut), et prenez la version correspondant à votre OS (Windows 64-bit dans l'exemple ci-dessous), en cliquant sur «Download»:

  • Cliquez ensuite sur le bouton «Enregistrer le fichier»:

  • Double-cliquez sur le fichier téléchargé:

  • Cliquer sur «Exécuter» afin de démarrer la procédure d'installation:

  • Une fenêtre de pré-installation s'affiche, attendez que celle-ci se ferme:

  • Vous arriverez ensuite au sein de la procédure d'installation et vous devez simplement suivre les instructions d'installation:

Une fois toutes les étapes d'installation réalisées, l'outil est installé sur votre machine.

Démarrer l'outil SoapUI

Pour démarrer l'outil SoapUI, il suffit simplement de double-cliquer sur l'icône suivante:

Vous arriverez sur la page d'accueil, vierge si aucun projet n'a été créé, suivante:

Installer le simulateur

Le simulateur ETS est un projet SoapUI, construit dans un fichier de type XML.

  • Cliquer sur «File»->«Import Project» (ou directement via la combinaison de touche CTRL+i)

  • Sélectionner la dernière version du simulateur livré par KEREVAL, puis cliquez sur «Ouvrir»

  • Le simulateur est dorénavant déployé sur votre machine:

Utilisation du simulateur

Comprendre l'architecture du simulateur

Le Simulateur ETS est décomposé en plusieurs éléments:

  1. Le nom du projet
  2. Nom des méthodes dans les web services (fichier WSDL)
  3. Suites de tests -> «Test Suite»
  4. Cas de test -> «Test Case»
  5. Suite d'étapes de test -> "Test steps"
  6. Pas de test -> "Step"

  • Une suite de tests (niveau 3) correspond à un regroupement de tests par web service
  • Chaque cas de test (niveau 4) représente un test, dont le nom est identique à celui présent dans le dossier de test et sur la plateforme Gazelle

/!\ ATTENTION

Vous ne devez à aucun moment modifier le nom des tests!

  • L'étape de test «replace» charge le message XML, jeu de données représentatif du cas de test, et l'enregistre dans la propriété «xml_flux»
  • L'étape de test «requestXXX» injecte le message XML construit dans la requête Soap et transmet le message vers le système d'information SI de l'AMC

Exécuter un test

  • Pour exécuter un test, double cliquer sur le nom du cas de test souhaité(niveau 4 dans l'architecture du simulateur vue précédemment). Une fenêtre s'ouvrira avec les étapes de test.

  • Pour lancer le test, cliquer sur la flèche verte, premier élément de la fenêtre ouverte: . Pour visualiser les étapes de test, cliquer sur l'onglet «TestsSteps». La liste des étapes de test s'affiche.
  • Votre résultat de test sera affiché par jeu de couleur(Rouge=KO / Vert=OK) en bas de cette fenêtre. Pour visualiser le résultat, cliquer sur le bouton «TestCase Log»

Afficher le détail d'une exécution

Après avoir exécuté un test, il peut être intéressant(notamment dans le cas d'un échec) de regarder le détail de l'exécution.

Pour ouvrir les logs de la requête «Aller», double-cliquer sur 'Step 2':

Vous pourrez accéder à trois éléments:

  • Requête Aller, envoyée par le Simulateur ETS
  • Message Retour, généré par votre Service En Ligne
  • Informations complémentaires, heure d'exécution du test & URL de réception

Valider le message Retour

L'objectif du simulateur est de fournir une requête afin que les Services En Ligne des AMC soient stimulés et génèrent des messages XML conformes au Cadre d'Interopérabilité technique des services AMC et des échanges HospiAMC.

Dans l'onglet «Response Message», vu dans le paragraphe précédent, copier le contenu du message et injecter le dans l'outil EVSClient pour validation.

Les paramètres du simulateur

SoapUI offre la possibilité de personnaliser les requêtes via des paramètres personnalisés(Custom Properties). Ces paramètres peuvent être définis à trois niveaux:

  • Au niveau du projet
  • Au niveau des suites de test(Test suite)
  • Au niveau des cas de test(Test case)

Paramètres au niveau du projet

Pour identifier les paramètres du niveau projet, il faut cliquer sur le nom du projet. Les paramètres(Custom Properties) apparaissent à côté des propriétés du projet(Project Properties).

/!\ ATTENTION

Il est important de renseigner tous les paramètres au niveau projet avant d'exécuter un step de cas de test

Paramètres au niveau cas de test

Pour identifier les paramètres du niveau cas de test, il faut cliquer sur le nom du cas de test. Les paramètres(Custom Properties) apparaissent à coté des propriétés du cas de test(TestCase Properties).

Contrairement aux niveaux projet et suite de test, la présence de paramètre au niveau des cas de test n'est pas systématique. Ils ne sont définis que pour les besoins spécifiques du cas de test.

/!\ ATTENTION

Il est important de renseigner toutes les paramètres au niveau du cas de test avant d'exécuter le premier step de cas de test

Customisation du simulateur

Edition des paramètres niveau projet

Comme vu dans le chapitre précédent, des paramètres au niveau projet ont été définies.

Ces paramètres sont de deux ordres:

  • Des paramètres de configuration des services web
  • Des paramètres de jeu de données

Les paramètres de configuration des web services sont:

  • xml_flux
  • xml_répertoire
  • endpoint

Les paramètres de jeu de données concernent le Bénéficiaire nominal, i.e. BENEF_01, utilisé dans la plupart des cas de test.

Paramètres de configuration des WS

Chargement du flux XML

Le paramètre «xml_flux» est placé dans la requête de telle manière que le flux concerné lors de l'exécution d'un test soit chargé dans la requête.

  • xml_flux: permet de charger un message XML. Ce paramètre ne doit pas être modifié!

/!\ ATTENTION

  • les flux XML doivent être sans entête XML de type: " <?xml version="1.0" encoding="UTF-8"?>".
  • les flux XML doivent être encodés en UTF-8 sans BOM

Définition du répertoire des messages XML

L'emplacement des messages XML, est propre à chaque environnement. Il est défini par le paramètre «xml_repertoire». Ce paramètre doit être renseigné.

  • Pour cela, indiquer dans le champ «Value» de la propriété xml_repertoire le chemin d'accès au répertoire de stockage de vos messages XML. Vous devrez probablement indiquer '\\' dans vos chemins d'accès.

  • /!\ Pour rappel, l'ensemble des flux de test est fourni dans un répertoire avec les simulateurs de requêtes. Le fichier contenant ces flux s'appelle "CasDeTestAMC_VX.zip"

Liste des ETS de test

Vous trouverez dans le tableau ci-dessous la liste des ETS de test qui sont configurés dans les fichiers XML:

Paramètres des jeux de données

Les paramètres de jeu de données définis au niveau projet concernent les identifiants AMC ainsi que le bénéficiaire nominal utilisé dans la majorité des cas de test. Si un bénéficiaire spécifique est requis alors il sera défini comme paramètre de cas de test.

Tous les paramètres décrits ci-dessous seront injectés dans les flux pour les tests. Cette injection est réalisée lors de l'étape de test nommée «replace».

De façon générique, ces paramètres représentent:

  • AMC_CSR: CSR de l'AMC
  • AMC_TYPE_CONV: Type de convention associée à l'AMC
  • AMC_NUM_AMC: Numéro d'AMC attaché
  • BENEF_01_NIR: NIR du bénéficiaire xx
  • BENEF_01_CLE_NIR: Clé NIR du bénéficiaire xx
  • BENEF_01_CODE_REGIME_AMO
  • BENEF_01_CODE_CAISSE_AMO
  • BENEF_01_CODE_CENTRE_AMO
  • BENEF_01_DATE_NAISSANCE: Date de naissance du bénéficiaire xx
  • BENEF_01_NUM_ADHERENT: Numéro d'adhérent du bénéficiaire xx

/!\ ATTENTION

Il est impératif de conserver le nom du paramètre concerné (colonne "Name") lors d'une modification de sa valeur. Ce nom est injecté dans TOUS les messages XML.

Définition des endpoint

Afin que le simulateur communique avec votre Service En Ligne, il faut paramétrer l'adresse URL pour tous les Services. Le lien est fait via le paramètre «endpoint».

Ce paramètre est injecté automatiquement dans les requêtes:

  • /!\ Ces paramètres doivent être de type «URL». Exemple: http:// xxxxx:8088/roc/del

Edition des paramètres au niveau cas de test

Comme vu dans le chapitre précédent, des paramètres au niveau cas de test peuvent être définis. Ces paramètres sont de type «jeu de données» et décrivent des bénéficiaires différents que celui indiqué au niveau projet. La description des paramètres est la même que celle du niveau projet.

/!\ ATTENTION

Vous devez être capable au moment de l'exécution des tests de faire des liens entre les descriptions de ces bénéficiaires et des bénéficiaires existants dans votre système d'information de qualification