Automatisation avec Katalon
Cette fonctionnalité est disponible uniquement dans la version Premium de Squash AUTOM.
Le support de Katalon est disponible à partir de Squash TM 3.0.
Configuration de l'environnement de test
katalonc
doit être présent dans l'environnement de test et accessible via la variable d'environnement système PATH.
Les trois variables d'environnement système suivantes doivent être définies et renseignées dans l'environnement d'exécution :
Variable | Contenu | Exemple |
---|---|---|
KATALON_API_KEY | Clef de licence API de Katalon | 123a4567-123a-1ab2-1234-1234567890ab |
KATALON_ORG_ID | ID d'organisation chez Katalon | 123456 |
KATALON_BROWSER_TYPE | Type de browser par défaut | Web Service |
Référence du test dans Squash TM
Info
Le résultat de chaque exécution d'un cas de test Squash TM est calculé en prenant en compte les résultats individuels de chaque cas de test appartenant à la collection de suites de tests ou à la suite de tests, du fichier projet (.prj) Katalon à traiter :
- Si au moins un test est en statut Error (dans le cas d'un problème technique), l'exécution sera en statut Blocked.
- Si au moins un test a échoué fonctionnellement et qu'aucun test n'est en statut Error, l'exécution sera en statut Failed.
- Si tous les tests ont réussi, l'exécution sera en statut Success.
Pour lier un cas de test Squash TM à un test automatisé Katalon, le champ Référence du test automatisé du bloc Automatisation du cas de test doit avoir la forme suivante :
[1] / [2] # [3] # [4] # [5]
Avec :
-
[1]
: Nom du projet sur le dépôt de source. -
[2]
: Chemin jusqu'au nom du fichier projet Katalon (avec son extension.prj
) à partir de[1]
. -
[3]
: Chemin relatif à partir du dossier du projet Katalon jusqu'au nom de la collection de suites de tests.
Ce paramètre est exclusif par rapport à[4]
. -
[4]
: Chemin relatif à partir du dossier du projet Katalon jusqu'au nom de la suite de tests.
Ce paramètre est exclusif par rapport à[3]
. -
[5]
: Chemin relatif à partir du dossier du projet Katalon jusqu'au nom du cas de test spécifique à parser pour lequel on désire obtenir un résultat en particulier. Ce paramètre est optionnel.
Référence du test automatisé et exécution
La précision du chemin relatif à partir du dossier du projet Katalon jusqu'au nom du cas de test spécifique [5]
, dans la référence du test, n'influe pas sur l'exécution, mais sur la détermination du résultat du test.
Ainsi, même en définissant une granularité à l'échelle du cas de test spécifique, la totalité des cas de tests contenus dans la collection de suites de tests ou dans la suite de tests sera exécutée (ce qui signifie, par exemple, que si plusieurs cas de tests Squash TM pointent vers la même collection de suites de tests ou vers la même suite de tests, mais vers des cas de test différents, tous ces cas de tests seront exécutés plusieurs fois).
Les rapports de test contiennent les traces de tous les cas de tests exécutés. Par contre, seuls les statuts Error / Failed / Success correspondant à cette granularité fine seront considérés pour définir le résultat du cas de test Squash TM.
Choix exclusif de la collection de suites de tests ou de la suite de tests
Les sections [3]
et [4]
sont exclusives l'une par rapport à l'autre. on doit renseigner soit la collection de suites de tests, soit la suite de tests, mais pas les deux.
Au final, le champ Référence du test automatisé doit contenir obligatoirement 3 caractères #
.
Nature des paramètres Squash TM exploitables
Voici le tableau des paramètres exploitables :
Nature | Clé |
---|---|
Nom du jeu de données | DSNAME |
Paramètre d'un jeu de données | DS_[nom] |
Référence du cas de test | TC_REFERENCE |
Champ personnalisé du cas de test | TC_CUF_[code] |
Champ personnalisé de l'itération | IT_CUF_[code] |
Champ personnalisé de la campagne | CPG_CUF_[code] |
Champ personnalisé de la suite de tests | TS_CUF_[code] |
Légende :
[code]
: valeur renseignée dans le champ “Code” d’un champ personnalisé[nom]
: nom du paramètre tel que renseigné dans Squash TM
Utilisation de paramètres Squash TM
Il est possible lors de l’exécution d’un cas de test Squash TM automatisé avec Katalon d’exploiter des paramètres Squash TM au sein de celui-ci.
Pour cela, il faut suivre les étapes suivantes :
-
Renseigner des champs personnalisés dans Squash TM et les associer au projet portant le plan de tests à exécuter.
-
S'assurer que les champs code des paramètres correspondent aux noms des variables globales existants dans les cas de tests Katalon.
Info
Squash TM ajoute un préfixe au code du champ personnalisé transmis. Assurez-vous de le prendre en compte.
Voir la documentation de Squash TM pour plus d'information.
Ci-dessous les copies d'écrans de l'exemple du cas de test 3_PARAMS_TestCase_01_With_GlobalID
, inclus dans la suite de tests 3_TestSuite_Params_Action
, appartenant au projet Katalon katalon-samples
, dont les variables globales par défaut sont définies dans le fichier profile default
et l’automatisation du cas de test Squash TM associé :
Versions supportées
Squash AUTOM et Squash DEVOPS ont été validés avec Katalon 8.2.0. Toute version récente devrait fonctionner.