Aller au contenu

Importer des cas de test

Renseigner un fichier d’import de cas de test

L'import de cas de test via un fichier Excel permet de créer ou modifier un patrimoine de tests en masse. Il est possible d'importer des cas de test, leurs attributs et pas de test, leurs paramètres et jeux de données ainsi que leur associations à des exigences.

Cette fonctionnalité est très utile :

  • lors d'une migration depuis un outil tiers
  • pour récupérer un patrimoine de tests existant dans un document
  • pour effectuer des modifications en masse sur les cas de test présents dans Squash TM

L'import de cas de test se fait depuis des fichiers au format .xls, .xlsx, .xlsm ou une archive .zip.

Info

L'import est réservé aux profils "Administrateur" et "Chef de projet".
Un gabarit d'import pour les formats Excel ou Zip est téléchargeable depuis la popup d'import dans l'espace Cas de test.

Focus

Il n'est pas possible d'importer des cas de test BDD
Il n'est pas possible de modifier le format d'un cas de test (Classique/BDD/Gherkin) via l’import

Structure du fichier d'import au format Excel

Le fichier d'import comprend cinq onglets :

  • L'onglet TEST_CASES renseigne les informations liées aux cas de test à importer comme l'emplacement, la description, l'importance, etc.
  • L'onglet STEPS renseigne les informations sur les pas de test d'un cas de test classique
  • L’onglet PARAMETERS renseigne les informations liées aux paramètres des cas de test
  • L’onglet DATASETS renseigne les informations liées aux jeux de données
  • L'onglet LINK_REQ_TC renseigne les informations pour associer les cas de test aux exigences déjà présentes dans Squash.

Focus

Le fichier d'import doit respecter les règles ci-dessous :

  • Les noms des 5 onglets ne doivent pas être modifiés
  • Les entêtes des colonnes ne doivent pas être modifiées
  • Les lignes vides ne sont pas interprétées
  • Les cellules ne doivent pas être fusionnées
  • L'ordre des lignes n'a pas d'importance
  • L'import se fait ligne par ligne

Onglet TEST_CASES

Nom de la colonne Description Valeur attendue
ACTION Valeur qui indique l'action à effectuer. Champ Obligatoire
C : pour la création (Create)
U : pour la mise à jour (Update)
TC_PATH Chemin du cas de test. Il commence par "/nom du projet" et se termine par le nom du cas de test. Il inclut le nom du projet car l'import est multi-projet Champ Obligatoire
Par exemple :
- /projet/dossier/casdetest
TC_NUM Ordre du cas de test dans son dossier conteneur.

Cet ordre n'est appliqué que lorsque la bibliothèque des cas de test est triée par ordre positionnel.

- Mode CREATE : si non renseigné, considéré comme le dernier élément du conteneur. Si renseigné, le cas de test est donc créé à cette position.
- Mode UPDATE : si non renseigné l'information est ignorée. Si le numéro d'ordre renseigné est différent de l'ordre actuel le cas de test est déplacé à cette nouvelle position.
TC_UUID Identifiant universel unique du cas de test.

