Vous venez d'obtenir votre licence ou une version d'essai et à l'aide de cette documentation vos premiers pas sur Agilitest seront guidés. Voici un article pour vous aider à installer Agilitest puis à réaliser vos premiers tests.
▶️ Vous pouvez trouver un tutoriel sur l'installation d'Agilitest sur notre canal Youtube.
1. Télécharger Agilitest
Agilitest s'installe sur un ordinateur fonctionnant sous le système d'exploitation Windows. Avant de commencer votre installation, il est préférable de prendre connaissance des prérequis techniques listés dans une documentation dédiée.
Si vous n'avez pas accès aux archives d'Agilitest, rendez-vous sur la page : https://www.agilitest.com/free-trial.
Entrez vos informations personnelles et nous reviendrons vers vous pour une courte démonstration avant l'installation.
Notre équipe d'assistance vous donnera un lien pour télécharger l'archive.
Une fois que vous avez un lien pour télécharger Agilitest, et que vous êtes sûr d'avoir une licence active ou une version démo, vous pouvez installer Agilitest sur votre ordinateur.
Pour ce faire, ouvrez votre répertoire de téléchargement dans votre explorateur Windows pour récupérer votre dossier .zip.
Le dossier .zip contient tous les fichiers nécessaires au fonctionnement d'Agilitest.
Vous pouvez extraire ce dossier en cliquant sur la commande "Extraire tout".

Ensuite, placez votre dossier dans le dépôt de votre choix dans lequel vous pouvez créer un sous-dépôt nommé "Agilitest" afin de mieux organiser vos fichiers.
🔸 Avertissement
Veillez à placer votre dossier Agilitest dans un répertoire où vous avez des droits d'accès. Si ce n'est pas le cas, cela peut poser des problèmes lors de la création de scripts. Le répertoire "Document" est recommandé.
Cliquez sur "Ok" pour confirmer l'emplacement de votre archive et des fichiers qui la composent.
Ouvrez votre dossier Agilitest et double-cliquez sur votre fichier .exe pour lancer Agilitest.
2. Lancer Agilitest
La fenêtre ChangeLog apparaît à l'ouverture d'Agilitest lorsque vous ouvrez Agilitest pour la première fois ou lorsque des modifications ont été apportées depuis la dernière fois que vous avez ouvert le logiciel.
.png)
Le ChangeLog est là pour vous informer de la dernière version en cours d'Agilitest et des modifications qui ont été apportées au logiciel (parfois avec une courte vidéo explicative pour mieux comprendre).
Lors de votre première ouverture d'Agilitest, les conditions d'utilisation vous seront présentées.
Lisez-les et cliquez sur le bouton "Accepter".
.png)
Une fois cette opération effectuée, les premières mises à jour des composants de l'ATS démarrent automatiquement.
.png)
Une mise à jour est effectuée environ toutes les semaines, notamment pour supporter les évolutions des navigateurs et des pilotes web.
Agilitest fonctionne avec le JDK (Java Development Kit). Java sera utilisé pendant toute la phase de compilation et d'exécution des projets automatisés. Par défaut, vous aurez besoin d'un JDK dans votre environnement.
Pour paramétrer votre JDK, vous pouvez le faire à partir du menu des paramètres dans Agilitest.

Il est possible d'établir un lien avec un JDK existant sur votre ordinateur ou de le télécharger directement à partir d'Agilitest, comme indiqué en cliquant sur le bouton "Télécharger". Ceci téléchargera le JDK ouvert qui est une version auto-déclarée du JDK.
.png)
Les deux conditions préalables à l'utilisation d'ATS sont le paquetATS et le JDK qui rendra l'éditeur fonctionnel.
Vous devez disposer au minimum de la version 11 du JDK. Agilitest téléchargera la dernière version.
💡 Conseil
Si UFT est installé avec un JDK dans les variables d'environnement, vous pouvez faire cohabiter Agilitest avec ce JDK ouvert existant.
Vous pouvez revenir à l'interface de l'éditeur en fermant la fenêtre ouverte.

