Aller au contenu

Automatisation avec Ranorex

Cette fonctionnalité est disponible uniquement dans la version Ultimate de Squash.

Configuration de l'environnement d'exécution

Dans l'environnement d'exécution, le chemin vers le dossier contenant MSBuild.exe doit être renseigné dans une variable d'environnement nommée SQUASH_MSBUILD_PATH. Vous pouvez exécuter la commande suivante pour trouver le chemin vers votre exécutable MSBuild :

reg.exe query "HKLM\SOFTWARE\Microsoft\MSBuild\ToolsVersions\4.0" /v MSBuildToolsPath

Référence du test dans Squash TM

Pour lier un cas de test Squash TM à un test automatisé, le champ Référence du test automatisé du bloc Automatisation du cas de test doit avoir la forme suivante :

[dépôt]/[solution]#[projet]#[suite]#[cas_de_test]
ou
[dépôt]/[solution]#[projet]#[suite]
(La référence contient deux ou trois caractères #.)

avec :

  • [dĂ©pĂ´t] : Nom du dĂ©pĂ´t Git.

  • [solution] : Chemin vers le fichier .sln de la solution Ă  partir de la racine du projet sur le dĂ©pĂ´t de source.

  • [projet] : Nom du projet Ă  exĂ©cuter.

  • [suite] : Nom de la suite de tests Ă  exĂ©cuter.

  • [cas_de_test] : Nom du cas de test Ă  exĂ©cuter.
    Ce paramètre est optionnel, c'est-à-dire qu'il peut être absent.

Détermination du résultat du cas de test

Si un test [cas_de_test] n'est pas spécifié, le résultat du cas de test Squash TM est calculé en prenant en compte les résultats individuels de chaque test de la suite [suite] :

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

Nature des paramètres Squash TM exploitables

Voici le tableau des paramètres exploitables (ces paramètres sont transmis en tant que paramètres de test, voir ci-dessous, Squash TM ne génère pas de paramètres globaux) :

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
UUID interne du cas de test TC_UUID
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

Comme indiqué, 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 sur les champs personnalisés.

Utilisation de paramètres

Il est possible lors de l’exécution d’un test Ranorex d’exploiter des paramètres au sein de celui-ci. Un paramètre peut être un paramètre de test ou un paramètre global. Squash TM ne transmet que des paramètres de test. Des paramètres de test et des paramètres globaux peuvent être utilisés dans le cas d'un lancement à partir d'un pipeline CI/CD avec l'action ranorex/params.

Chaque paramètre est disponible dans Ranorex sous la forme d'un global parameter et, si adéquat, d'un local parameter (voir la documentation de Ranorex) :

  • si la rĂ©fĂ©rence du test contient le nom d'un cas de test ([cas_de_test] ci-dessus), le paramètre, que ce soit un paramètre de test ou un paramètre global, sera dĂ©fini dans Ranorex Ă  la fois comme un global parameter et un local parameter ;
  • sinon, si la rĂ©fĂ©rence du test ne contient pas le nom d'un cas de test, il ne sera dĂ©fini que comme global parameter.

Si le même nom est utilisé pour un paramètre global et un paramètre de test, c'est ce dernier qui est pris en compte dans Ranorex.

Exemple

Ci-dessous un exemple de solution Ranorex et l’automatisation du cas de test Squash TM associé :

Exemple Ranorex

Exemple Ranorex

Versions supportées

Squash a été validé avec Ranorex 9.5. Toute version récente devrait fonctionner.