Partager via


Copier ou cloner des plans de test, des suites de test et des cas de test

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Plusieurs outils prennent en charge la copie, le clonage ou l’importation d’éléments de test tels que les plans de test, les suites de test et les cas de test. Les cas de test décrivent les étapes à suivre pour réaliser un test et valider la mise en œuvre d’une fonctionnalité ou la correction d’un bug. Les suites de tests rassemblent les cas de test, et éventuellement d’autres suites de tests, dans un ordre particulier. Les plans de test définissent un ensemble de suites de tests à exécuter pour une itération ou une version spécifique.

Chaque cas de test a été conçu dans le but de confirmer un comportement spécifique. Les cas de test peuvent appartenir à une ou plusieurs suites de tests, mais les suites de tests ne peuvent appartenir qu’à un seul et unique plan de test.

En règle générale, vous devez créer un plan de test pour chaque étape importante d’un projet. Les opérations de copie, de clonage ou d’importation d’éléments de test prennent en charge les scénarios suivants.

  • Définir un plan de test pour un nouveau sprint ou une nouvelle version sur la base d’un plan de test existant
  • Importer des suites de tests d’un plan de test vers un autre plan de test au sein d’un même projet ou d’un projet différent
  • Copier les cas de test pour les utiliser dans différentes suites de tests et différents plans de test
  • Partager des objets de test parmi les projets
  • Déplacer des objets de test d’un projet à un autre, éventuellement pour faciliter la consolidation de plusieurs projets en un seul

Pour en savoir plus, consultez Vue d’ensemble des objets de test et des termes.

Prerequisites

Category Spécifications
Niveaux d’accès - Au moins un accès de base (Basic), avec des autorisations permettant d’afficher les éléments de travail sous le chemin d’accès de la zone correspondante (Area Path).
- Pour ajouter des plans de test et des suites de tests, supprimer des artefacts de test et définir des configurations de test : accès Basique + Plans de test.
Ou, l’un des abonnements Visual Studio suivants :
- Entreprise
- Test professionnel
- Plateformes MSDN
Permissions - Pour ajouter ou modifier des plans de test, des ensembles de tests, des cas de test ou d’autres types d’éléments de travail liés aux tests : l’ensemble d’autorisations Modifier les éléments de travail dans ce nœud (Edit work items in this node) réglé sur Autoriser (Allow) sous le chemin Area Path correspondant.
- Pour modifier les propriétés d’un plan de test telles que les paramètres de build et de test : l’ensemble d’autorisations Gérer les plans de test (Manage test plans) réglé sur Autoriser (Allow) sous le chemin Area Path correspondant.
- pour créer et supprimer une suite de test, ajouter et retirer des cas de test de la suite de test, modifier les configurations de test associées à la suite de test et restructurer la hiérarchie d'une suite de test (déplacer une suite de test) : Gérer les suites de tests jeu d’autorisations défini à Autoriser sous le chemin d’accès de la zone correspondant .

Pour plus d'informations, consultez Accès manuel aux tests et permissions.

Prérequis pour l’outil en ligne de commande TCM

Category Spécifications
Outils Visual Studio 2017 Professional ou version antérieure. Accédez à TCM à partir de l'invite de commande et des répertoires suivants :
- %programfiles(x86)%\Microsoft Visual Studio\2017\Professional\Common7\IDE
- %programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE
- %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE
- Pour exécuter une commande TCM, spécifiez les paramètres /collection et /teamproject, et /login si nécessaire. Consultez également le tableau suivant des paramètres obligatoires et facultatifs.
Niveaux d’accès - Appartenance de projet valide à un ou plusieurs projets auxquels vous souhaitez accéder et les autorisations requises en fonction des commandes que vous exécutez. Pour plus d'informations, consultez Accès manuel aux tests et permissions.
- Mêmes niveaux d’accès pour l’ajout de plans de test et de suites de test pour cloner ou importer des objets de test.
Paramètre Description
/collection:CollectionURL Obligatoire. Spécifie l’URI de la collection du projet d’équipe. Le format de l’URI est le suivant :
- Pour Azure DevOps Services : http://dev.azure.com/OrganizationName
- Pour Azure DevOps Server : http://ServerName:Port/VirtualDirectoryName/CollectionName. Si aucun répertoire virtuel n’est utilisé, le format de l’URI est le suivant :http://ServerName:Port/CollectionName.
/teamproject :project Obligatoire. Nom du projet qui contient les objets de test dans lesquelles vous souhaitez cloner ou importer des tests automatisés.
/connexion:username,[password] facultatif. Spécifie le nom et le mot de passe d’un utilisateur Azure DevOps valide et qui dispose des autorisations nécessaires pour exécuter la commande. Utilisez cette option si vos informations d’identification Windows n’ont pas les autorisations appropriées, ou si vous utilisez l’authentification de base ou si vous n’êtes pas connecté à un domaine.

