Aller au contenu

Automatisation avec SKF

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]/[écosystème].[sous_écosystème]#[script]
ou
[dépôt]/[écosystème]#[script]
(La référence contient toujours un caractère #.)

avec :

  • [dépôt] : Chemin du dossier SKF racine (qui contient le fichier pom.xml) sur le dépôt de source.

  • [écosystème] : Écosystème de tests par défaut du projet SKF (tests).

  • [sous_écosystème] : Sous-écosystème de tests (il est possible d'en rajouter plusieurs en les séparant par un .).
    Ce paramètre est optionnel, c'est-à-dire qu'il peut être absent.

  • [script] : Nom du script de test à exécuter (avec son extension .ta ; ce paramètre est obligatoire)

Nature des paramètres Squash TM exploitables

Les paramètres Squash TM exploitables vont différer suivant si vous utilisez les composants Community/Premium ou Ultimate de Squash.

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é Community/Premium Ultimate
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 SKF 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 skf/params.

Les paramètres de test sont disponibles dans SKF sous forme de script context parameters.
Les paramètres globaux y sont disponibles sous forme de global context parameters.

Pour cela, il faut (voir la documentation de SKF) :

  • Faire appel aux paramètres désirés dans les fichiers utilisés par le test SKF via la syntaxe ${clé}.

  • Au sein du test SKF, appeler la commande suivante pour remplacer au sein d'un fichier les références des paramètres par les valeurs transmises à l'exécution :
    CONVERT {resourceToConvert<Res:file>} TO file (param) USING context_global_params, context_script_params AS {converted<Res:file>}.

Exemple

Ci-dessous un exemple de projet SKF exploitant un paramètre dans un fichier xml et l'automatisation du cas de test Squash TM associé :

Exemple SFK

Exemple SFK

Exemple SFK

Versions supportées

Squash a été validé avec SKF 1.14.0.

Compatibilité avec Maven 3.8.1 ou postérieur

Maven 3.8.1 (ou postérieur) bloque les dépôts accédés en http (voir Maven Release Notes). Ceci a pour effet d'empêcher le SoapUI Plugin d'accéder au dépôt Maven de SmartBear.
La solution consiste à déclarer le dépôt en https dans votre fichier pom.xml : 

<pluginRepository>
    <id>smartbear</id>
    <name>smartbear</name>
    <url>https://rapi.tools.ops.smartbear.io/nexus/content/groups/public</url>
</pluginRepository>