Catégories

Utilisation des variables

Vous pouvez regarder notre tutoriel ou vous pouvez consulter notre documentation sur l'utilisation des variables :

Une gestion conviviale

Notre approche : pour produire un logiciel qui permette à des personnes non familiarisées avec le développement d'effectuer des tests logiciels automatisés, nous avons beaucoup réfléchi à l'idée de variables et à la manière de les mettre en œuvre dans Agilitest.

Nous avons décidé de les implémenter de manière à ce qu'elles n'aient pas d'impact sur le déroulement des actions effectuées par le testeur. C'est pourquoi il n'y a pas d'action de calcul, d'action de mise à jour, ni d'action de transformation des variables dans Agilitest. Toutes ces opérations sont gérées dans un onglet séparé dédié à la gestion des variables.

Ce comportement permet de réserver la partie éditée du script aux actions sur les composants des applications testées et aux vérifications qui sont faites, et facilite la compréhension des tests.

L'onglet de gestion des variables dans Agilitest

Pour simplifier les opérations et éviter les erreurs, nous avons défini deux origines de variables :

-les variables de couleur orange qui proviennent de l'interface utilisateur et des éléments de l'application testée, et qui ne sont pas modifiables.

-les variables de couleur violette qui sont déclarées par l'utilisateur ou créées à partir de variables orange non éditables, elles peuvent être éditées et modifiées

Ces deux types de variables peuvent être utilisés pour déclarer de nouvelles variables violettes.

L'ensemble des variables d'un test est donc un assemblage d'arbres de dépendances de variables, Agilitest et ATS mettront automatiquement à jour les variables dépendantes d'autres variables lorsqu'elles seront modifiées.

Ainsi, l'utilisateur ne doit se préoccuper que de récupérer des valeurs sur les éléments des pages ou des écrans testés et de créer des variables dépendantes, et il sait que, de toute façon, les valeurs de l'ensemble des variables dépendantes qu'il a déclarées seront toujours à jour avec le contexte actuel du test effectué.

Ce mécanisme permet beaucoup de flexibilité et de facilité de traitement pour les personnes qui ne sont pas habituées au développement informatique.

Comment créer une variable ?

Il y a plusieurs façons de créer des variables dans Agilitest :

Variable d'environnement

Les variables d'environnement sont déclarées dans les exécutions de votre projet, dans l'onglet"Paramètres d'exécution".

Il suffit de sélectionner une exécution, puis vous pouvez ajouter un nouveau paramètre et modifier sa valeur.

Gestion des paramètres d'exécution

NB : Ces variables sont nécessairement déclarées comme chaines de caractères et ne peuvent pas utiliser des fonctions de modifications qui sont accessibles pour les autres variables.

Pour les utiliser dans vos scripts, utilisez la fonction $env(nom_du_paramètre), par exemple, dans le cas ci-dessus, $env (browser) affichera "chrome".

Variable de script modifiable

Ces variables sont créées dans l'onglet "Variables du script courant" en cliquant sur le menu et en sélectionnant "Créer une variable".

Création d'une variable de script modifiable

Vous allez créer une variable de couleur violette, modifiable. Vous pouvez ensuite lui donner un nom et une valeur.

Dès que votre variable a une valeur, celle-ci apparaît à droite de son nom. Cela permet à tout moment de vérifier les valeurs des variables du script en cours.

Si la variable n'est pas déclarée correctement et qu'Agilitest ne peut pas lui attribuer une valeur, il affiche un message d'erreur en plus du nom de la variable.

Erreur dans la déclaration d'une expression régulière

Pour définir la valeur de la variable, vous pouvez utiliser le menu"Insérer une valeur spéciale" à droite du champ de saisie, qui vous donne accès à toutes les catégories de variables pouvant être utilisées dans Agilitest.

Menu Insérer une valeur spéciale

Ces fonctions sont accessibles pour définir toutes les variables éditables dont vous aurez besoin, elles peuvent être concaténées pour générer une valeur plus complexe.

Voici les principales fonctions pour y accéder :

$env(paramètre): Renvoie la valeur d'un paramètre d'exécution défini dans l'exécution courante.

$var(variable): Retourne la valeur d'une variable

$param(index_param): Dans un indice, renvoie la valeur d'une variable passée en paramètre en donnant son indice.

  • Random chaîne de caractère:

Renvoie un chaîne de caractère aléatoire indiquant le nombre de caractères souhaité et sa casse. La fonction s'utilise comme suit :

$rndstring(10) : génère un chaîne de caractère de 10 caractères aléatoires

$rndstring(15, low): génère un chaîne de caractère de 15 caractères en minuscules

$rndstring(8,upp): génère une majuscule chaîne de caractère de 8 caractères

  • Id. unique:

