Mode Client du simulateur

Simulateur - Mode Client

Mode Client

 

Ce mode simule un client XAT2V2 (comme un catalogue ETAI) qui envoie des requêtes XAT2V2 à un serveur, telles les demandes de prix et stock de pièces ou l’envoi d’un panier.
Ce mode permet aussi de récupérer les réponses en provenance du serveur et de les analyser.

 

Les fonctionnalités de ce mode se décomposent en 3 parties :

  1. La configuration du client
  2. Le test d’une requête XAT2V2
  3. L’exécution d’un scénario (ensemble de requêtes XAT2V2)

1. Configuration

Lorsque le simulateur est démarré en mode client, l’écran principal suivant est affiché :

Mode-client-1

Cet écran permet de configurer les identifiants nécessaires pour accéder au serveur XAT2V2 :

  • Localisation du serveur : URL complète d’accès au serveur (les ports 7001 à 7010 sont recommandés)
  • Identifiant du garage : Identifiant du garage (garage-Shared-ID)
  • Identifiant de l’utilisateur : Identifiant de l’utilisateur au sein du garage (user-Shared-ID)
  • Identifiant du DMS : Identifiant du DMS (DMS-Login)
  • Identifiant de l’application : Identifiant de l’application cliente (Application-ID)
  • Connection timeout : durée maximale autorisée pour se connecter au serveur (en millisecondes). Une valeur de 0 utilise la valeur par défaut de la JVM.
  • Délai de lecture réponse : durée maximale autorisée pour récupérer une réponse (en millisecondes). Une valeur de 0 utilise la valeur par défaut de la JVM.
  • Compression GZIP: indique si la requête sera compressée en gzip (le serveur doit supporter cette compression pour obtenir une réponse).
    Si cette case est cochée, la compression GZIP est utilisée :

    • Lors d’un simple test (requête/réponse)
    • Lors de la création et de la suppression des sessions en mode scénario.

Haut de la page

Ping du serveur

Le bouton Ping permet d’effectuer un test de communication avec le serveur XAT2V2. Il s’agit, en pratique, de l’émission d’une requête HTTP/OPTIONS à l’URL du serveur. Dans le cas d’une implémentation ETAI d’un serveur, une telle requête renvoie un flux WADL qui est présenté dans une fenêtre pop-up :

Mode-client-2

Dans tous les cas, le « response code » HTTP est indiqué dans la console. Celui-ci ne doit pas être 404 ni 500.


Haut de la page

2. Test d’une requête XAT2V2

Le panneau Test permet d’effectuer un test d’invocation d’un serveur XAT2V2. La requête devant être émise doit être placée dans le composant du côté gauche.

Attention : les données de connexion utilisées (notamment les identifiants) sont celles qui ont été définies dans le panneau Configuration.

Mode-client-3

Toutes les données de l’élément <session-context> se trouvant dans le message de requête seront remplacées par celles indiquées dans la configuration de connexion, à l’exception de l’identifiant unique de la session <session-id> qui peut être précisé et sera conservé tel quel lors de l’envoi.

La requête peut être écrite directement dans le champ, ou copiée-collée depuis l’éditeur XAT2 ou affichée en glissant un fichier XML directement dans la zone de saisie.

Le bouton Envoyer la requête permet d’envoyer la requête au serveur XAT2V2. Si celui-ci répond un message XAT2 correct, il est affiché dans le composant du côté droit. Le composant du côté gauche est également mis à jour pour présenter la requête complète, telle qu’elle a été émise :

Mode-client-4


Haut de la page

3. Exécution d’un scénario

Le panneau Scénario permet de créer un ensemble de requêtes XAT2V2 et de les regrouper dans un scénario. Lors de l’exécution du scénario, les requêtes seront envoyées les unes après les autres vers le serveur configuré.

Ajouter une requête dans un scénario

Le bouton « Ajouter une requête » permet d’ajouter une requête au scénario. Celle-ci sera placée à la fin du scénario.

Mode-client-5

Panneau de configuration de la nouvelle requête XAT2V2 :

Lors de l’ajout d’une requête au scénario, il faut préciser :

 Mode-client-6

Nom : le nom logique de la requête. Cette valeur n’est pas obligatoire mais elle facilite la localisation d’une requête dans le scénario.

 

