Gestion et explorateur de projets
Menu du projet
Ouvrez la barre latérale pour afficher les différents menus relatifs à votre projet :
Dans ce menu, vous trouverez
- Gestion des exécutions : Pour gérer vos exécutions et votre Job Jenkins
- Projet > Gestion des groupes : pour ouvrir la fenêtre « Groupes » qui vous permet de créer et de gérer vos groupes
- Projet > Propriétés du projet : pour accéder aux propriétés de votre projet
- Ouvrir dans l'explorateur système: Pour afficher votre projet dans l'explorateur Windows
- Projet > Changer de projet: pour passer à un autre projet ouvert
- Fermer le projet : Pour fermer le projet en cours dans Agilitest
- Arborescence des appels du projet: pour afficher tous les scripts que vous avez appelés
Ouvrir un nouveau projet
En haut à gauche de l'éditeur Agilitest, cliquez sur Projet > Nouveau projet
Agilitest créera un nouveau projet avec une arborescence sous le référentiel sélectionné.
Créer un nouveau composant
Pour créer un composant qui fera partie de votre projet, cliquez sur Projet > Nouveau composant
Lorsque vous créez un nouveau composant, Agilitest vous permet de sélectionner les types suivants :
Créer un script ATS : Pour créer un nouveau script ou sous-script.
Créer un script JavaScript: cette fonctionnalité vous permet d'appeler du code JavaScript externe dans Agilitest.
Créer ATS en JavaScript: ce fichier de script utilise le langage JavaScript
Créer ATS en Python: ce fichier de script utilise le langage Python
Créer des fichiers de données: pour créer un fichier de données permettant de tester plusieurs données. (Tests pilotés par les données)
Fichiers de propriétés : pour utiliser des données au format « clé = valeur »
Créer une exécution: Pour créer une exécution de tests afin de gérer la revue de tous les tests d'un projet, filtrés selon plusieurs critères.
Ouvrir un projet existant
Si vous avez déjà des projets existants mais qu'ils n'apparaissent pas dans l'explorateur de projets, vous devez les ouvrir via Agilitest.
Cliquez sur Projet > Ouvrir un projet
Ensuite, sélectionnez le dépôt de projet à la racine et validez en cliquant sur "Sélectionner un fichier"
Le projet s'ouvrira alors dans l'explorateur de projet gilitest.
Présentation de l'explorateur de projet
L'explorateur de projet est un élément principal pour vous aider à naviguer dans Agilitest.
Il a été optimisé pour obtenir la meilleure visibilité de vos projets, pour faciliter la création, l'exécution et la maintenance vos tests et pour augmenter la productivité.
Il permet d'avoir une vision globale d'un projet et d'apporter des modifications globales ainsi que de limiter la méthode étape par étape.
L'explorateur de projet est composé de
- Sélection de la suite (1): une liste déroulante permettant de définir rapidement la suite actuellement utilisée pour votre projet.
- Ensemble d'actions (2): ces boutons permettent d'ouvrir une ligne de commande, d'exécuter la suite sélectionnée, d'afficher uniquement les favoris, de basculer la sélection entre les fichiers et de filtrer les fichiers.
- Afficher la sélection (3): une liste déroulante permettant de choisir le type de script ou d'éléments que vous souhaitez voir s'afficher.
Playlist un projet
Une Playlist sélectionnée Playlist la liste de lecture (ou suite) actuellement choisie pour un projet. Chaque exécution comporte des paramètres, tels que des options de configuration, que vous pouvez trouver dans le menu de gestion des exécutions.
Pour sélectionner une suite, cliquez sur le menu déroulant des suites.
Le but de la sélection d'une suite pour un projet est de modifier les paramètres du projet à l'échelle globale et donc de faire varier les valeurs dépendantes de ces paramètres qui sont utilisées dans les scripts du projet.
Exemple :
Si vous choisissez l'exécution "A" avec le navigateur Chrome et l'exécution "B" avec le navigateur Firefox, lorsque vous utilisez le paramètre Navigateur dans un script, la valeur sera automatiquement Firefox pour l'exécution "B" et Chrome pour l'exécution "A".
Vue « Explorateur de projet »
Pour vous aider à vous organiser et à mieux cerner votre projet, tous les éléments de celui-ci sont classés dans des dossiers correspondants.
ATS
Le cœur de votre projet, avec des séquences d'actions automatisées (navigation, clics, saisies, vérifications) écrites en ActionTestScript (.ats)
Depuis la barre de titre, vous pouvez :
- Ajouter un nouveau script
- Ajouter un dossier
- Rechercher un script
- Ouvrir dans l'Explorateur de fichiers
ATS Java
ATS des scripts écrits directement en Java (.java) pouvant être utilisés pour des logiques avancées (boucles, conditions, API…). Ils s’exécutent comme des scripts « ATS » et peuvent être appelés en tant que sous-scripts.
Depuis la barre de titre, vous pouvez :
- Ajouter un nouveau script
- Ajouter un dossier
- Ouvrir dans l'Explorateur de fichiers
Scripts JavaScript « ATS »
Les scripts JavaScript (.js) exécutés par le moteur GraalVM. Pratiques pour calculer des valeurs, transformer des données ou réutiliser du code JS existant. Appelés depuis un script via js://
Depuis la barre de titre, vous pouvez :
- Ajouter un nouveau script
- Ajouter un dossier
- Ouvrir dans l'Explorateur de fichiers
ATS en Python
Les scripts Python (.ps) s'exécutent via GraalPy. Idéal pour le traitement de données ou la réutilisation de bibliothèques Python. Appelés via py://
Depuis la barre de titre, vous pouvez :
- Ajouter un nouveau script
- Ajouter un dossier
- Ouvrir dans l'Explorateur de fichiers
Web services
Depuis la barre de titre, vous pouvez :
- Ajouter un nouveau Web service
- Ajouter un dossier
- Ouvrir dans l'explorateur du système
Fichiers de données
Fichiers de données (CSV, JSON, propriétés) utilisés comme source pour des tests basés sur les données, avec une exécution par ligne.
Depuis la barre de titre, vous pouvez :
- Ajouter un fichier CSV
- Ajouter un fichier JSON
- Ajouter un fichier de propriétés
- Ajouter un dossier
- Ouvrir dans l'Explorateur de fichiers
Fichier « Ressources »
Les ressources du projet (images, fichiers PDF, fichiers à télécharger, modèles) sont accessibles pendant l’exécution via l’URL assets:///.
Depuis la barre de titre, vous pouvez :
- Actualiser le menu
- Ouvrir dans l'Explorateur de fichiers
Bibliothèques
Bibliothèques Java externes (.jar) et paquets Python utilisés par votre script.
Depuis la barre de titre, vous pouvez :
- Ajouter une bibliothèque
- Importer un module Python
- Ouvrir dans l'Explorateur de fichiers
Résultats d'exécution
Rapports et éléments générés lors des exécutions (dossiers « target » et « test-output ») : rapports au format HTM/XML, captures d'écran, fichiers journaux.
Depuis la barre de titre, vous pouvez :
- Vider le dossier et déplacer les résultats dans la corbeille
- Actualiser le menu
- Ouvrir dans l'Explorateur de fichiers
🔸Avertissement
Si une exécution est lancée en dehors d'Agilitest (via une ligne de commande, par exemple), il se peut qu'Agilitest ne détecte pas les résultats. Cliquez sur le bouton « Actualiser » pour mettre à jour le dossier.
Gestion des scripts
Une structure arborescente est indiquée lorsqu'un répertoire est créé dans un répertoire existant.
Pour ce faire, faites un clic droit sur un dossier existant pour en créer un autre qui fera partie de ce dossier.
Vous pouvez également renommer vos dossiers en cliquant avec le bouton droit de la souris sur le dossier > «Renommer»
Vous pouvez supprimer votre script ATS en faisant un clic droit directement sur le script situé dans l'explorateur de projet.
Lorsque vous supprimez un script, une fenêtre apparaît pour confirmer que vous souhaitez supprimer le script sélectionné. Cette fenêtre indique que le script ATS supprimé sera envoyé dans la poubelle de votre système Windows.
Si la suppression du script est une erreur, vous pouvez simplement restaurer le script en le récupérant dans la corbeille.
Lignes de commande
Il existe trois façons d'accéder au panneau de la ligne de commande.
- Playlist unique
Dans l'explorateur de projet, cliquez sur "lignes de commande"
2. Scénario
Faites un clic droit sur le script que vous voulez exécuter avec les lignes de commande
3. Plusieurs listes de lecture
Dans le menu de gestion des exécutions, sous "Exécutions", cliquez sur le bouton correspondant.
Ce panneau vous permet d'obtenir les lignes de commande nécessaires pour chaque lanceur.
Vous pouvez exécuter ces lignes de commande en cliquant sur le bouton "Ouvrir le terminal".
Pour l'exécuter en Java, vous aurez besoin de deux lignes de commande.
Le premier pour compiler en Java et le second pour exécuter en Java.
Package un projet
Lorsque vous souhaitez ajouter des scripts d'un projet de test à un autre, vous pouvez « package » l'intégralité du projet, puis l'ajouter aux bibliothèques du projet cible.
Pour ce faire, cliquez sur Outils du projet > Projet « Package »
Cela permettra de créer le fichier .jar.
Ouvrez le répertoire dans lequel se trouve le fichier .jar.
Passez à l'autre projet à l'aide de la commande «Changer de projet».
Cliquez sur les onglet « Bibliothèques » dans l’Explorateur de projet > Ouvrir dans l’explorateur système.
Copiez le fichier .jar dans le répertoire « libraries ».
Rechargez le projet pour le mettre à jour dans Outils du projet > Recharger le projet
Désormais, les scripts appartenant au projet d'origine sont identifiés par le label « lib ».
Ces scripts peuvent être utilisés, mais ne peuvent pas être modifiés directement.
Dialogue avec l'IA
Cliquez avec le bouton droit sur un script et sélectionnez «Discuter avec un agent IA»
Les invites du système de l'agent s'articulent autour de trois objectifs précis :
- Rédaction du champ de description (1 à 2 phrases à copier-coller)
- Une analyse écrite de la robustesse
- Pertinence et suggestions d'améliorations structurelles (regroupement, indices, dénomination).
Les fonctions devant être insérées dans le script (commentaires, assertions) sont volontairement désactivées jusqu'à ce qu'elles soient automatiquement intégrées.