- Mode CREATE : si renseigné, le cas de test est créé avec cet UUID. Si non renseigné, le cas de test est créé avec un UUID généré automatiquement.
- Mode UPDATE : la valeur de la colonne TC_UUID n'est pas considérée. Il n'est pas possible de modifier l'UUID d'un cas de test déjà existant dans la base de données.
Si renseignée, la valeur de la colonne TC_UUID doit correspondre à l'expression régulière :
[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}
TC_REFERENCE Référence du cas de test
TC_NAME Nom du cas de test.
- Mode CREATE: le champ est ignoré
- Mode UPDATE : permet de renommer un cas de test
TC_MILESTONE Intitulé du ou des jalons associés au cas de test. Si un objet est associé à plusieurs jalons, chacun des jalons doit être renseigné dans la colonne correspondante séparé par un "|".
Mode UPDATE : si la colonne est vide, les associations existantes sont supprimées.
Par exemple si un cas de test est associé à deux jalons :
Jalon1|Jalon 2
TC_WEIGHT_AUTO Si, à l’import, la valeur est à "1" Squash déduit l’importance du cas de test en fonction des exigences qui lui sont associées y compris celles associées aux cas de test appelés.
Si la colonne ou la valeur est omise, la valeur par défaut prise en compte est "0" .
- "1" : Si le calcul de l’importance est automatique
- "0" : Si la valorisation de l’importance est manuelle.
TC_WEIGHT Code de l’importance du cas de test.
Si TC_WEIGHT_AUTO = 1, la valeur indiquée pour TC_WEIGHT est ignorée.
- VERY_HIGH (Très haute)
- HIGH (Haute)
- MEDIUM (Moyenne)
- LOW (Faible) [Valeur par défaut]
TC_NATURE Code de la nature du cas de test - NAT_ATDD (ATDD)
- NAT_BUSINESS_TESTING (Métier)
- NAT_FUNCTIONAL_TESTING (Fonctionnelle)
- NAT_NON_FUNCTIONAL_TESTING (Non fonctionnelle)
- NAT_PERFORMANCE_TESTING (Performance)
- NAT_SECURITY_TESTING (Sécurité)
- NAT_UNDEFINED (Non définie) [Valeur par défaut]
- NAT_USER_TESTING (Utilisateur)
TC_TYPE Code du type de cas de test - TYP_COMPLIANCE_TESTING (Recevabilité)
- TYP_CORRECTION_TESTING (Correctif)
- TYP_END_TO_END_TESTING (Bout-en-bout)
- TYP_EVOLUTION_TESTING (Évolution)
- TYP_PARTNER_TESTING (Partenaire)
- TYP_REGRESSION_TESTING (Non-régression)
- TYP_UNDEFINED (Non définie) [Valeur par défaut]
TC_STATUS Code du statut de rédaction du cas de test - APPROVED (Approuvé)
- OBSOLETE (Obsolète)
- TO_BE_UPDATED (À mettre à jour)
- UNDER_REVIEW (À approuver)
- WORK_IN_PROGRESS (En cours de rédaction) [Valeur par défaut]
TC_DESCRIPTION Description du cas de test
TC_PRE_REQUISITE Prérequis du cas de test
TC_CREATED_ON Date de création du cas de test. Les dates sont exportées dans des cellules de type date ou de type texte au format ISO 8601 Format : YYYY-MM-DD
Si elle n’est pas renseignée, la date courante est utilisée.
TC_CREATED_BY Login du créateur. Si non renseigné, c'est le login de l’utilisateur réalisant l'import qui est utilisé.
TC_KIND Code du format du cas de test.
Si non renseigné, le cas de test est importé comme un cas de test classique.
Format :
- STANDARD (Classique)
- KEYWORD (BDD)
- GHERKIN
TC_SCRIPT Script Gherkin du cas de test
TC_AUTOMATABLE Eligibilité à l’automatisation du cas de test - M : À instruire [Valeur par défaut]
- Y : Eligible
- N : Non éligible
TC_CUF_<cuf's code> Une colonne par champ personnalisé.
Dans l'en-tête, remplacer <cuf's code> par le code du champ personnalisé.
Valeur associée au champ personnalisé

En savoir plus

Pour en savoir plus sur la création d'un champ personnalisé, consulter la page Gérer les champs personnalisés

Onglet STEPS