Renvoie un identifiant dans le format Universal Unique Identifier, il est utilisé comme ceci :

$uuid: génère un UUID, exemple : 110e8400-e29b-11d4-a716-446655440000

  • Maintenant:

Renvoie un chaîne de caractère indiquant l'heure actuelle de l'ordinateur qui rejoue le test (ou le serveur d'intégration continue), il est utilisé comme ceci :

$now: heure du serveur, par exemple : 17:38:11

  • Aujourd'hui:

Renvoie un chaîne de caractère indiquant le jour actuel de la station qui rejoue le test (ou le serveur d'intégration continue), il est utilisé comme ceci :

$today: jour du serveur, par exemple : 08/30/2019

  • Identifiant du projet:‍

‍Retourne un chaîne de caractère qui identifie le projet contenant le fichier ats, il est utilisé comme ceci :

$pgav: com.functional.Test(0.0.1)

Variables de script non modifiables

Ces variables sont générées à partir d'éléments des applications testées, en utilisant l'action "Propriété".

Cette action prend en entrée un élément de l'interface utilisateur qui devra être capturé, ainsi que le nom de l'attribut de cet élément qui nous intéresse.

Récupérez un attribut d'un élément et le réutiliser dans un appel SOAP.

Ces variables sont de couleur orange et ne peuvent être modifiées.

Un script contenant des variables modifiables et non modifiables

Utilisation avancée des variables

Agilitest vous permet de transformer une variable de 5 façons différentes pour faciliter les calculs.

  • Chaines de caractères
  • Expressions régulières
  • Date
  • Temps
  • Numérique

Chaines de caractères

Par défaut, toutes les variables sont des chaines de caractères.

Une variable peut être transformée à la création en cliquant sur le bouton correspondant.

Transformation des variables

La transformation d'une chaîne de caractère fait apparaître une page selon le type qui permettra de la gérer. Si vous cliquez sur le bouton "Annuler", votre variable redevient un chaîne de caractère .

Nous allons prendre deux variables qui serviront d'exemple.

date : 8/9/2019
heure : 11:34:33

Déclarez deux variables

Vous pouvez concaténer des variables au format chaîne de caractère entre elles et avec du texte.

Par exemple, si vous créez une variable $day, et que vous lui donnez la valeur $var (date)_$var (heure), sa valeur littérale sera 8/9/2019_11 : 34 : 33


Transformation d'expressions régulières

Les expressions régulières sont utilisées pour diviser les chaines de caractères afin de générer des variables correspondant à des sous-groupes de caractères.

Le menu de gestion des expressions régulières vous demande un modèle qui doit correspondre à votre valeur originale.

Ce modèle comporte des parenthèses qui définissent les sous-groupes et sont utilisées pour déterminer quelle sera la valeur de la variable. En sélectionnant le groupe 1, la variable aura la valeur qui correspond au modèle défini dans la première parenthèse.

 Récupération de la date à partir de la variable day
Récupération de l'heure à partir de la variable jour

Transformation en date

Il est possible d'effectuer des calculs de date pour obtenir une date plus ou moins tardive, dans un jour, un mois, etc.

À partir de la valeur saisie, des sélecteurs permettent d'ajouter ou de soustraire des jours, des mois ou des années.

Le format d'origine pris en charge peut être m/j/aa ou aaaa-mm-jj.

La date obtenue peut ensuite être utilisée dans des variables regex pour récupérer le jour, le mois ou l'année.

Déclaration et utilisation des variables de date

Transformation en temps

Il fonctionne de la même manière que la transformation d'une variable en date, dans ce cas les sélecteurs vous permettent d'ajouter ou de supprimer des heures, des minutes ou des secondes à un moment donné.

Le format de la variable d'entrée est hh:mm:ss

Déclaration et utilisation des variables temporelles

Transformation en numérique

Les variables transformées en numérique sont utilisées pour manipuler des entiers ou des décimales au format nn.nnnnnn.

Le format d'entrée peut être un nombre décimal respectant ce format, mais aussi un nombre décimal dont le séparateur sera une virgule.

Déclaration d'une variable numérique

Il est possible d'utiliser des opérateurs standard pour effectuer des calculs :

  • +: addition
  • - : soustraction
  • *: multiplication
  • / : division  

Les fonctions mathématiques les plus courantes sont implémentées : sin, cos, tan, puissance, ln, etc.

Pour des cas très spécifiques où vous auriez des opérations particulières à effectuer, vous pouvez appeler du code java en passant certaines valeurs en paramètre et en récupérant ensuite une variable sur laquelle vous pouvez mettre un contrôle.

Vous avez encore besoin d'aide ?
Contacter le support