Aller au contenu

Importer des exigences

Squash permet d’importer une arborescence d'exigences depuis un fichier au format .xls.

Pour réaliser cet import, il faut renseigner un fichier Excel en respectant les recommandations faites dans Renseigner un fichier d'import d'exigences puis l'importer via l'option [Importer] de l'espace Exigences. 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/Exporter un objet.

Renseigner un fichier d’import d’exigences

L'import d'exigences via un fichier Excel permet de créer ou modifier un patrimoine d'exigences en masse. Il est possible d'importer des exigences, leurs attributs ainsi que leurs associations (exigences et cas de test). Cette fonctionnalité est très utile :

  • lors d'une migration depuis un outil tiers
  • pour récupérer un patrimoine de spécifications existant dans un document
  • pour effectuer des modifications en masse sur les exigences présentes dans Squash

Squash permet d'importer une arborescence d'exigences depuis un fichier au format .xls, .xlsx ou .xlsm.

Info

L'import est réservé aux profils "Administrateur" et "Chef de projet".
Un gabarit d'import est téléchargeable depuis la popup d'import dans l'espace Exigences.

Structure du fichier d'import

Le fichier d'import comprend trois onglets : REQUIREMENT, LINK_REQ_TC et LINK_REQ_REQ

  • L'onglet REQUIREMENT permet de remplir les informations liées aux exigences à importer comme l'emplacement, la description, la criticité, etc.
  • L'onglet LINK_REQ_TC renseigne les informations pour associer les exigences à des cas de test déjà présents dans Squash.
  • L’onglet LINK_REQ_REQ renseigne les informations pour lier des versions d’exigences entre elles (soit déjà présentes dans Squash, soit présentes dans le fichier d'import)

Focus

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

  • Le nom des 3 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 REQUIREMENT

Nom de la colonne Description Valeur attendue
ACTION Valeur qui indique l'action que l'on souhaite effectuer. Champ Obligatoire
C : pour la création (Create)
U : pour la mise à jour (Update)
REQ_PATH Chemin de l’exigence. Il commence par « /nom du projet » et se termine par le nom de l’exigence (= nom de la version courante, soit la dernière version). Il inclut le nom du projet car l’import est multi-projet. Champ Obligatoire
Par exemple :
- /projet/dossier/exigence
- /projet/exiMère/exiFille
REQ_VERSION_NUM Numéro de version de l’exigence.
Mode CREATE : Si le champ n’est pas renseigné, deux cas possibles :
- Il n’y a qu’une version d’exigence avec ce REQ_PATH, alors REQ_VERSION_NUM=1.
- Il y a plusieurs versions d’exigences avec le même REQ_PATH, alors les versions sont numérotées dans l’ordre d’apparition à partir de 1.
Mode UPDATE : ce champ permet d’identifier la version à mettre à jour.
Mode CREATE : Champ facultatif.
Mode UPDATE : Champ obligatoire
REQ_VERSION_REFERENCE Référence de la version de l’exigence
REQ_VERSION_NAME Nom de la version d’exigence.
- Mode CREATE : Ce champ est facultatif car indiqué à la fin du chemin dans la colonne REQ_PATH.
- Mode UPDATE : permet de renommer une exigence
REQ_VERSION_CRITICALITY Code de la criticité de l’exigence - CRITICAL (Critique)
- MAJOR (Majeure)
- MINOR (Mineure)
- UNDEFINED (Non définie) [Valeur par défaut]
REQ_VERSION_CATEGORY Code de la catégorie de l’exigence.
La liste peut être celle par défaut ou être une liste personnalisée. A l’import, si la valeur n’est pas renseignée ou non reconnue, la valeur par défaut est affectée.
- CAT_FUNCTIONAL (Fonctionnelle)
- CAT_NON_FUNCTIONAL (Non fonctionnelle)
- CAT_USE_CASE (Cas d'utilisation)
- CAT_BUSINESS (Métier)
- CAT_TEST_REQUIREMENT (Exigence de test)
- CAT_UNDEFINED (Non définie) [Valeur par défaut]
- CAT_ERGONOMIC (Ergonomique)
- CAT_PERFORMANCE (Performance)
- CAT_TECHNICAL (Technique)
- CAT_USER_STORY (User story)
- CAT_SECURITY (Sécurité)
REQ_VERSION_STATUS Code du statut de l’exigence - APPROVED (Approuvée)
- OBSOLETE (Obsolète)
- UNDER_REVIEW (À approuver)
- WORK_IN_PROGRESS (En cours de rédaction) [Valeur par défaut]
REQ_VERSION_DESCRIPTION Description de l’exigence
REQ_VERSION_CREATED_ON Date de création de l’exigence.
La date doit être renseignée 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 de l'import est prise en compte.
REQ_VERSION__CREATED_BY Login du créateur. Si non renseigné, c'est le login de l’utilisateur qui réalise l’import qui est utilisé.
REQ_VERSION_MILESTONE Intitulé du ou des Jalon(s) associé(s) à cette exigence.
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 une exigence est associée à deux jalons :
Jalon1 | Jalon 2
REQ_VERSION_CUF_<code du cuf> Une colonne par champ personnalisé.
Dans l'en-tête, remplacer \<code du cuf> par le code du champ personnalisé.
Valeur associée au champ personnalisé

Si vous souhaitez faire des associations entre les exigences et des cas de test présents 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

Si vous souhaitez faire des associations entre exigences, les 5 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
RELATED_REQ_PATH Chemin de l'exigence liée 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/nom_exigence_version_courante
RELATED_REQ_VERSION_NUM Numéro de la version de l’exigence liée
RELATED_REQ_ROLE La valeur du champ code rôle pour le lien entre les exigences Par exemple :
pour lier une Exigence A (PARENT) à une Exigence B (CHILD) avec le rôle Parent-Enfant, saisir le rôle de l'exigence B : CHILD

Importer des exigences

L'import permet de créer des exigences avec toutes les fonctionnalités disponibles de l'espace Exigences :

Créer une arborescence d'exigences

L'arborescence est très importante car elle permet d'organiser le référentiel d'exigences. L'import offre la possibilité de créer une arborescence précise des éléments à importer et ce dans plusieurs projets à la fois : Exigences, Dossiers, Exigences mères et filles, etc.

Importer une arborescence d'exigences

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/ExigenceMère/ExigenceFille :

  • Si l’exigence ExigenceMère est présente dans le référentiel, ExigenceFille est ajoutée sous l'exigence mère ExigenceMère.
  • Si l’exigence mère n’existe pas dans le référentiel mais est présente dans le fichier d’import AVANT l'exigence fille, ExigenceFille est ajoutée sous l'exigence mère ExigenceMère.
  • Si l’exigence mère n’existe pas dans le référentiel, n’est pas présente dans le fichier d’import ou présente après l'exigence fille, alors l’exigence ExigenceFille est ajoutée dans le dossier ExigenceMère, sous-dossier de Dossier1.

Importer des versions d'exigences

Pour créer plusieurs versions d'une même exigence, il faut une ligne par version dans le fichier Excel. Le numéro de la version à créer est à renseigner dans la colonne "REQ_VERSION_NUM".

Focus

Pour créer la version 3 d'une exigence, une version 2 dans le fichier d'import ou dans le référentiel doit impérativement être présente

Importer des versions d'exigence

Pour modifier les attributs d'une version d'exigence, la colonne "REQ_VERSION_NUM" doit être renseignée avec le numéro de la version à modifier et la colonne "REQ_PATH" avec le chemin de la version courante de l'exigence.

Mettre à jour des exigences via l'import

Importer des exigences avec une liste personnalisée

Si une liste personnalisée est configurée pour la catégorie des exigences sur le projet, dans le fichier d'import, le code de l'option souhaitée sera à renseigner dans la colonne "REQ_VERSION_CATEGORY".

Par exemple :

  1. Avoir une liste personnalisée avec plusieurs options, dont une des options est "Option2" associée au code "Opt2".
    Page de consultation d'une liste personnalisée
  2. Dans le fichier Excel, renseigner la valeur du code de l'option dans la colonne "REQ_VERSION_CATEGORY" : ici "Opt2"

  3. Lorsque le fichier est importé, l'exigence est créée et le champ 'Catégorie' est renseigné par "Option2"

Importer des exigences avec des champs personnalisés

Si des champs personnalisés (CUF) sont configurés pour les exigences du projet, dans le fichier d'import, la colonne "REQ_VERSION_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 "REQ_VERSION_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 exigences avec des associations à des cas de test

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, le cas de test doit au préalable exister dans le référentiel.

Les informations sont visibles après l'import dans l'ancre 'Cas de test vérifiant cette exigence' de l'exigence.

Importer des exigences avec des associations à des exigences

L'onglet "LINK_REQ_REQ" du fichier d'import est à compléter avec les chemins des deux exigences à lier ainsi que leur numéro de version. Le code du type de lien sera également à renseigner. Pour que l'association fonctionne, l'exigence à lier doit au préalable exister dans le référentiel ou être présente dans le fichier d'import.

Les informations sont visibles après l'import dans l'ancre 'Exigences liées' de l'exigence.