Outils de copie, de clonage et d’importation pris en charge

Selon la version d’Azure DevOps que vous utilisez, vous pouvez utiliser les clients ou les outils répertoriés dans la table suivante pour copier, cloner ou importer des plans de test, des suites de tests ou des cas de test.

Client/outil

Test Plans

Suites de tests

Cas de test


Portail Web1

✔️ Copier

✔️ Importer

Portail Web (Grille)

✔️ Copier-coller

Formulaire d'élément de travail

✔️ Copier

INTERFACE CLI TCM2

✔️ Clone

✔️ Clone

API REST3

✔️ Clone

✔️ Clone

Note

  1. Avec la sortie d’Azure DevOps Server 2020, le portail web pour Azure Test Plans a été considérablement mis à jour. De nombreuses nouvelles fonctionnalités ont été ajoutées pour prendre en charge la copie, le clonage, l’importation et l’exportation. Pour une vue d'ensemble, voir Naviguer dans les plans de test.
  2. L’outil de ligne de commande Test Case Management (TCM) est installé lorsque vous installez Visual Studio 2017 ou les versions antérieures. Les exemples fournis dans cet article reflètent les options disponibles dans la version Visual Studio 2017. Les versions antérieures peuvent proposer moins d’options. Pour en savoir plus, consultez Utiliser l’outil de ligne de commande TCM.
  3. Les commandes d’API REST permettant de cloner des plans de test et des suites de test ont été ajoutées dans la version 5.0, correspondant à Azure DevOps 2019.

Répertorier les plans de test ou les suites de test

Lorsque vous effectuez des opérations de copie, de clonage ou d’importation liées à des plans de test ou à des suites de tests, il est essentiel d’avoir accès à leur ID unique. Cet identifiant vous permet de cibler précisément le plan ou la suite spécifique avec lequel vous souhaitez travailler. En connaissant l’ID attribué, vous pouvez rationaliser vos processus de test et garantir une réplication ou un transfert précis des données liées aux tests.

Procédez comme suit pour générer une liste de plans de test, de suites de test ou d’autres objets de test.

  1. Sélectionnez Tableaux>Requêtes dans votre projet.
  2. Saisissez le paramètre, Work Item Type=Test Plan dans votre Éditeur de requête. Vous pouvez répertorier tous les plans de test définis pour le projet d’équipe.
  3. Cochez la case Requête sur plusieurs projets. La requête répertorie tous les plans de test définis pour l’ensemble des projets. Pour plus d’informations, veuillez consulter la section Définir une requête d’élément de travail.
  4. Exécutez la requête.

Conseil

Bien que les plans de test, les suites de test et les cas de test soient liés les uns aux autres, vous ne pouvez pas afficher ces relations par le biais d’une requête d’élément de travail. Les types de lien ne relient pas les plans de test, les suites de test et les cas de test. Seules les étapes partagées et les paramètres partagés sont associés aux cas de test. De plus, les cas de test sont reliés aux récits utilisateur ou à d’autres éléments de travail faisant l’objet des tests.

Capture d’écran de l’Éditeur de requête.

Copier ou cloner des plans de test

Lorsque vous créez un nouveau plan de test par sprint ou par version, il est utile de cloner le plan de test du cycle précédent. Avec quelques ajustements minimes, le plan de test copié devient parfaitement adapté au nouveau cycle. Cette pratique rationalise le processus de planification et assure la cohérence entre les itérations.

Le clonage s’avère particulièrement utile lorsque vous devez diviser votre application en deux versions. Après le clonage, vous pouvez modifier les tests indépendamment pour chaque version sans affecter les autres. C’est un moyen efficace de gérer les efforts de test tout en maintenant la séparation entre les différentes variantes d’une application.

