Gestion des exécutions - TestNG
Il est possible d'utiliser un environnement d'exécution Java compilé en dehors du mode d'édition et d'exécution spécifique de l'éditeur Agilitest. Cet environnement d'exécution Java compilé est plus rapide et est destiné à être utilisé avec un seul test ou un groupe de tests au sein d'un projet. TestNG est un framework conçu pour permettre l'exécution de ces tests en Java.
Les exécutions TestNG, également appelées «Playlists »ou« Suites », sont des séries d'exécutions créées dans Agilitest à partir d'un ensemble de scripts et de paramètres.
Ces séries de tests peuvent être exécutées par Agilitest, mais elles peuvent également être exportées vers des environnements compatibles avec TestNG, capables de relancer les tests sans nécessiter de configurations complexes, comme Jenkins et ses tâches.
Ce mode de compilation est accessible depuis la fenêtre de gestion de l'exécution.
Comment gérer la mise en œuvre des projets
Vous pouvez accéder à la fonctionnalité de gestion des tâches depuis la barre latérale.
Cliquez sur «Gestion des exécutions» ou utilisez le raccourci clavier Alt+x
Agilitest ouvrira une fenêtre contenant différents menus :
- Développeur du projet
Le Project Builder vous permet de configurer, de générer et d'exécuter vos tests.
Sélectionnez le mode d'exécution de vos listes de lecture à l'aide des menus suivants : Agilitest Builder, Conteneurs, Intégration Jenkins et Intégration GitLab
- Niveau de détail du rapport
Précisez le niveau de détail des rapports, ainsi que la nécessité de générer un rapport de validation et un rapport animé.
Les niveaux hiérarchiques sont définis comme suit :
- Rapport d'exécution
- Rapport d'exécution détaillé
- Rapport d'exécution détaillé avec captures d'écran
- Exécutions
Ce menu vous permet de configurer les exécutions TestNG, appelées « Playlists » ou « Suites », ainsi que leurs variables et leurs scripts.
Cliquez sur le nom d'une Playlist la configurer.
Depuis cette fenêtre, vous pouvez :
- Modifiez le nom et ajoutez une description à votre Playlist
- Définissez le niveau de journalisation (silencieux, erreur, info, avertissement, tout)
- Choisissez de l'inclure dans l'exécution par défaut
- Générer un rapport HTML interactif
- Modifier le format de la date
- Sélectionnez le système d'exploitation cible et le rôle de l'utilisateur
- Définir les paramètres de sécurité
- Définir le contrôle d'accessibilité (WCAG)
Pour plus d'informations sur les paramètres de sécurité et l'accessibilité RGAA, veuillez consulter la documentation de Check
Listes de lecture en double
Cliquez avec le bouton droit de la souris sur une Playlist d'exécution, puis cliquez sur «Dupliquer »pour créer une copie exacte du fichier.
La nouvelle playlist une copie indépendante de l'originale (mêmes scripts, mêmes variables, même ordre) et peut être modifiée librement, sans aucun lien avec le code source.
Exemple :
Dupliquez une Playlist vous appuyer sur une campagne existante et lui donner une nouvelle orientation.
Clone d'ombre
Faites un clic droit sur Playlist d'une Playlist , puis cliquez sur « Clone fantôme ».
Cela vous permet de créer une Playlist « Shadow » Playlist reproduit en permanence la liste de test à partir de sa playlist de référence.
L'objectif est de faciliter considérablement la maintenir plans de test en évitant les doublons dans les configurations.
Si vous ajoutez ou supprimez un script de test dans le « Master » (la suite d'origine), tous les clones sont automatiquement mis à jour lors de l'exécution, sans que vous ayez à intervenir.
Cependant, le clone fantôme dispose de ses propres variables de séquence, ce qui vous permet de rejouer exactement la même campagne dans un contexte différent (environnement de test, ensemble de données alternatif, etc.) sans avoir à gérer deux listes en parallèle.
Exemples :
Effectuez exactement les mêmes tests sur différents navigateurs, dans différents environnements (tels que les environnements de préproduction ou de production) ou avec différents niveaux d'accessibilité.
- Voici quelques exemples supplémentaires :
Environnement de validation → Pré-production
Environnement de validation → Intégration
Préproduction → Préproduction de la représentation
Préproduction → Production (moins courant)
Avec des ensembles de données qui sont :
- plus grand
- adapté et anonymisé conformément au RGPD
- dans un langage qui doit être testé
🔶 Avertissement
Il n'est pas possible de dupliquer un clone d'ombre, car la chaîne est limitée à un seul niveau
- Scripts
Une fois que vous avez sélectionné votre playlist, ajoutez ou supprimez les scripts de votre choix. Depuis cette interface, vous pouvez également filtrer vos scripts à l'aide de groupes.
Comment créer une exécution
Une exécution désigne un sous-ensemble de tests au sein d'un projet, c'est-à-dire un ensemble de scripts que vous pouvez exécuter en une seule fois.
Pour définir une exécution, cliquez sur le bouton «Ajouter »dans l'onglet « Exécutions ».
Comme indiqué plus haut, une playlist comporter plusieurs scripts.
Pour ajouter des scripts, sélectionnez votre playlist, puis cliquez sur «Importer des scripts».
Vous pouvez également glisser-déposer des scripts à partir de l'explorateur de projets.
L'onglet « Packages » affiche tous les répertoires de votre projet.
Cela vous permet de définir, pour chaque répertoire, si les fichiers ATS contient doivent être inclus ou exclus de la sélection.
Cela vous permet de préciser, pour chaque répertoire, si les ATS qu'il contient doivent être inclus ou exclus de la sélection.
Précisez quels répertoires doivent être utilisés pour récupérer les scripts, et ceux qui ne doivent pas l'être.
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 qui déterminent le niveau de détail des rapports générés.
Chaque Playlist dispose de ses propres paramètres.
Pour configurer ces paramètres, cliquez sur le nom de votre Playlist d'exécution.
Une série d'options vous permet de configurer la qualité des rapports générés lors du lancement de l'exécution :
Plus d'informations ci-dessus ↑
Générer des rapports
Cliquez sur case « Générer un rapport » pour les générer à la fin de l'exécution.
Si vous cochez la case «Générer un rapport », votre rapport sera généré à la fin de l'exécution, et il pourra également s'ouvrir automatiquement si vous cochez l'option suivante.
Une fois cette case cochée, vous pouvez définir le niveau de détail souhaité pour le rapport.
Pour en savoir plus sur les rapports, vous pouvez consulter la documentation.
Sélectionner 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.
Gestion des groupes est accessible depuis la barre latérale et vous permet de créer, de gérer et de supprimer des groupes.
Chaque projet dispose de sa propre gestion de groupe, et chaque suite d'exécution dispose de sa propre configuration de filtrage.
Il existe deux façons de filtrer les groupes :
- En incluant : tous les scripts de ce groupe sont exécutés.
- En excluant : aucun script de ce groupe n'est exécuté
Variables d'exécution
Les variables d'exécution sont des variables que vous définissez dans le menu de gestion de l'exécution et qui apparaîtront comme variables d'environnement dans tous les tests appartenant au même projet.
Accédez à vos variables d'environnement dans le menu « Valeurs spéciales ».
Ou à l'aide de la commande : $env(nom_variable)
Les variables d'environnement vous permettent de gérer différents environnements d'exécution, qui utilisent tous la même suite de tests.
Les variables d'environnement peuvent être redéfinies lors de l'exécution, soit depuis la ligne de commande, soit via le système utilisé pour déclencher les exécutions (Jenkins, GitLab CI, Azure DevOps).
Lancer une exécution avec Agilitest
Lorsque vous souhaitez exécuter une Playlist qu'elle est sélectionnée, comme l'indique la coche dans la ligne correspondant à vos exécutions.
Vous pouvez sélectionner plusieurs listes de lecture pour les lire les unes après les autres.
Pour lancer la lecture de votre playlist, suivez les étapes ci-dessous dans l'ordre :
- Générer : cette fonction génère les fichiers Java correspondant aux ATS sélectionnés
- Compiler : cette fonction compile les fichiers Java
- Exécuter : Agilitest ouvre une console et relance tous les tests sélectionnés dans le cadre de l'exécution.
En cochant la case «Ouvrir les scripts ayant échoué », tous les scripts ayant échoué s'ouvriront une fois l'exécution terminée.
Remarque :
Il est également possible d'exécuter un script à l'aide d'arguments de ligne de commande sans tenir compte des playlist , ce qui correspond à une exécution autonome.
Dans l'explorateur de projet, cliquez avec le bouton droit sur un script > Exécuter le script > Ligne de commande