Nom de la colonne Description Valeur attendue
ACTION Valeur qui indique l'action à effectuer. Champ Obligatoire
C : pour la création (Create)
U : pour la mise à jour (Update)
TC_OWNER_PATH Chemin vers le cas de test propriétaire du pas de test. Champ obligatoire
Par exemple :
- /projet/dossier/casdetest
TC_STEP_NUM Numéro d’ordre de l’étape de test (commence à 1)
Pour l’import, les numéros peuvent ne pas se suivre : on prend l’ordre relatif entre les différents TC_STEP_NUM.
L'ordre d'apparition dans le fichier est pris en compte si deux pas de test ont le même numéro d’ordre, ou si la valeur est absente
TC_STEP_IS_CALL_STEP Permet d'indiquer que ce pas de test est soit une action soit un cas de test appelé - "0" si l’étape est un pas de test [Valeur par défaut]
- "1" si l’étape est un cas de test appelé
TC_STEP_CALL_DATASET La colonne n’est prise en compte que si TC_STEP_IS_CALL_STEP = "1" - "INHERIT" si l’option choisie est de ne pas choisir de jeu de données, le cas de test appelant hérite des paramètres du cas de test appelé
- <NAME> : donne le nom du jeu de données choisi.
TC_STEP_ACTION - Action de l’étape
- Ou chemin vers le cas de test appelé
Par exemple, dans le cas d’un appel de cas de test :
CALL /projet/dossier/nom_du_CT_appelé
TC_STEP_EXPECTED_RESULT - Résultat attendu de l’étape
- Si STEP_IS_CALL_STEP = 1, cette colonne est ignorée
TC_STEP_CUF <cuf's code> Une colonne par champ personnalisé. Dans l'en-tête, remplacer <cuf's code> par le code du champ personnalisé du pas de test. Valeur associée au champ personnalisé

Onglet PARAMETERS

Nom de la colonne Description Valeur attendue
ACTION Valeur qui indique l'action à effectuer. Champ Obligatoire
C : pour la création (Create)
U : pour la mise à jour (Update)
TC_OWNER_PATH Chemin vers le cas de test propriétaire du paramètre Champ obligatoire
Par exemple :
- /projet/dossier/casdetest
TC_PARAM_NAME Nom du paramètre, doit contenir uniquement les caractères suivants : [0-9], [a-z], [A-Z] et [-,_]. Champ obligatoire
TC_PARAM_DESCRIPTION Description du paramètre

Onglet DATASETS

Nom de la colonne Description Valeur attendue
ACTION Valeur qui indique l'action à effectuer. Champ Obligatoire
C : pour la création (Create)
U : pour la mise à jour (Update)
TC_OWNER_PATH Chemin vers le cas de test propriétaire du jeu de données. Champ obligatoire
Par exemple :
- /projet/dossier/casdetest
TC_DATASET_NAME Nom du jeu de données. Champ obligatoire
TC_PARAM_OWNER_PATH Chemin vers le cas de test propriétaire du paramètre. Cette colonne est nécessaire dans le cas de paramètres venant de cas de test appelés par le cas de test propriétaire du jeu de données.
TC_DATASET_PARAM_NAME Nom du paramètre pour lequel la valeur sera renseignée. Il doit contenir uniquement les caractères suivants : [0-9], [a-z], [A-Z] et [-,_]. A l’import, si aucun paramètre ne correspond, la valeur est ignorée. Champ obligatoire
TC_DATASET_PARAM_VALUE Valeur correspondante pour le couple {jeux de données | paramètre} spécifié.

Pour faire des associations entre les cas de test et des exigences présentes dans le référentiel, les 3 champs sont obligatoires.

Nom de la colonne Description Valeur attendue
REQ_PATH Chemin de l'exigence depuis le nom du projet jusqu'au nom de l'exigence (version courante) NB : le nom de la version courante peut différer de celui de la version à lier Par exemple :
- /projet/dossier/exigence
- /projet/exiMère/exiFille
REQ_VERSION_NUM Numéro de la version d'exigence à lier
TC_PATH Chemin du cas de test depuis le nom du projet jusqu'au nom du cas de test Par exemple :
/projet/dossier/casdetest

Info

Avec un import Excel, il est possible de mettre en forme tous les champs de type texte riche comme la description ou encore les pas de test en utilisant des balises HTML.

Structure du fichier d'import au format Zip

L'archive .zip contient les dossiers, les sous dossiers ainsi que l'ensemble des cas de test à importer. Pour chaque cas de test à importer, il faut créer un fichier Excel. Chaque fichier doit contenir un onglet avec les informations du cas de test. Le nom de l’onglet doit correspondre au nom du cas de test à importer.
Ces fichiers doivent être placés dans leurs dossiers respectifs afin que l'arborescence de cas de test soit recrée au moment de l'import.

