tcm : importation des tests automatisés dans des cas de tests
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és à 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 Planifier des tests manuels à l'aide de Team Web Access. 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 à ce sujet, 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 Automatiser des tests système
tcm.exe se trouve sous <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE sur tout ordinateur sur lequel Visual Studio Ultimate, Visual Studio Premium ou Visual Studio Test Professional est installé.
Avertissement
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 de 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 |
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 |
Facultatif. 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 |
Facultatif. 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 |
Facultatif. 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 |
Facultatif. 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 |
Facultatif. Spécifie que les méthodes de test marquées avec un attribut Ignore() sont également importées. |
/login:username,[password] |
Facultatif. 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. Pour vous connecter à Visual Studio Online, vous avez également besoin d'utiliser /allowalternatecredentials répertorié ci-dessous. |
/allowalternatecredentials |
Cet indicateur doit être spécifié en plus du paramètre /login lors de la connexion à Visual Studio Online. (Cet indicateur est uniquement disponible si vous avez Visual Studio 2013 Update 4 ou version ultérieure.) |
Vous pouvez ajouter des paramètres pour /collection et /teamproject dans le fichier XML tcm.exe.config qui est 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 commandes Visual Studio.
Pour ce faire, cliquez sur Démarrer, pointez sur Tous les programmes, sur Microsoft Visual Studio 2012, sur Visual Studio Tools , puis cliquez sur Invite de commandes développeur.
L'invite de commandes ouvre 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