La licence est située tout en haut de votre éditeur. En cliquant dessus, une fenêtre de licence apparaîtra avec un certain nombre d'informations telles que l'identifiant, l'identifiant du système, etc...

Vous pouvez également créer ou modifier votre identifiant en saisissant un autre identifiant dans la barre de saisie, puis en cliquant sur les boutons"Créer un compte" ou"Modifier l'identifiant".
Vous pouvez également trouver des informations sur votre licence dans la section "Aide".


Dans le menu"Aide", vous trouverez également divers liens qui complètent l'utilisation d'Agilitest.
.png)
Vous trouverez le lien pour télécharger Agilitest. Des liens pour télécharger Mobile Station sur Windows ou MacOs et un lien pour télécharger le lecteur ATSV.
Dans la barre latérale de droite se trouvent diverses ressources avec des liens vers la documentation d'Agilitest, le site web, des tutoriels, des pilotes web et une liste d'intégrations que vous pouvez utiliser avec Agilitest.
Dans le menu Outils, vous trouverez des outils supplémentaires qui peuvent améliorer l'utilisation d'Agilitest.

Par défaut, Agilitest affichera une icône d'erreur s'ils ne sont pas téléchargés. Il est recommandé de les télécharger tous lors de l'installation pour qu'ils soient accessibles.
.png)
L'éditeur peut être divisé en plusieurs parties. La partie gestion de projet avec des boutons pour créer un projet ou des composants.
.png)
La section des paramètres et configurations avec la catégorie Aide, Outils, etc...
.png)
L'explorateur de projet où sont placés les différents scripts et leurs composants.
.png)
La partie gestion descanal qui est utilisée pour gérer l'exécution des scripts.
.png)
Puis la partie consacrée aux variables ci-dessous.
.png)
Une documentation est à votre disposition pour plus de détails concernant l'interface Agilitest.
3. Créer un nouveau projet
▶️ Vous trouverez un tutoriel sur la création d'un nouveau projet sur notre canal Youtube.
Pour créer un nouveau projet, cliquez sur l'action "Nouveau projet".

Vous pouvez renommer votre projet et changer son domaine si vous souhaitez diviser votre projet en plusieurs domaines.

Lorsque vous créez un nouveau projet, un répertoire"AgilitestProjects" est créé dans lequel tous vos projets sont automatiquement placés.
Le chemin d'accès à votre projet dans l'explorateur Windows sera indiqué. Vous pouvez également ajouter une description à votre projet.
Une fois le projet créé, il sera placé dans l'arborescence du projet dans l'explorateur de projet.
.png)
Note: Les scripts Agilitest sont des fichiers ActionTestScript (ats). Vous pouvez créer des sous-répertoires pour mieux classer vos projets. Vous pouvez également créer des sous-scripts, qui n'ont aucune différence avec les scripts, les deux sont des fichiers ats , seul l 'un est appelé par l'autre.
Il y a deux façons de créer un script :
- En cliquant sur le bouton "Créer un scriptATS ".
.png)
2. En cliquant sur le bouton "Nouveau composant".

Et en sélectionnant "Créer un script ATS "
.png)
Saisissez le nom de votre script. Cela ouvrira une fenêtre correspondant aux interprétations graphiques des actions qui seront effectuées sur votre script. Le format ATS est un format textuel qui décrit toutes les actions.
.png)
Pour faire le lien entre Agilitest et l'application testée, vous devez ouvrir un canal.
Pour ce faire, cliquez sur le menu "Channels" et sélectionnez l'action "Start canal"
.png)
Il est possible de faire du canal en créant plusieurs actions de canal ouverts. Le nom de ces canaux s'adaptera automatiquement au nombre de canaux ouverts. Il est possible de les renommer.
🔸 Avertissement
Il est possible de ne faire qu'une seule instance avec les navigateurs web, ce qui signifie que pour un même navigateur ouvert dans plusieurs canaux, cela correspondra à plusieurs onglets ou canaux qui ouvrent différents navigateurs en parallèle.
Une fois que vous avez créé l'action canal , cliquez sur le bouton d'exécution pour lancer l'action.

