Démarrage rapide
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 configurer votre JDK, vous pouvez le faire à partir du menu des paramètres situé en bas à gauche de la barre latérale 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.

Les deux conditions préalables à l'utilisation de l'ATS sont les suivantes ATS package 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.
Affichez l'interface de l'éditeur Agilitest en haut à gauche de votre éditeur.

Dans cette interface, vous trouverez diverses informations :

- Toutes les informations concernant votre machine connectée à Agilitest ainsi que votre licence
- Menu « Journal des modifications » : pour afficher tous les journaux des modifications précédents
- Bouton « Copier la date »
- Licences utilisées : pour accéder à votre page de licences à l'aide de votre identifiant
- Bouton « Réinstaller »
- Commande : pour ouvrir un terminal
Vous pouvez également accéder à divers liens depuis le menu « Aide », situé en haut à droite de l'éditeur.

Ces liens viennent compléter l'utilisation d'Agilitest.

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.
Vous trouverez également diverses ressources comprenant des liens vers la documentation d'Agilitest, son site web, des tutoriels, des pilotes web et une liste des intégrations compatibles avec Agilitest.
Dans le menu « Outils externes », situé en bas de la barre latérale, vous trouverez des outils supplémentaires qui peuvent vous aider à tirer le meilleur parti 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.

La barre latérale située à gauche de l'éditeur comporte plusieurs menus permettant de créer, d'organiser et de maintenir scripts.

C'est dans l'explorateur de projet que sont stockés les différents scripts et leurs composants.

La partie « canal » sert à gérer l'exécution des scripts.

Puis la partie consacrée aux variables ci-dessous.

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» dans la barre latérale.

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 apparaîtra dans l'arborescence des projets de l'explorateur de projets, et le nom du projet en cours s'affichera en haut à gauche de l'éditeur.

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 ATS dans l'explorateur de projet.

2. En cliquant sur le bouton «Nouveau composant »dans la barre latérale.

Et en sélectionnant "Créer un script ATS "

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.

Pour faire le lien entre Agilitest et l'application testée, vous devez ouvrir un canal.
Pour ce faire, cliquez sur le menu «Chaînes », sélectionnez l'option «Démarrer canal, puis choisissez votre application.

Il est possible de créer canal en ouvrant plusieurs canal . Le nom de ces canaux s'adaptera automatiquement au nombre de canaux ouverts. Il est également possible de les renommer.
🔸 Avertissement
Vous ne pouvez créer qu'une seule instance par navigateur web, ce qui signifie que si le même navigateur est ouvert dans plusieurs canaux, cela correspondra à plusieurs onglets ou canaux ouvrant 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.

Dans un test web, pour accéder à une URL, vous devez cliquer sur le bouton "Navigation"et sélectionner "URL du navigateur".

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

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).

