‍

La conception des tests et la maintenance des scripts de test sont deux aspects essentiels du processus de test des logiciels. L'éditeur Agilitest vous permet de construire vos tests et de les modifier directement dans l'interface pendant l'exécution en mode "pas à pas".

Une série de fonctions sont disponibles au niveau de l'action pour configurer et modifier l'exécution de vos tests.

‍

"Mode d'exécution "pas à pas

Le mode pas à pas est un mode spécial dédié à l'édition et à la modification des tests.

Agilitest vous permet de rejouer les actions indépendamment les unes des autres, de sorte que vous pouvez les exécuter étape par étape.

Pour ce faire, cliquez sur le bouton de lecture qui apparaît sur la ligne de chaque action survolée.

‍

Agilitest effectuera alors immédiatement cette action sur le logiciel testé et vous enverra le résultat.

Ce mode de fonctionnement vous permet d'exécuter votre test pas à pas, en sélectionnant les actions les unes après les autres et en vérifiant que chaque action a été exécutée.

‍

Options d'exécution

Marquer un point d'arrêt pendant l'exécution

Il est possible d'ajouter un point d'arrêt à une action pendant l'exécution du test, à des fins de débogage.

Pour ce faire, cliquez sur la coche située sous l'index de l'action pour afficher la fenêtre "Arrêterpour afficher l'icône " Stop ".

Lorsque vous exécutez votre test, il s'arrête au point d'arrêt que vous avez spécifié.

Gérer le nombre d'essais pour une action

Il est possible d'augmenter ou de diminuer le nombre maximum de tentatives. Cela indique à Agilitest qu'il doit essayer plusieurs fois d'attendre le retour de l'application avant de générer un échec.

Cela contribue grandement à la robustesse des tests lorsque vous savez que votre serveur peut se trouver dans une situation où il ne délivre pas immédiatement la page souhaitée.

Le nombre maximum de tentatives est limité à 50, mais le temps d'attente entre chaque tentative suit une courbe exponentielle : cela permet de vérifier rapidement les conditions de réussite lorsqu'elles sont réunies, mais aussi d'attendre "un certain temps" qu'un traitement long soit effectué.

‍

Ces tests peuvent également être séparés par un intervalle de temps. Plus la valeur est élevée, plus Agilitest attendra longtemps entre les tests.

Gérer les temps d'attente avec Java

Une autre solution consiste à utiliser un morceau de code Java:

Dans l'explorateur Agilitest, sélectionnez la vue à "Scripts Java ATS "

Cliquez sur le bouton pour "Créer un script Java ATS ".

Vous pouvez également créer un script Java en cliquant sur "Nouveau composant".Nouveau composant"en haut à gauche de l'éditeur.

Saisissez le nom du script que vous souhaitez utiliser comme fonction d'attente.

‍

L'éditeur ouvre une fenêtre d'édition de code Java. Collez le code suivant dans la fonction testMain () :

try {    final int ms = Integer.parseInt(prm(0, "1000"));    Thread.sleep(ms);} catch (Exception e) {}

‍

Enfin, glissez-déposez le script Java de l'explorateur Agilitest vers le script à l'endroit où vous souhaitez l'appeler dans votre test.

‍

💡 Conseil

Si vous souhaitez pouvoir spécifier le temps d'attente directement à partir de votre script ATS dans Agilitest, vous pouvez déclarer un paramètre transmis par valeur au script et utiliser ensuite le code suivant :

try {        final int ms = getParameter(0).toInt();        Thread.sleep(ms);} catch (Exception e) {}

Pour indiquer qu'une action peut échouer

Action sans statut fonctionnel

Les actions sans statut fonctionnel sont des actions telles que "Commentaire", "URL navigateur", "Démarrer le canal", etc...

Ces actions ne peuvent pas échouer sur le plan fonctionnel. Elles ne peuvent échouer qu'en cas d'erreur de conception du test.

