▶️ Vous trouverez un tutoriel sur la façon de gérer les canaux sur notre canal Youtube.

‍

Les tests réalisés avec Agilitest sont créés à partir de scripts qui ouvrent des canaux pour communiquer avec l'application testée. Agilitest vous permet d'ouvrir plusieurs canaux sur plusieurs appareils.

Dans un script ATS généré par Agilitest, il y a toujours un canal actif à un moment donné, et toutes les actions sont dirigées vers ce canal.

Dans Agilitest, il existe une distinction entre les actions de gestion des canaux dans les scripts ATS et le menu de gestion descanal dans l'éditeur pour effectuer des opérations de capture d'éléments graphiques.

‍

Démarrer un canal

Tous les tests doivent commencer par une action de démarrage du canal .

Pour ce faire, cliquez sur l'action canal dans le menu action

Cliquez ensuite sur "Démarrer le canal".

‍

L'action «Démarrer canal » vous permet de sélectionner l'application qu'Agilitest lancera pour vous.

Voici les possibilités :

Navigateurs

Vous pouvez choisir entre les navigateurs suivants : MsEdge, Chrome, Firefox, Brave, Opera, IE et Safari.

Chrome sera sélectionné par défaut. 

‍

Vous pouvez également utiliser des valeurs spéciales pour ouvrir un navigateur Web.

‍

Vous pouvez également connecter un compte à vos navigateurs.

Pour ce faire, cliquez sur le bouton clé pour activer l'autorisation, puis entrez votre identifiant et votre mot de passe.

Vous pouvez ajouter des arguments exécutables à vos canal de démarrage en cliquant sur le dernier bouton.

‍

Exemples : 

Argument « privé », 

Ou argument «headless»

‍

Toutes les options utilisées par les pilotes Chromium peuvent être exécutées.

https://peter.sh/experiments/chromium-command-line-switches/ 

‍

Demande

Vous pouvez ouvrir l'explorateur de fichiers de votre ordinateur ou le bureau.

Vous pouvez également utiliser des valeurs spéciales dans la section « Entrer le texte ».

Vous pouvez également sélectionner une application plus spécifique installée sur votre ordinateur à l'aide du bouton Fichier.

‍

Et vous pouvez ajouter des arguments au canal de démarrage de l'application.

‍

Vous pouvez ajouter un raccourci vers une autre application.

Pour ce faire, rendez-vous dans les paramètres d'Agilitest.

Ensuite, cliquez sur Modifier la configuration dans les ATS .

‍

Cela ouvrira les ATS de votre projet. 

Dans la section « Application » de vos propriétés, ajoutez le nom et le chemin d'accès à votre application.

‍

🔶 Avertissement

Si vous utilisez cette option et exécutez votre test sur d'autres machines, le fichier ATS doit également se trouver sur ces autres machines.

‍

‍

Processus

Il est également possible d'ouvrir un canal un processus déjà existant dans votre système d'exploitation.

Pour ce faire, démarrez un canal un processus > Démarrer le processus 

Ensuite, entrez une ligne de commande correspondant à un processus ou cliquez sur le bouton Fichier pour sélectionner un fichier exécutable.‍‍

‍

Vous pouvez également démarrer un canal l'action « Attacher au processus ».

Pour ce faire, dans canal de démarrage, sélectionnez Processus> Attacher au processus.

Pour vous connecter à un processus, vous devez entrer des mots-clés qui existent dans la ligne de commande du processus.

‍

Exemple : 

Vous pouvez utiliser Process Explorer pour accéder à la ligne de commande de vos applications.

Vous devez ensuite sélectionner quelques mots clés de l'application choisie.

Fenêtre

Vous pouvez choisir d'ouvrir une fenêtre soit à l'aide de son identifiant, soit à l'aide de son titre.

‍

Pour ouvrir un identifiant de fenêtre, vous devez entrer le NativeWindowHandle d'une fenêtre en cours d'exécution.

‍

NativeWindowHandle n'est pas une valeur permanente, elle changera à chaque fois que la fenêtre sera ouverte. 

‍

Pour récupérer le NativeWindowHandle, vous devez ouvrir un canal Desktop canal récupérer la propriété NativeWindowHandle d'une fenêtre existante.

‍

Pour ouvrir une fenêtre, vous devez saisir une partie du titre d'une fenêtre en cours d'exécution.

‍

application UWP