Type de Session : mode d’utilisation d’une session XAT2 :

  • GLOBAL : utilisation d’une session globale, ouverte dès le début du scénario et fermée à la fin du scénario.
  • LOCAL : utilisation d’une session locale, ouverte juste avant l’émission de la requête et fermée juste après.
  • NO_SESSION : pas d’utilisation de session.

Compression GZIP : compression GZIP. Indépendamment de la configuration générale du panneau Settings, si cette case est cochée, la requête utilisera la compression gzip pour le contenu de la réponse et la lecture de la réponse.

Content : contenu de la requête. Les règles de gestion du session-context dans le panneau Test sont applicables également ici. Cette zone supporte également le glisser-déposer de fichier.

Réponse attendue: modèle de réponse attendu. Si cette valeur est renseignée, il doit s’agir d’un document XAT2V2 valide. Lors de l’exécution du scénario, le shuttle de la réponse reçue et le shuttle de cette valeur seront comparés pour vérifier s’ils sont similaires.

Mode-client-7

Le bouton OK valide l’ajout de la requête au scénario. Le bouton « Annuler » annule la création de la requête.

ATTENTION, on ne peut pas mixer des requêtes en GLOBAL_SESSION avec des requêtes en LOCAL. En effet, l’ouverture de la session locale invaliderait automatiquement la session globale.

La requête se trouve maintenant dans le scénario :

Mode-client-8

L’ordre d’exécution des requêtes peut être modifié en effectuant un drag and drop de la ligne correspondante dans le tableau.

 

Supprimer une requête d’un scénario

Sur l’écran « scénario », cliquer sur la requête à supprimer.

Ouvrir le menu contextuel avec un clic droit sur la souris :

Mode-client-9

Choisir l’item « Supprimer »

 

Modifier une requête dans un scénario

Sur l’écran « scénario », cliquer sur la requête à modifier.

Ouvrir le menu contextuel avec un clic droit sur la souris :

Mode-client-10

 

Exécution du scénario

Quand le scénario est complet et que la configuration de connexion est correctement configurée, on peut lancer le scénario en appuyant sur le bouton « Démarrer scénario ». Un panneau de suivi de l’exécution du scénario apparaît.

Mode-client-11

Ce panneau est composé :

  • En haut, d’une barre de boutons
  • A gauche, d’un message se mettant à jour au fur et à mesure de l’exécution du scénario
  • Au centre : le tableau de sélection des requêtes. Celui-ci se rempli au fur et à mesure que les requêtes s’exécutent. Pour chaque requête, sont indiqués :
  • son numéro d’ordre,
  • son nom logique
  • sa durée d’exécution (en ms)
  • le response code HTTP (qui doit être 200)
  • le status XAT2 :
  • OK : la réponse obtenue est un message XAT2 valide ne contenant pas de message d’erreur. Si un modèle de réponse avait été associé à la requête, la réponse obtenue est conforme à ce modèle.
  • Contenu non conforme: la réponse obtenue est un message XAT2 valide ne contenant pas de message d’erreur. Cependant, le message obtenu n’est pas conforme au modèle qui avait été associé à la requête.
  • Erreur XAT2 : la réponse obtenue est un message XAT2 valide contenant un message d’erreur.
  • Non XAT2 : la réponse obtenue n’est pas un message XAT2 valide.
  • En bas du panneau central : deux zones dont le contenu s’affiche en fonction de la ligne sélectionnée dans le tableau des requêtes. A gauche, se trouve la requête émise, à droite, la réponse reçue.
  • En bas : Une barre de progression indique le niveau de progression du scénario.
  • En haut : Une fois le scénario terminé, il est possible d’enregistrer le résultat du scénario. Celui-ci se présente sous la forme d’un fichier zip dans lequel on retrouve une description du scénario, toutes les requêtes émises, les réponses correspondantes et diverses informations sur l’échange effectué.

 

Sauvegarde du résultat d’exécution du scénario

Une fois le scénario terminé, il est possible d’enregistrer le résultat du scénario.  Pour cela cliquer sur le bouton « Sauvegarder Scénario », une fenêtre pop-up de sélection s’affiche :

Mode-client-12

 

Le fichier enregistré se présente sous la forme d’un fichier zip dans lequel on retrouve une description du scénario, toutes les requêtes émises, les réponses correspondantes et diverses informations sur l’échange effectué.

Haut de la page

 Retour à la rubrique Simulateur