Aller au contenu

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é :

katalon-params-1

katalon-params-2

katalon-params-3

katalon-params-4

katalon-params-5

Versions supportées

Squash AUTOM et Squash DEVOPS ont été validés avec Katalon 8.2.0. Toute version récente devrait fonctionner.

Retour en haut de la page