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

  • 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»:

  • Enregistrez le fichier et attendez la fin du téléchargement :

  • Ouvrez le fichier téléchargé:

  • 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

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 paramètres de tous les différents bénéficiaires utilisés dans les cas de test. On y retrouve également d'autres paramètres comme la date d'admission qui sera utilisée dans différents cas de tests.

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:

  • BENEF_XX_AMC_CSR: CSR de l'AMC du bénéficiaire xx
  • BENEF_XX_AMC_TYPE_CONV: Type de convention associée à l'AMC du bénéficiaire xx
  • BENEF_XX_AMC_NUM_AMC: Numéro d'AMC attaché du bénéficiaire xx
  • BENEF_XX_NIR: NIR du bénéficiaire xx
  • BENEF_XX_CLE_NIR: Clé NIR du bénéficiaire xx
  • BENEF_XX_DATE_NAISSANCE: Date de naissance du bénéficiaire xx
  • BENEF_XX_NUM_ADHERENT: Numéro d'adhérent du bénéficiaire xx
  • BENEF_XX_RANG_NAISSANCE : Le rang de naissance du bénéficiaire xx
  • BENEF_XX_NOM : nom du bénéficiaire xx
  • BENEF_XX_PRENOM : prénom du bénéficiaire xx
  • BENEF_XX_DATE_DEB_DROITS : date début des droits du bénéficiaire xx
  • BENEF_XX_CLE_NIR : clef NIR du bénéficiaire xx
  • BENEF_XX_DATE_RAD : date de radiation du bénéficiaire xx
  • ODR_XX_NIR : code NIR de l'ouvrant droit pour le bénéficiaire xx
  • ODR_XX_CLE_NIR : clef NIR de l'ouvrant droit pour le bénéficiaire xx
  • ODR_XX_CODE_REGIME_AMO
  • ODR_XX_CODE_CAISSE_AMO
  • ODR_XX_CODE_CENTRE_AMO

Les «XX» correspondent au numéro de bénéficiaire (chaque paramètre sera présent pour chaque bénéficiaire).

Les paramètres «ODR» correspondent aux données de l'ouvrant droit (qui peut être différents du bénéficiaire dans certains cas comme dans un test ou le bénéficiaire est un enfant).

Tous ces paramètres peuvent être remplis directement dans un fichier texte puis importés sur SoapUI via le bouton suivant :

/!\ 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.

La description des différents bénéficiaires sont les suivantes:

Bénéficiaire classique assuré depuis plus de 365 jours BENEF_01
Bénéficiaire dont le contrat est résilié BENEF_02
Bénéficiaire avec un enfant présent sur le contrat de l'ouvrant droit (de la mère) BENEF_03
Bénéficiaire avec un enfant présent sur le contrat de l'ouvrant droit (du père) BENEF_04
Bénéficiaire avec des droits ouverts et bénéficiant d'un contrat responsable BENEF_05
Bénéficiaire avec des droits ouverts et bénéficiant d'un contrat non responsable BENEF_06
Bénéficiaire avec des droits ouverts sur une durée prévisionnelle de 15 jours BENEF_07
Bénéficiaire avec des droits ouverts sur la totalité de la période du séjour (15 jours) BENEF_08
Bénéficiaire avec un contrat suspendu depuis J-7 BENEF_09
Bénéficiaire avec des droits ouverts sur une partie de la période et bénéficie d'un contrat responsable BENEF_11
Bénéficiaire avec un contrat valide. Le contrat est en cours et la date de fin de couverture est postérieure à la date de renouvellement d'échéance. La date de renouvellement d'échéance est fixée par l'AMC à J+3 (donnée non modifiable en test) BENEF_12
Bénéficiaire avec des droits ouverts et bénéficie d'un contrat responsable et affilié au régime Alsace Moselle BENEF_13
Le bénéficiaire est un enfant. L'ouvrant-droit bénéficie d'un contrat responsable, il comprend une garantie forfaits accompagnant. BENEF_14
Bénéficiaire avec des droits ouverts et bénéficie d'un contrat responsable. Il comprend une garantie chambre particulière avec un plafond de 6 nuits. BENEF_15

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. La description des paramètres est la même que celle du niveau projet.