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.slnde 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é :
Versions supportées
Squash a été validé avec Ranorex 9.5. Toute version récente devrait fonctionner.