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é.

Onglet LINK_REQ_TC

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"

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.

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".

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 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é".

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

Focus

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