Par exemple:

  • Pour importer 10 cas de test, il faut 10 fichiers Excel.
  • Pour importer un cas de test dans un dossier intitulé "Dossier1" : il faut créer un dossier intitulé "Dossier1", y placer le fichier Excel qui contient les informations du cas de test à importer avant de le zipper pour import.

Focus

L’import par .zip ne permet pas d’importer des cas de test BDD et Gherkin
L'import par .zip se fait sur un seul projet à la fois
Seule la création de nouveaux cas de test est possible via un import par .zip
L'import par .zip ne permet pas d'importer les paramètres, les jeux de données et les associations d'un cas de test.

L'onglet du fichier Excel d'un cas de test doit contenir les balises suivantes dans ordre indiqué ci-dessous :

Balise Première valeur Deuxième valeur Commentaire
Description Indiquer la description du cas de test. Cette donnée alimentera le champ "Description" du cas de test
Importance Indiquer l'importance du cas de test en choisissant l'une des valeurs normées suivantes :
- VERY_HIGH (Très haute)
- HIGH (Haute)
- MEDIUM (Moyenne)
- LOW (Faible).
Cette donnée alimentera le champ "Importance" du cas de test
Created_by Indiquer le login du créateur. Cette donnée alimentera le champ "Créé par" du cas de test
Created_on Possibilité d'inscrire la date soit au format de cellule date (heure incluse) ou texte dans ce dernier cas, indiquer la date de création au format JJ/MM/AAAA. Cette donnée alimentera le champ "Créé par xxx le …" du cas de test
Action_step Indiquer l'action à réaliser. Indiquer le résultat attendu. Cette balise entraîne la création d'un nouveau pas de test à chaque fois qu'elle est rencontrée. Les pas de test sont créés dans l'ordre du fichier (de haut en bas).
Prerequisite Indique les informations à ajouter dans les "Prérequis" du cas de test. Si plusieurs lignes du fichier Excel sont renseignées avec cette balise, les différentes valeurs seront concaténées dans le champ "Prérequis".

Par exemple:
Les informations du cas de test sont contenus dans le premier onglet. Le nom donné à cet onglet sera le nom du cas de test "Cas de test 1"

Exemple de fichier Excel pour un import au format ZIP

Cas pratiques d'imports de cas de test

Squash permet d’importer une arborescence de cas de test depuis un fichier au format .xls ou .zip

Pour réaliser cet import, il faut renseigner un fichier Excel en respectant les recommandations faites dans Structure du fichier d'import au format Excel puis l'importer via l'option [Importer] de l'espace Cas de test. Il est possible de simuler l'import pour vérifier la cohérence du fichier d'import avant de l'importer.

En savoir plus

Pour plus de détails sur la procédure à suivre pour réaliser un import, consulter la page Importer un objet.

L'import permet de créer des cas de test avec toutes les fonctionnalités disponibles dans l'espace Cas de test:

Créer une arborescence de cas de test

L'arborescence est très importante car elle permet d'organiser le référentiel de tests. L'import offre la possibilité de créer une arborescence précise des dossiers et cas de test à importer et ce dans plusieurs projets à la fois.

Importer une arborescence de cas de test

Si les dossiers sont inexistants dans Squash au moment de l'import, ceux-ci sont créés par l'import.

Par exemple :

Pour le chemin: /Projet1/Dossier1/Sousdossier1/Casdetest1
Le cas de test Casdetest1 est ajouté dans le projet Projet1, dans le dossier Sousdossier1, sous-dossier de Dossier1.

Importer des cas de test avec une liste personnalisée

Si une liste personnalisée est configurée pour la nature et/ou le type des cas de test sur le projet, dans le fichier d'import, le code de l'option souhaitée est à renseigner dans la colonne "TC_NATURE" et/ou "TC_TYPE"

Par exemple :

  1. Avoir une liste personnalisée avec plusieurs options, dont une des options est "Nature2" associée au code "N2".

