tcm : importation des tests automatisés dans des cas de tests

Article
03/04/2013

Vous pouvez importer des tests automatisés, tels que des tests unitaires ou des tests codés de l'interface utilisateur, dans votre projet de test à utiliser dans le cadre d'un plan de test.Les tests sont importées à partir d'un assembly de test à l'aide de la commande tcm suivante :

tcm testcase /import

Chaque test automatisé que vous sélectionnez, selon les paramètres fournis, a un cas de test créé pour lui.Le test automatisé est automatiquement associé à ce cas de test.Vous pouvez ajouter des cas de test à une suite de tests statique à l'aide de cette commande, ou vous pouvez ajouter des cas de test à des suites de tests après leur importation.Pour plus d'informations sur la façon d'ajouter des cas de test à des suites de tests, consultez Comment : ajouter un cas de test à une suite de tests.Vous pouvez également lier ces cas de test aux spécifications, afin de consulter l'état de tests automatisés pour cette spécification.Pour plus d'informations sur la procédure à suivre, consultez Link Existing Test Cases to a Requirement.

Pour plus d'informations sur l'exécution de tests automatisés depuis un plan de test, consultez Guide essentiel de l'exécution des tests automatisés à partir d'un plan de test

tcm.exe se trouve dans <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE sur tout ordinateur sur lequel Visual Studio final, premium de Visual Studio, ou test professional Visual Studio installé.

Attention
Vous pouvez également mettre à jour des cas de test importés existants à l'aide de cette commande.Si les cas de test que vous avez sélectionnés pour une mise à jour ne comprennent pas les tests précédemment importés, seuls les cas de test sélectionnés sont mis à jour.Si vous spécifiez une suite de tests pour la synchronisation lorsque vous mettez à jour les cas de test, 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.

Vous pouvez également mettre à jour des cas de test importés existants à l'aide de cette commande.Si les cas de test que vous avez sélectionnés pour une mise à jour ne comprennent pas les tests précédemment importés, seuls les cas de test sélectionnés sont mis à jour.Si vous spécifiez une suite de tests pour la synchronisation lorsque vous mettez à jour les cas de test, 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.

tcm testcase /import /collection:CollectionURL /teamproject:project /storage:path [/maxpriority:priority] [/minpriority:priority] [/category:filter] [/syncsuite:id [/include:]] [/login:username,[password]]

Paramètres

Paramètre	Description
/collection:CollectionURL	Spécifie l'URI de la collection de projets d'équipe.Le format pour l'URI est le suivant :http://NomServeur:Port/NomRépertoireVirtuel/NomCollection Si aucun répertoire virtuel n'est utilisé, le format de l'URI est le suivant : http://NomServeur:Port/NomCollection
/teamproject:project	Le nom du projet d'équipe contenant le plan de test dans lequel vous souhaitez importer vos tests automatisés.
/storage: path	Spécifie le chemin d'accès et le nom de l'assembly de test contenant les tests automatisés que vous voulez importer.
/maxpriority:priority	Optionnel.Spécifie quels tests importer en fonction de la priorité maximale de la méthode de test.Par exemple, si le paramètre a la valeur /maxpriority:1, seuls les tests avec un attribut de priorité pour la méthode de test inférieur ou égal à 1 sont importés comme des cas de test à partir de l'assembly.
/minpriority:priority	Optionnel.Spécifie quels tests importer en fonction de la priorité minimale de la méthode de test.Par exemple, si le paramètre a la valeur /minpriority:2, seuls les tests avec un attribut de priorité pour la méthode de test supérieur ou égal à 2 sont importés comme des cas de test à partir de l'assembly.
/category:filter	Optionnel.Spécifie quels tests importer en fonction de la catégorie de chaque méthode de test dans l'assembly de test.Vous pouvez utiliser ce paramètre avec /syncsuite pour importer des tests avec une certaine catégorie dans une suite de tests spécifique. Pour plus d'informations sur les catégories de test, consultez Définition de catégories de test pour regrouper vos tests.
/syncsuite:id	Optionnel.Spécifie l'ID de la suite de tests dans votre plan de test à laquelle vous voulez ajouter les cas de test que vous importez.Cette suite ne peut pas être une suite dynamique ou une suite basée sur une requête.Si vous spécifiez une suite de tests à synchroniser pour mettre à jour les tests qui ont déjà été 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 déterminer l'ID de la suite de tests que vous voulez utiliser, vous pouvez utiliser la commande suivante afin de répertorier les suites de tests dans votre projet d'équipe : tcm suites /list Pour plus d'informations sur cette commande, consultez tcm: liste des plans de test, des suites de tests, des configurations de test et des environnements.
/include	Optionnel.Spécifie que les méthodes de test marquées avec un attribut Ignore() sont également importées.
/login:username,[password]	Optionnel.Spécifie le nom et le mot de passe d'un utilisateur qui est connecté au serveur de couche Application pour Team Foundation Server et qui dispose des autorisations d'exécution de la commande.Cette option est utilisée si vos informations d'identification Windows ne bénéficient pas des autorisations appropriées, si vous utilisez l'authentification de base ou que vous n'êtes pas connecté à un domaine.

Vous pouvez ajouter des paramètres pour /collection et /teamproject au fichier XML tcm.exe.config situé dans le même répertoire que tcm.exe : <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE.Si vous les ajoutez au fichier, vous n'avez pas à les entrer sur la ligne de commande chaque fois que vous exécutez une commande tcm.Vous pouvez ajouter ces clés et leurs valeurs dans le fichier, comme suit, dans la section appSettings :

    <appSettings>
         <add key="TeamFoundationServer" value="http://<ServerName:Port/VirtualDirectoryName/CollectionName>"/>
         <add key ="TeamProject" value="DinnerNow"/>
    </appSettings>

Importer des cas de test

Les exemples suivants supposent que vous avez démarré une invite de commande Visual Studio.

Pour cela, cliquez sur Démarrer, pointez sur Tous les programmes, sur Microsoft Visual Studio 2010, sur Visual Studio Tools, puis cliquez sur Invite de commandes de Visual Studio 10.0.

L'invite de commandes permet de naviguer vers le dossier : <drive>:\Program Files\Microsoft Visual Studio 11.0\VC

Modifiez le répertoire et accédez au dossier qui contient l'assembly construit à partir de votre projet de test.

La commande suivante importe des tests de TestProject1.dll vers le projet d'équipe DinnerNow :

tcm testcase /import /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow /storage:TestProject1.dll

La commande suivante importe uniquement les cas de test avec une priorité de 1 :

tcm testcase /import /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow /storage:TestProject1.dll /maxpriority:1

La commande suivante importe uniquement les cas de test dans les catégories SmokeTest et ShoppingCart et les ajoute à la suite de tests avec l'ID 3 :

tcm testcase /import /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow /storage:TestProject1.dll /category:"ShoppingCart&SmokeTest" /syncsuite:3

Voir aussi

Concepts

Comment : créer des cas de test à partir d'un assembly de tests automatisés avec tcm.exe

Autres ressources

tcm : importation et exécution des tests automatisés pour un plan de test à partir de la ligne de commande

Partager via