Exemples d'erreurs de conception : un sous-script ou un fichier manquant, une erreur technique...

‍

Actions avec un statut fonctionnel

• Action bloquante

Par défaut, les actions du script bloquent le test pendant l'exécution.

Si l'action échoue, le test s'arrête et sera considéré comme échoué.

‍

• Actions non bloquantes
  • Action optionnelle

En spécifiant que l'action est optionnelle, si l'action échoue, le test ne s'arrêtera pas et le statut du test ne sera pas changé.

‍

• ‍
  • Action non bloquante avec statut d'échec

En spécifiant qu'une action est non bloquante, si l'action échoue, le test continuera à être exécuté, mais son statut sera définitivement échoué.

Pour indiquer ce comportement dans Agilitest, appuyez sur la touche CTRL de votre clavier et cliquez ensuite sur les flèches vertes.

‍

Exécution en mode réduit

Si vous le souhaitez, vous pouvez exécuter votre test en mode réduit, ce qui fermera temporairement la fenêtre Agilitest pendant la durée du test.

Cliquez sur les paramètres dans l'onglet de gestion canal sous l'explorateur de projet,

Cochez ensuite la case "Exécuter en mode réduit".

‍

L'éditeur Agilitest sera réduit pour vous donner une meilleure vue de ce qui se passe dans votre application, ce qui peut être utile si vous n'avez qu'un seul écran.

Exécuter en mode Java

ATS a été conçu pour générer du code Java afin d'exécuter des tests compilés, ce qui est particulièrement bien adapté au lancement de tests d'intégration continue ou à l'exécution de campagnes de tests complètes dans Agilitest.

L'exécution en mode Java est rapide et efficace. Contrairement à l'exécution en mode pas à pas, qui vous permet de construire et de modifier votre script, l'exécution en mode Java vous permet de l'exécuter de bout en bout dans un environnement de production.

‍

Il existe trois façons d'exécuter des tests en mode Java :

1. Directement à partir du script

Au lieu d'exécuter votre script pas à pas à partir de l'éditeur Agilitest, vous pouvez choisir d'exécuter le test en mode Java.

Pour ce faire, cliquez avec le bouton droit de la souris sur le script, cliquez avec le bouton droit de la souris sur le script dans votre explorateur de projet et sélectionnez "Exécution Java"

Cela compilera votre script et ouvrira une fenêtre d'exécution Java.

‍

             2. Créer une suite d'exécution

Il est possible de créer des suites d'exécution. Ces suites regroupent un ensemble de scripts qui seront compilés et exécutés avec Java.

Pour ce faire, ouvrez le menu de votre projet puis cliquez sur "Gestion de l'exécution"pour ouvrir la fenêtre Constructeur de projet.

À partir de cette page, vous pouvez créer des suites dans la zone"Exécutions".

‍

Une fois votre suite créée, cliquez sur"Generate" → "Compile" → "Execute" pour exécuter votre script en mode Java.

La fenêtre du terminal Java s'ouvre alors

‍

               3. Exécution Java en dehors d'Agilitest

Vous pouvez entrer la ligne de commande dans votre terminal pour exécuter le code sans utiliser Agilitest.

Pour récupérer la ligne de commande, copiez la ligne de commande à partir du constructeur du projet,

Copiez ensuite la ligne de commande dans le terminal de votre ordinateur pour l'exécuter sans utiliser Agilitest.

‍

Élément non trouvé

Dans l'automatisation des tests, il peut arriver qu'un élément ne soit plus reconnu lors de l'exécution en raison de modifications apportées au logiciel.

Pour y remédier, Agilitest vous permet d'ajuster les tests directement dans l'éditeur.

‍

Localisation et analyse

Vous pouvez utiliser la vidéo de l'échec de l'exécution du test et/ou un rapport avec des captures d'écran pour comprendre et localiser l'échec de la reconnaissance. Deux possibilités s'offrent à vous :

