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]
ID d'exécution	TC_EXECUTION_ID
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

Disponibilité de l'ID d'exécution

TC_EXECUTION_ID est disponible uniquement avec Squash TM 8.0 ou une version ultérieure.

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.