Page de consultation d'une liste personnalisée

  1. Dans le fichier Excel, renseigner la valeur du code de l'option dans la colonne "TC_NATURE" : ici "N2"

  2. Lorsque le fichier est importé, le cas de test est créée et le champ 'Nature' est renseigné par "Nature2"

Importer des cas de test avec des champs personnalisés

Si des champs personnalisés (CUF) sont configurés pour les cas de test du projet, dans le fichier d'import, la colonne "TC_CUF_<code du cuf>" peut être renseignée, à raison d'une colonne par champ personnalisé. L'entête de la colonne doit comporter le code du champ personnalisé présent sur sa page de consultation.

Contenu de la colonne "TC_CUF_<code du cuf>" :

Type de champ personnalisé Valeur attendue
Tag Tag1|Tag2
Case à cocher 'true' ou 'false'
Liste déroulante Libellé de l'option
Numérique Par exemple : '50', '12,8'
Date 'AAAA-MM-JJ'
Texte simple Texte avec 255 caractères maximum sans mise en forme
Texte riche Pour importer de la mise en forme, le texte doit être en HTML


Importer des cas de test avec des associations à des exigences

L'onglet "LINK_REQ_TC" du fichier d'import est à compléter avec le chemin de l'exigence, le numéro de la version ainsi que le chemin du cas de test à associer. Pour que l'association fonctionne, l'exigence doit au préalable exister dans le référentiel.

Les informations sont visibles après l'import dans l'ancre Exigences vérifiées par ce cas de test du cas de test.

Importer des pas de test

L'onglet "STEPS" permet d'importer des pas de test pour un cas de test Classique. Le numéro du pas, l'action et le résultat attendu sont renseignés dans le fichier.

Importer des pas de test pour un cas de test classique

Importer avec des paramètres et des jeux de données

Les onglets "PARAMETERS" et "DATASETS" permettent d'importer des paramètres et des jeux de données pour un cas de test. Il est également possible d'ajouter le paramètre directement dans le pas de test, via l'onglet "STEPS".

Par exemple :
Pour un cas de test de connexion à une application, il est possible d'importer les 2 paramètres "Login" et "Motdepasse", ainsi que les 3 jeux de données, correspondant à la connexion de 3 profils différents : "Admin", "Chef de projet et "Invité".

Importer un cas de test avec des paramètres et des jeux de données (partie 1)

Importer un cas de test avec des paramètres et des jeux de données (partie 2)

En savoir plus

Pour en savoir plus sur le fonctionnement des paramètres et jeux de données, consulter la page Variabiliser un cas de test classique

Importer un cas de test faisant appel à un autre cas de test

Renseigner le cas de test appelant dans l'onglet "TEST_CASES", puis dans l'onglet "STEPS" renseigner les colonnes suivantes :

  1. La colonne "TC_STEP_IS_CALL_STEP" est à valoriser par le chiffre "1" pour indiquer que ce pas de test est un appel de cas de test.
  2. La colonne "TC_STEP_ACTION" est à valoriser avec les informations suivantes "CALL <chemin du cas de test appelé>. (Par exemple : CALL /projet/dossier/ct-appelé)
  3. La colonne "TC_STEP_EXPECTED_RESULT" n'est pas à renseigner.

Info

Si le cas de test appelé n'est pas présent dans le référentiel de test, il doit être présent dans l'onglet "TEST_CASES" dans le fichier d'import .

En savoir plus

Pour en savoir plus sur le fonctionnement d'appel de cas de test, consulter la page Modulariser : Appeler un cas de test tiers.

Importer un cas de test Gherkin avec un script

Pour importer un cas de test Gherkin avec son script, des colonnes spécifiques au format Gherkin sont à renseigner, dans l'onglet "TEST_CASES":

  • Colonne "TC_KIND" : GHERKIN
  • Colonne "TC_SCRIPTING_LANGUAGE" : Le script gherkin du cas de test

Importer un cas de test gherkin avec un script

Focus

Il n'est pas possible d'importer des cas de test BDD