Catégories

Gestion des exécutions - TestNG

Il est possible d'utiliser un mode d'exécution compilé en Java en dehors du mode d'exécution et d'édition spécifique de l'éditeur Agilitest. Ce mode d'exécution compilé Java est plus rapide et destiné à être utilisé pour un test ou un groupe de tests dans un projet.

Ce mode de construction se trouve sur la page de gestion des exécutions.

Gérer l'exécution des projets

L'accès à la gestion des exécutions se fait via l'explorateur de projets.

Cliquez sur le menu puis sélectionnez "Gestion des exécutions".

gestion des exécutions

Agilitest ouvrira un onglet avec différentes parties :

page de gestion des exécutions
  • Project Builder (1) : Permet de configurer, de générer, d'exécuter et éventuellement de produire et d'ouvrir les rapports correspondant aux exécutions.
  • Lignes de commande (2) : Vous pouvez utiliser la ligne de commande pour lancer l'exécution de ATS à partir d'une commande Windows. Cette commande doit être exécutée à la racine du projet ATS . Vous pouvez copier ces éléments dans un fichier .bat ou .ps1 pour lancer toutes les exécutions que vous avez configurées sans passer par Agilitest.
  • Exécutions (3): Ce menu permet de configurer les exécutions de TestNG, leurs variables et leurs scripts.

Qu'est-ce qu'une exécution TestNG ?

Toutes les exécutions ATS conçues par Agilitest sont exécutées sous Java. TestNG est un framework qui a été créé pour permettre l'exécution de ces tests en Java.

Les exécutions TestNG, aussi appelées"Suites", sont des exécutions créées dans Agilitest à partir d'un ensemble de scripts et de paramètres. Ces exécutions peuvent être exécutées par Agilitest, mais elles sont également exportables vers des environnements compatibles avec TestNG qui peuvent rejouer les tests sans nécessiter de configurations complexes, comme Jenkins et ses Jobs.

Comment créer une exécution

Une exécution correspond à la définition d'un sous-ensemble de tests de projet, c'est-à-dire de scripts, que vous pouvez rejouer en une seule exécution.

Pour définir une exécution, cliquez sur le bouton"Ajouter" dans l'onglet des exécutions.

bouton d'ajout

Comme mentionné ci-dessus, une Suite doit être composée de plusieurs scripts.

Pour ajouter des scripts, sélectionnez votre Suite puis cliquez sur "Importer des scripts"dans la boîte dédiée.

bouton d'importation de scripts

Vous pouvez également glisser-déposer des scripts à partir de l'explorateur de projets.

Sélectionner des forfaits

L'onglet"Packages" affiche tous les répertoires de votre projet et vous permet de définir, pour chaque répertoire, si les fichiers ATS qu'il contient doivent être inclus ou exclus de la sélection.

Indiquez quels répertoires doivent être utilisés pour récupérer les scripts, et ceux qui ne le sont pas.

ajouter une page de paquets

Il n'est pas nécessaire que les fichiers aient été ajoutés à l'onglet script.

Paramètres d'exécution

Une fois votre exécution créée, vous pouvez lui attribuer des paramètres d'exécution qui affectent le niveau de détail des rapports générés.

Pour configurer ces paramètres, cliquez sur le " crayon " bleu.Crayon"bleu sur la ligne de votre exécution.

bouton crayon

Un ensemble d'options permet de définir la qualité des rapports produits lors du lancement de l'exécution :

Niveau des journaux

niveau des journaux

Les différents niveaux d'enregistrement sont les suivants :

  • Silencieux
  • Erreur
  • Info
  • Avertissement
  • Tous

Ils sont classés par ordre décroissant de détail.

Générer des rapports

Cochez la case "Générer des rapports"pour les générer à la fin de l'exécution.

activer les rapports

  • Rapport visuel

Pour le rapport visuel, vous devrez spécifier la qualité de l'ATSV Rapports vidéo que vous allez générer.

Les différentes options sont les suivantes :

rapport visuel
  • Taille : Pour optimiser la taille du fichier ATSV
  • Vitesse : pour optimiser la vitesse d'exécution du test
  • Qualité : Pour optimiser la qualité des images
  • Qualité maximale : Pour optimiser la qualité des images au maximum

  • Rapport XML

Un rapport au format XML peut être généré et travaillé avec une solution BI (Jasper, Talend, etc...).

Variables d'exécution

Les variables d'exécution sont des variables que vous définissez dans le menu de gestion des exécutions et qui apparaîtront comme variables d'environnement dans tous les tests appartenant au même projet.

variables d'exécution

Vous trouverez les variables d'environnement dans le menu des valeurs spéciales.

variable environnementale

Or with the command: $env(<Valeur_Variable>)

variable d'environnement dans une action

Les variables d'environnement vous permettent de gérer différents environnements d'exécution, qui utilisent tous la même base de test.

Les variables d'environnement peuvent être surchargées pendant l'exécution, soit sur la ligne de commande, soit avec le système utilisé pour lancer les exécutions (Jenkins, GITLAB CI, AzurDevops).

Sélection des groupes

Les groupes de test vous permettent de filtrer les scripts que vous exécutez en fonction des groupes auxquels ils sont associés.

Les gestion des groupes accessible depuis l'explorateur de projet, permet de créer, gérer et supprimer des groupes.

bouton de gestion des groupes

Chaque projet a sa propre gestion de groupe et chaque suite d'exécution a sa propre configuration de filtre.

Il existe deux façons de filtrer les groupes :

  • En incluant: Tous les scripts appartenant à ce groupe sont exécutés.
  • Par Exclusion: Tous les scripts sont exécutés à l'exception de ceux qui appartiennent à un groupe sélectionné.

Lancer une exécution avec Agilitest

Une fois votre exécution créée, assurez-vous qu'elle est sélectionnée, comme l'indique la coche sur votre ligne Suite.

suite sélectionnée

Vous pouvez également sélectionner plusieurs suites à exécuter l'une après l'autre.

Plusieurs suites peuvent également être exécutées à l'aide de Job Jenkins.

Pour lancer l'exécution de votre Suite, vous devez suivre les étapes ci-dessous, dans l'ordre :

lancement d'une exécution
  1. Générer : Cette fonction génère les fichiers Java correspondant aux tests ATS sélectionnés.
  2. Compile: Cette fonction permet de compiler les fichiers Java correspondant aux tests ATS sélectionnés.
  3. Exécuter: Agilitest ouvrira une console et rejouera tous les tests sélectionnés dans l'exécution.

Il y a deux options facultatives à ajouter avant de lancer l'exécution de Suite (étape 3) :

paramètre d'exécution
  • Ouvrir les scripts qui ont échoué: À la fin de l'exécution, cette option permet d'ouvrir tous les scripts qui n'ont pas abouti.
  • Générer des rapports: A la fin de votre exécution, votre rapport Suite sera généré, et pourra également être ouvert si vous cochez l'option suivante. Vous pouvez choisir *Niveau de détail du rapport une fois que cette option a été cochée.

💡 Conseil

Cette console ne doit être utilisée que pour la vérification "rapide" des scripts dans Agilitest. Pour des lancements de scripts plus longs, il est préférable d'utiliser un terminal Windows ou le raccourci "CMD" que vous pouvez créer dans l'onglet de gestion des exécutions.

bouton de raccourci

Vous avez encore besoin d'aide ?
Contacter le support