• L'élément initialement recherché n'existe plus dans le logiciel testé.
• L'élément initialement recherché existe mais n'est plus reconnu.

‍

Corriger le test

1. Si l'élément requis n'existe plus

Le test peut être modifié en supprimant cette action dans l'éditeur.

Pour ce faire, cliquez avec le bouton droit de la souris et sélectionnez "Supprimer".

Vérifier les actions précédentes et suivantes qui peuvent être liées à l'exécution du test, si nécessaire.

‍

            2. Si l'élément que vous recherchez existe, mais n'est plus reconnu

Le test doit donc être modifié, notamment en mettant à jour les critères de reconnaissance de cet élément dans l'éditeur Agilitest.

Pour ce faire, Agilitest indique précisément quel attribut n'est pas trouvé pour localiser cet élément.

Ouvrez l'outil de capture à partir de l'éditeur,

Capturez l'élément en appuyant sur la touche CTRL tout en plaçant votre souris sur l'élément,

Ajuster les attributs de détection.

Il est possible d'utiliser une "expression régulière sur chaque attribut pour plus de robustesse.

‍

N'oubliez pas de valider l'unicité de la détection à l'aide du test statistique intégré.

Glissez-déposez ces nouveaux attributs sur l'action concernée par cette "non-détection" pour la mettre à jour.

Sauvegardez vos modifications.

‍

Attentes customisées

Le problème de la vérification des actions

Les "Custom waits" ou attentes customisées sont une fonction utilisée dans un contexte particulier pour attendre que certaines choses soient faites avant l'exécution d'une action.

Il y a des choses qu'ATS ou Agilitest ne peuvent pas gérer en termes de contrôle de la continuité de l'exécution des tests.

‍

Lorsqu'une action est exécutée, il y a beaucoup de traitement avant que l'action ne soit transmise (vérification si l'élément est cliquable ou non, vérification si l'élément est en mouvement, etc.) Certains de ces cas ne peuvent être prévus, car ils dépendent de l'application et de son développement spécifique.

Une solution serait d'ajouter une action ATS de contrôle ou d'attente avant chaque action, ce qui alourdirait vos scripts.

‍

L'autre solution consiste à ajouter un fichier"custom waits" en tant que bibliothèque Java à un projet ATS .

Ce mécanisme permet d'effectuer des traitements de fond de manière systématique pour chaque exécution du projet.

Un modèle de cette librairie que vous pouvez modifier est fourni par Agilitest, ainsi que son code source.

‍

Configurer votre librairie

Téléchargez le code source à l'aide de ce lien :

https://agilitest.app/resources/tools/AtsWaitGui.zip

‍

Pour paramétrer votre librairie, ouvrez le fichier et importez un projet.

Cliquez sur "Projets Maven existants"et sélectionnez le projet Agilitest Custom Waits

‍

Dans cette librairie, vous pouvez ajouter une classe dans laquelle vous pouvez surcharger certaines méthodes de traitement avant vos actions.

Il s'agit d'une classe qui hérite d'une classe ATS existante et qui sera surchargée à certains moments précis de l'exécution des tests ATS .

‍

Exemple :

1. Une action est effectuée avant la recherche d'un élément
2. Une action est effectuée avant un clic de souris sur un élément trouvé
3. Une action est effectuée avant de changer de fenêtre/d'onglet
4. Une action est effectuée avant une action de saisie de texte
5. Une action est effectuée avant une action "go to URL".

‍

Pour compiler et empaqueter votre fichier, ouvrez une console et entrez "mvn clean package"

Une fois que c'est fait, vous pouvez récupérer la librairie .jar dans le répertoire "target" de votre projet.

Cette librairie .jar doit être mis dans votre répertoire de librairie Java du projet Agilitest

‍

Une fois la librairie placée dans votre répertoire de librairie Java, les surcharges ajoutées seront systématiquement exécutées avant chaque action lors de l'exécution de vos scripts.

‍