UWP est l'un des nombreux moyens de créer des applications client pour Windows qui fonctionnent sur les appareils Windows 10 et Windows 11, et qui peuvent être combinées avec d'autres plateformes.

‍

Pour démarrer un canal d'application UWP, canal devez entrer l'ID de l'application Windows UWP.

Vous pouvez utiliser des valeurs spéciales dans la section « Entrer le texte ».

‍

Voici la documentation Microsoft concernant les applications UWP : https://learn.microsoft.com/en-us/windows/uwp/get-started/universal-application-platform-guide

‍

Mobile

Pour démarrer un canal Mobile, canal devez entrer le point d'accès du Mobile dans le serveur MobileStation.

Vous pouvez également cliquer sur le bouton pour charger tous les appareils connectés à AtsMobileStation.

Vous pouvez utiliser des valeurs spéciales dans la section « Entrer le texte ».

‍

Pour en savoir plus sur AtsMobileStation : www.agilitest.com/documentation/mobile-station

Web Service

Vous pouvez ouvrir un Web Service une URL standard (http) ou d'une URL sécurisée (https).

‍

Pour l'un ou l'autre, vous devez saisir le début de web service .

Après cela, tous vos appels provenant de ce canal enregistrés par rapport à cette URL.

‍

Vous disposez également de 3 boutons qui sont des options que vous pouvez ajouter pour démarrer votre canal.

• Lancer canal le proxy ATS
• Activer l'autorisation « Basique »
• Accepter les cookies sur ce canal

‍

Exemple :

Lorsque vous souhaitez utiliser unwebservice REST ou SOAP webservice vous saisissez https://mywebservice.com/api

Le lien du webservice sera https://mywebservice.com/api/getListItems

‍

SAP

Pour ouvrir un canal SAP, canal devez être connecté à un serveur.

Vous devrez saisir les informations relatives au serveur SAP qui s'affichent lors de la connexion SAP : le nom de la connexion, le numéro de client (c'est-à-dire le numéro de mandat associé) et éventuellement la langue (EN/FR/...).

‍

Pour en savoir plus sur la connexion à un serveur SAP : www.agilitest.com/documentation/connecting-to-a-sap-server

‍

Renommer votre canal

Ensuite, il est préférable de renommer le canal que vous avez ouvert afin qu'il puisse être référencé dans les actions suivantes.

Pour ce faire, cliquez directement sur le bouton "Démarrer le canal".

‍

Saisissez ensuite le nom que vous souhaitez donner à votre canal.

‍

Il est possible d'ouvrir plusieurs canaux dans un même script.

‍

canal

L'action"Changer de canal" permet de passer d'un canal à un autre canal ouvert identifié par son nom.

À partir de cette action, toutes les actions suivantes seront dirigées vers le canal spécifié dans l'action"Changer de canal".

‍

🔸 Avertissement

Le démarrage d'un nouveau canal signifie qu'il l'activera directement.

‍

Vous pouvez également utiliser le menu de gestion des canal pour changer la chaîne active.

Pour ce faire, cliquez sur la coche bleue à côté du nom du canal pour le rendre actif.

Cependant, le changement de canal dans le menu de gestion des canal n'apparaîtra pas comme une action dans votre script.

‍

canal proche
‍

La fermeture d'un canal indique à Agilitest que ce canal ne sera plus utilisé pendant ce test et ferme l'application.

‍

Vous pouvez également fermer le canal en cours à partir du panneau de gestion des exécutions de l'éditeur Agilitest.

Pour ce faire, cliquez sur le bouton "Fermersur le bouton " Fermer

Ou la touche "Stop sur la ligne du canal

‍

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

‍

Menu de gestion des canaux

Le menu de gestion des canal permet de gérer les différents canaux d'entrée des actions lors du débogage des tests.

Le menu de gestion des canal est situé à gauche, sous l'explorateur de projets.

Il comporte plusieurs icônes ayant les fonctions suivantes :

‍

Bouton de capture

Cette action n'est disponible que si vous avez déjà ouvert un canal. Elle permet d'entrer dans le mode capture et de sélectionner les éléments sur lesquels effectuer des actions.

‍

Bouton de fermeture

Cette action permet de fermer proprement un canal ouvert, c'est-à-dire de fermer l'application et d'indiquer à Agilitest qu'elle est fermée.

‍

Bouton de lecture

Cette action lance une exécution complète à partir de l'action actuelle. Si vous utilisez le bouton de lecture pour une action qui ne peut pas être exécutée, vous recevrez un message d'erreur.