Image conceptuelle, clonage du plan de test.

  1. Cliquez sur Plans de test>Plans de test, à partir de votre projet.

  2. Choisissez le plan de test que vous souhaitez copier dans la page Moi ou Tous.

  3. Cliquez sur Plus d’actions>Copier le plan de test. Cette option vous permet de copier ou cloner des plans de test au sein d’un projet.

    Capture d’écran du menu Plus d’actions du Plan de test, avec l’option copier le plan de test.

  4. Indiquez le nom du nouveau plan de test, puis cliquez sur Chemin d’accès de la zone et Chemin d’itération pour le plan.

    Capture d’écran de la boîte de dialogue Copier le plan de test.

    • Choisissez l’un ou l’autre des boutons en fonction des indications suivantes :
      • Référencer les cas de test existants : choisissez cette option si vous envisagez de fusionner les deux branches éventuellement. Dans ce cas, conservez les mêmes exigences pour les fonctionnalités déjà implémentées et testées.
      • Dupliquer les cas de test existants : sélectionnez cette option si vous souhaitez que les nouveaux cas de test soient gérés séparément. Notez que les nouveaux cas de test seront liés aux exigences existantes.

    Si vous dupliquez des cas de test existants, les cas de test copiés sont affectés au Chemin d’accès de la zone et au Chemin d’itération spécifiés pour le plan de test cloné.

    Pour plus d’informations, consultez À propos des chemins de zone et d’itération (sprint).

    La page s’actualise et affiche le plan de test qui vient d’être copié.

    Capture d’écran du plan de test copié, vue navigateur.

  5. Mettez à jour toutes les suites basées sur des requêtes que vous avez copiées afin d’utiliser les nouveaux chemins de zone et d’itération.

  6. Spécifiez une build dans le plan de test de destination si vous avez cloné des cas de test automatisés.

Importer ou cloner des suites de test

Lorsque vous créez le plan de test pour un nouveau sprint, vous souhaitez souvent répéter certains des tests des sprints précédents afin de vous assurer que les fonctionnalités que vous avez déjà implémentées fonctionnent toujours.

Image conceptuelle, suites de test de copie.

Note

  • Lorsque vous importez (Web) ou clonez (TCM) une suite de tests dans un nouveau projet, la nouvelle suite contient des copies de tous les cas de test de la suite source. Cependant, elle ne conserve aucune donnée historique telle que les tests précédents, les bogues associés ou les anciens résultats.
  • Les étapes partagées référencées par les cas de test sont également clonées et créées dans le projet de destination.
  • Vous ne pouvez pas cloner des cas de test depuis et vers le même plan de test, même dans une suite différente. Pour réaliser ce scénario, vous devez d’abord déplacer les cas de test vers un plan de test temporaire différent. Ensuite, utilisez le plan de test temporaire comme plan source et clonez les cas de test vers le plan de test source en insérant l’ID dans le plan de test de destination. Les étapes communes présentes dans les cas de test sont également dupliquées dans ce processus.

Lorsque vous travaillez avec Azure Test Plans, vous pouvez importer une suite de tests d’un plan de test vers un autre plan de test au sein du projet actuel. Peu importe que les plans de test appartiennent au même projet. Ce processus consiste à copier ou cloner la suite de tests, ce qui entraîne la création d’une nouvelle suite de tests. En outre, toutes les sous-suites de test sont également dupliquées. Les cas de test référencés par les suites de test ne sont pas dupliqués ; ils sont plutôt référencés par les suites de test clonées.

Vous pouvez utiliser tcm suites /list pour répertorier toutes les suites de test définies dans un projet.

Pour utiliser les mêmes cas de test dans différentes suites et plans, copiez et collez des cas de test en utilisant la vue Grille.

  1. Cliquez sur Plans de test>Plans de test.

  2. Sélectionnez le plan de test où vous souhaitez importer une suite de tests à partir de la page Explorer ou Tous.

  3. Cliquez sur Plus d’actions>Copier le plan de test. Cette option vous permet de copier ou cloner des plans de test au sein d’un projet.

    Capture d’écran du menu Autres actions dans Suite de tests, avec l’option Importer des suites de test.

  4. Dans la boîte de dialogue qui s’ouvre, sélectionnez le projet si le plan de test se trouve dans un autre projet. Sinon, entrez le nom ou l’ID du plan de test et le nom ou l’ID de la suite de tests. Vous pouvez aussi sélectionner le nom ou l’ID dans les menus déroulants.

  5. Créez l’importation. Vous ne pouvez importer qu’une seule suite à la fois à partir d’un plan de test.

    Capture d’écran de la boîte de dialogue Importer des suites à partir d’un plan de test.

    Le message suivant s’affiche :

    à vous l'haver OKCapture d'écran montrant le message initié par les suites d'importation.

  6. Une fois l’opération d’importation terminée, le message suivant s’affiche. Cliquez sur Actualiser pour actualiser votre navigateur.

    Capture d’écran montrant le message Importation des suites terminées.

    La suite de tests qui vient d’être ajoutée s’affiche.

    Capture d’écran de la suite de tests importée.

