Aller au contenu

Automatisation avec Ranorex

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

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 Squash DEVOPS 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 AUTOM et Squash DEVOPS ont été validés avec Ranorex 9.5. Toute version récente devrait fonctionner.