‍

🔶 Avertissement

Dans Agilitest, tous les scripts peuvent être des sous-scripts d'autres scripts. Dans l'éditeur, il est impossible pour Agilitest de déterminer le début d'un test. Vous devez donc indiquer l'action avec laquelle vous souhaitez démarrer votre test lors des phases d'édition et de débogage.

‍

Bouton suivant

Cette action exécute l'action sélectionnée et passe à l'action suivante. Vous pouvez ainsi exécuter votre test en séquence, étape par étape. Cette action est équivalente à l'action d'exécution de chaque action affichée à droite de l'action courante dans l'éditeur.

‍

Bouton des paramètres

Cette action affiche un sous-menu permettant de sélectionner les paramètres d'exécution en cours dans l'éditeur.

• Animer: Cette option vous permet de rejouer le test en animant les actions effectuées.

Exemplemouvement de la souris, clics, saisie de texte, etc...

• Rapport visuel : Le rapport visuel a le même résultat que l'animation, mais sous la forme d'un rapport vidéo : un fichier ATSVATS Video) est généré dans le répertoire /target/reports. Il n'est pas nécessaire de mettre le replay en mode animation pour obtenir le rapport visuel.
• Rapport XML : Agilitest produira un rapport d'exécution du test au format XML (actions.xml), ainsi qu'un ensemble d'images correspondant aux écrans qui ont été visités par le test. Ces éléments sont stockés dans le répertoire /target/report/>test_name>. Ils peuvent ensuite être manipulés pour produire trois niveaux de rapports d'exécution ainsi qu'un rapport pdf à l'aide de JASPER. La production d'un rapport XML active la génération d'un rapport visuel.
• Exécuter en mode réduit : Cela vous permet de masquer l'éditeur Agilitest pendant l'exécution du test, et donc de mieux voir l'application testée.

‍

💡 Conseil

Le mode réduit est très utile si vous utilisez Agilitest sur un seul écran.

‍

Problèmes potentiels

échec de l'ouverture du canal

Que faire si l'éditeur Agilitest ne veut pas ouvrir un test et capturer un canal?

‍

S'il s'agit d'un problème lié au JDK, alors :

• Vérifier que Java a été installé et que sa version est compatible avec Agilitest (version 14+).

Il peut être installé directement à partir du menu"Configurations" d'Agilitest, en haut à droite de l'éditeur.

Cliquez sur le bouton "Télécharger"pour télécharger la dernière version de Java directement à partir d'Agilitest.

‍

Si le problème se situe au niveau des pilotes et/ou des bibliothèques :

Cela signifie qu'un fichier est bloqué par le pare-feu ou le logiciel antivirus. Dans ce cas, deux solutions sont possibles :

1. Régénérer les fichiers de pilotes et de librairies

• Répétez l'opération en veillant à ce que le blocage ne se reproduise pas (neutralisation temporaire de l'antivirus).
• Fermer Agilitest
• Allez dans le dossier utilisateur de votre ordinateur pour supprimer manuellement les dossiers"drivers" et"libs".

• Ouvrez à nouveau Agilitest pour forcer une régénération des fichiers avec les dernières versions disponibles dans SAAS.

         2. Télécharger manuellement les paquets pour les déployer soi-même

• Via le menu"Settings", téléchargez le package zippé "Drivers and Libraries".

• L'archiveats.zip" sera automatiquement téléchargée via votre navigateur par défaut.
• Décompressez cette archiveats.zip" contenant les dossiers"drivers" et"libs" dans votre propre dossier utilisateur.
• C:\NUtilisateur "Votre_compte"\NActiontestscript

‍

Si le problème persiste, vous pouvez contacter notre équipe d'assistance à l'adresse support@agilitest.com ou directement via Slack.

‍

Ouvrir un canal avec des plugins

Lorsque vous démarrez un canal navigation avec Agilitest, le canal sera sans plugins, sans historique, sans comptes, etc...

Cela simule l'utilisation d'un utilisateur réel visitant votre application pour la première fois. C'est pourquoi un canal démarré par Agilitest ne charge pas les extensions par défaut.

‍

Il existe plusieurs façons d'obtenir le comportement souhaité, la plus simple étant de créer un profil d'utilisateur et de définir ce profil d'utilisateur au démarrage du canal

Il est également possible d'ajouter des éléments à votre fichier ats.properties.

Voir la documentation officielle : www.actiontestscript.com

‍