Copier le cas de test

À partir du portail Web, vous pouvez copier des cas de test d’un projet ou d’un autre projet vers une suite de tests, ou vous pouvez utiliser la vue Grille pour copier et coller des cas de test d’une suite à une autre. Si vous le souhaitez, vous pouvez importer et exporter en bloc des cas de test.

Conseil

Ne copiez pas les cas de test si vous souhaitez effectuer des tests en utilisant différentes configurations ou différentes données.

Vous pouvez copier des cas de test à partir d’un projet ou d’un autre projet au sein de l’organisation ou de la collection. De plus, vous pouvez choisir d’inclure tous les liens et pièces jointes lors du processus de copie.

  1. Cliquez sur Plans de test>Plans de test.

  2. Sélectionnez le plan de test qui contient un ou plusieurs cas de test que vous souhaitez copier à partir de la page Explorer ou Tous.

  3. Sélectionnez la suite de tests qui contient un ou plusieurs cas de test et que vous souhaitez copier.

  4. Sur la page Définir, cochez les cases de tous les cas de test que vous souhaitez copier.

  5. Cliquez sur Plus d’actions>Copier le cas de test.

    Capture d’écran du menu Autres actions des Cas de test, avec l’option Copier des cas de test.

  6. Sélectionnez le projet dans le menu déroulant, puis saisissez le nom ou l’ID du plan de test et le nom ou l’ID de la suite de tests. Vous pouvez aussi sélectionner le nom ou l’ID dans les menus déroulants.

    Capture d’écran de la boîte de dialogue Copier les cas de test.

  7. (Facultatif) Cochez les cases inclure les liens existants et Inclure des pièces jointes existantes.

  8. Créez la copie.

    La copie en arrière-plan dépend de la quantité et de la complexité des cas de test sélectionnés. Une fois l’opération terminée, vous recevez une notification confirmant la réussite de l’opération et un lien vers la suite de tests où se trouvent les cas de test copiés.

Copier et coller le cas de test (mode Grille)

Lorsque vous gérez des cas de test, le copier-coller est une technique très utile pour réutiliser les mêmes tests dans différentes suites et différents plans. Prenons par exemple le cas où vous disposez d’une suite de tests complète et que vous souhaitez créer un sous-ensemble de tests plus ciblé au sein d’une autre suite. La vue Définir>Grille permet à la fois de modifier les cas de test et de les copier dans différentes suites de tests. Pour en savoir plus, consultez Créer des cas de test, utiliser la vue Grille pour modifier les cas de test.

Conseil

Ne copiez pas les cas de test si vous souhaitez effectuer des tests en utilisant différentes configurations ou différentes données.

Dans les navigateurs Internet Explorer, Microsoft Edge ou Chrome, vous pouvez copier des cas de test depuis la vue Grille d’un plan de test et d’une suite de tests vers un autre plan de test et une autre suite de tests.

  1. Sur la page Plans de test>Plans de test choisissez la suite de tests contenant un ou plusieurs cas de test que vous souhaitez copier. Dans l'onglet Définir, sélectionnez Vue de la grille.

  2. Mettez en surbrillance les lignes que vous souhaitez copier, puis utilisez la combinaison de touches CTRL+C.

    Capture d’écran montrant Copier les cas de test à partir de la vue Grille.

  3. Sélectionnez une autre suite de tests dans le même plan ou dans un autre plan, puis collez-la en utilisant la combinaison de touches Ctrl+V. Si vous ne sélectionnez pas une autre suite, rien ne se passe lorsque vous collez, car chaque suite ne peut avoir qu’une seule référence à un cas de test.

  4. Sélectionnez Enregistrer les cas de test.

    Les nouveaux cas de test sont enregistrés avec les nouveaux ID assignés.

    Capture d’écran des cas de test enregistrés et collés dans la vue Grille.

Cas de test d’importation ou d’exportation en bloc

Depuis le portail Web, vous pouvez importer ou exporter en masse des cas de test depuis/vers une suite de tests. Les cas de test sont définis dans un fichier CSV (valeurs séparées par des virgules).