La fenêtre d'ouverture du canal 'ouvre alors et contient diverses informations sur le navigateur et le système d'exploitation.
.png)
Sur l'interface Agilitest, l'ouverture du canal sera indiquée par sa présence dans la zone de gestion des canaux avec une ligne qui apparaît avec le nom donné au canal.
.png)
Dans un test web, pour accéder à une URL, vous devez cliquer sur le bouton "Navigation"et sélectionner "URL du navigateur".
.png)
Cliquez sur l'action pour ouvrir la barre de saisie et indiquez l'url que vous souhaitez lancer.

Une fois le site ouvert, vous pouvez effectuer diverses actions en utilisant les éléments qui le composent. Pour ce faire, vous devez capturer les éléments à l'aide de l'outil de capture.
Cliquez sur le bouton "Capture"dans la gestion des canaux
.png)
L'outil de capture s'ouvre en plaçant un filtre sur le canal et en faisant apparaître la fenêtre de capture. Avec votre souris, vous pouvez survoler les éléments DOM qui seront mis en évidence par une boîte bleue.

Pour capturer un élément, appuyez sur la touche CTRL de votre clavier pour ouvrir la fenêtre parente de l'élément capturé.
.png)
Cette fenêtre affiche l'arborescence de l'élément depuis la racine jusqu'au composant ciblé. Chaque branche de l'arbre possède des propriétés qui peuvent être sélectionnées en tant qu'attributs. Les propriétés peuvent être extraites des différentes branches de l'arbre pour plus de clarté.
🔸 Avertissement
Faites attention aux propriétés qui vont changer et qui ne pourront pas être reconnues dans le script par la suite (Exempletexte, classe, etc).
Cliquez sur un attribut pour ouvrir la valeur de la propriété. Celle-ci peut être modifiée sous la forme d'une expression régulière.
.png)
Une fois les attributs sélectionnés, cliquez sur le bouton "statistiques" pour confirmer l'unicité de l'élément trouvé.

Si plusieurs éléments correspondent à ces attributs, vous pouvez en sélectionner d'autres en remontant dans les branches.
Une fois cela fait, vous pouvez glisser-déposer votre élément dans le script, ce qui créera une action.
Sélectionnez l'action que vous souhaitez utiliser.
.png)
Une fois la capture terminée, vous pouvez la fermer à partir du menu de gestion des canal dans Agilitest.

Ou vous pouvez cliquer sur le bouton "Fermer"dans la fenêtre de capture pour arrêter l'outil de capture.

Vos actions seront ajoutées à votre script. Il est possible de les déplacer manuellement.

- Chaque action possède un index qui est automatiquement ajouté et qui s'adapte à sa position dans le script.
- Dans l'action se trouve la nature de l'action qui peut être configurée.
Exemple Pour la saisie de texte, vous pouvez saisir le texte que vous souhaitez voir apparaître dans votre test.
3. Enfin, vous verrez le composant qui a été capturé. Vous pouvez cliquer dessus pour avoir accès à sa valeur que vous pouvez modifier. Vous pouvez ajouter des parents et des enfants à votre élément et modifier la nature du composant.
.png)
Une fois votre script terminé, vous pouvez lancer l'exécution en cliquant sur le bouton "Jouer"dans le menu de gestion des chaînes.
.png)
🔸 Avertissement
Dans l'accès à distance, assurez-vous que vos sessions restent ouvertes pendant les exécutions.
Lorsque vous souhaitez fermer votre canal, vous pouvez créer une action "Fermer le canal".
.png)
Vous pouvez également fermer votre canal actuel à partir du menu de gestion des canaux.
Pour ce faire, cliquez sur le bouton "Fermersur le bouton " Fermer
.png)
Vous pouvez également cliquer sur le bouton "Stop"dans la ligne de canal
.png)
🔸 Avertissement
Vous ne devez pas fermer votre canal manuellement directement depuis l'application. Agilitest n'est pas intrusif (pas de plugin), il n'a aucun moyen de savoir que vous avez fermé une application directement par les actions du système d'exploitation (Exempleen cliquant sur la croix de la fenêtre de l'application).