Exporter des cas de test

  1. Sur la page Plans de test>Plans de test, sélectionnez le plan de test et la suite de tests contenant les cas de tests à exporter.

  2. facultatif. Sélectionnez Options de colonne pour ajouter les champs à inclure dans le fichier de téléchargement.

  3. Pour exporter tous les cas de test pour la suite de tests, sélectionnez Exporter des cas de test au format CSV.

    Capture d'écran des cas de test d'exportation de la suite de tests sélectionnée.

    Pour exporter un sous-ensemble de cas de test pour la suite de tests, choisissez les cas de test à exporter, puis Plus d’options et sélectionnez Exporter les cas de test au format CSV.

    Capture d’écran des cas de test sélectionnés, avec l’option Exporter des cas de test au format CSV.

  4. Le fichier CSV exporté figure alors dans votre dossier Téléchargements.

Importer des cas de test

  1. Dans Plans de test>Plans de test, sélectionnez le plan de test avec la suite de tests dans laquelle vous souhaitez importer des cas de test.

    Capture d’écran de l’importation des cas de test vers la suite de test sélectionnée.

  2. Choisissez le fichier à importer dans la boîte de dialogue qui s’ouvre, puis sélectionnez Importer.

    Capture d’écran de la boîte de dialogue Importer des cas de test.

  3. Sélectionnez Confirmer. Si vous spécifiez des cas de test déjà définis dans la suite de tests, certains éléments risquent d'être écrasés lors de l'importation.

Importer des cas de test automatisés (TCM)

Pour importer des cas de test automatisés dans une suite de tests, utilisez tcm testcase /import. Vous devez spécifier un fichier.dll pour l’assemblage de tests qui contient vos tests.

tcm testcase /import /collection:teamprojectcollectionurl /teamproject:project
             /storage:path
             [/maxpriority:priority]
             [/minpriority:priority]
             [/category:filter]
             [/syncsuite:id [/include]]
             [/login:username,[password]]
Paramètre Description
/storage :path Indique le chemin d’accès et le nom de l’assemblage de tests qui contient les tests automatisés que vous souhaitez importer.
/maxpriority :priority facultatif. Indique les tests à importer en fonction de la priorité maximale de la méthode de test. Par exemple, si le paramètre est défini sur /maxpriority:1, seuls les tests dont l’attribut de priorité pour la méthode de test est inférieur ou égal à 1 sont importés comme cas de test à partir de l’assemblage.
/minpriority :priority facultatif. Indique les tests à importer en fonction de la priorité minimale de la méthode de test. Par exemple, si le paramètre est défini sur /minpriority:2, seuls les tests dont l’attribut de priorité pour la méthode de test est égal ou supérieur à 2 sont importés comme cas de test à partir de l’assemblage.
/category :filter facultatif. Spécifie les tests à importer selon la catégorie de chaque méthode de test dans l’assemblage de test. Vous pouvez utiliser ce paramètre avec /syncsuite afin d’importer des tests d’une certaine catégorie dans une suite de tests spécifique.
Pour en savoir plus sur les catégories de test, consultez Exécuter des tests unitaires avec l’Explorateur de tests.
/syncsuite :id facultatif. Spécifie l’ID de la suite de tests dans votre plan de test à laquelle vous souhaitez ajouter les cas de test que vous importez. Cette suite ne peut pas être une suite dynamique ou une suite basée sur des requêtes. Si vous spécifiez une suite de tests à synchroniser afin de mettre à jour les tests ajoutés, les tests qui ne sont pas importés sont supprimés de la suite de tests, mais pas du plan de test lui-même.

Pour des descriptions des paramètres /collection, /teamproject et /login, consultez Utilisation de l'outil en ligne de commande TCM.

Limitations

  • La colonne d’état du cas de test doit indiquer l’état Conception.
  • La longueur du titre du cas de test ne doit pas dépasser les 128 caractères.
  • Il existe une limite de 20 Mo sur les objets JSON créés durant l’importation et de l’exportation. En cas d’échec de l’importation, essayez de réaliser l’opération avec un petit sous-ensemble des cas de test.
  • L'utilisateur qui effectue l'importation doit avoir des permissions sur le domaine et les chemins d'itération pour le plan de test et la suite de tests qu'il prévoit d'importer ou d'exporter.
  • Les opérations Copier et Importer échouent si le nombre de liens associé dépasse 1 000 pour le cas de test.

API REST

Vous pouvez copier et cloner des plans de test et des suites de test avec les API REST suivantes.

Étapes suivantes