tcm : exécution des tests à partir d'un plan de test à l'aide de l'utilitaire de ligne de commande
Vous pouvez exécuter les tests automatisés qui font partie d'un plan de test à partir de la ligne de commande. Cela vous permet de démarrer une série de tests à l'aide d'un fichier batch, grâce auquel vous pouvez planifier une série. Vous pouvez également gérer les séries de tests à partir de la ligne de commande. Si vous voulez exporter une série de tests afin qu'un développeur puisse visualiser les résultats des tests à l'aide de Visual Studio, vous pouvez utiliser tcm pour ce faire. Vous pouvez également publier les résultats de la série de tests à partir d'un fichier de série de tests (.trk) Visual Studio à l'aide de tcm. Vous pouvez spécifier les résultats de ce fichier de série de tests que vous souhaitez publier dans votre plan de test. Vous pouvez utiliser les commandes tcm suivantes pour accomplir ces tâches :
tcm run /create
tcm run /list
tcm run /execute
tcm run /abort
tcm run /delete
tcm run /export
tcm run /publish
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é.
Pour plus d'informations sur l'importation des tests automatisés dans votre projet de test et configurer votre plan de test pour exécuter ces tests, consultez Create Test Cases from an Assembly of Automated Tests et Exécuter des tests automatisés à partir de la ligne de commande à l'aide de tcm.
tcm run /create /title:title /planid: id /collection:CollectionURL /teamproject:project (suiteid:id /configid:configid | /querytext: query) [/settingsname:name] [/owner:owner] [/builddir:directory] [/testenvironment:name] [/login:username,[password]] [/include]
tcm run /execute /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm run /list [/planid:id | /querytext: query] /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm run /abort /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm run /delete /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]] [/noprompt]
tcm run /export /id:id /resultsfile:path /collection:CollectionURL /teamproject:project [/login:username,[password]] [/attachment:attachmentname]
tcm run /publish /suiteid:id /configid:id /resultowner:owner /resultsfile:path /collection:CollectionURL /teamproject:project [/title: runtitle] [/runowner:owner] [/build:buildnumber /builddefinition:builddefinition] [/flavor:flavor [/platform:platform] [/assignfailurestouser:user] [/login:username,[password]] [/buildverification]
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. |
/title: title |
Spécifie le titre que vous voulez utiliser pour la série que vous créez ou si vous publiez un fichier de série de tests. |
/planid:id |
Spécifie le plan contenant les tests que vous voulez exécuter ou le plan associé aux séries de tests que vous voulez répertorier. |
/suiteid:id |
Spécifie les suites de tests que vous souhaitez exécuter. Peut aussi spécifier la série de tests à utiliser lorsque vous publiez une série de tests. Notes Pour trouver l'ID de suite, vous pouvez répertorier les suites de tests d'un plan de test.Pour plus d'informations, consultez tcm: liste des plans de test, des suites de tests, des configurations de test et des environnements. Conseil Pour exécuter plusieurs suites de tests, vous pouvez utiliser le paramètre /querytext. |
/configid:configid |
Spécifie quelles configurations de test vous souhaitez exécuter pour vos suites de tests. Peut aussi spécifier la configuration de test à utiliser lorsque vous publiez une série de tests. Conseil Pour exécuter plusieurs configurations de tests, vous pouvez utiliser le paramètre /querytext. |
/querytext:query |
Spécifie la requête à utiliser pour retourner les séries de tests ou la requête à utiliser pour sélectionner les tests à exécuter. Conseil Vous pouvez utiliser le paramètre /querytext pour exécuter plus d'une suite de tests.Par exemple : querytext:“SELECT * FROM TestPoint WHERE (ConfigurationId=20 OR ConfigurationId=21) AND (Suiteid=1185 OR Suiteid=1186)” |
/settingsname:name |
Facultatif. Spécifie les paramètres de test que vous souhaitez utiliser pour cette série de tests. Si vous ne sélectionnez pas les paramètres de test avec ce paramètre, les paramètres de test par défaut pour les tests automatisés dans le plan de test sont utilisés. |
/owner:owner |
Facultatif. Spécifie le propriétaire de la série de tests. |
/runowner:owner |
Facultatif. Spécifie le propriétaire de la série de tests. |
/builddir:directory |
Facultatif. Spécifie le répertoire de build permettant de localiser les assemblys de tests pour le test automatisé. Si le répertoire n'est pas spécifié, c'est l'emplacement de la build qui est utilisé, en fonction de la build actuellement affectée au plan de test. |
/testenvironment:name |
Facultatif. Spécifie l'environnement de test que vous souhaitez utiliser pour cette série de tests. Si vous ne sélectionnez pas un environnement de test avec ce paramètre, l'environnement de test par défaut pour les tests automatisés dans le plan de test est utilisé. |
/id:id |
Spécifie l'ID de série que vous souhaitez supprimer, interrompre ou exporter. |
/resultsfile:path |
Spécifie l'emplacement à utiliser pour exporter une série de tests ou rechercher la série de tests afin de la publier. Par exemple : "c:\temp\ResultsForDeveloper.trx". |
/attachment:attachmentname |
Spécifie le nom de la pièce jointe pour une série de tests que vous exportez. |
/resultowner:owner |
Spécifie le propriétaire des résultats des tests. |
/build:buildnumber |
Facultatif. Spécifie le numéro de build à utiliser pour publier une série de tests. Ce paramètre doit être utilisé avec /builddefinition. |
/builddefinition:builddefinition |
Facultatif. Spécifie la définition de build à utiliser pour publier une série de tests. Ce paramètre doit être utilisé avec /build. |
/flavor:flavor |
Facultatif. Spécifie la version de la build. Par exemple, Release. Ce paramètre peut uniquement être utilisé si le paramètre /build est utilisé. |
/platform:platform |
Facultatif. Spécifie la plateforme de génération. Par exemple, x86. Ce paramètre peut uniquement être utilisé si le paramètre /build est utilisé. |
/assignfailurestouser:user |
Facultatif. Spécifie à qui attribuer tout test ayant échoué dans la série de tests. |
/buildverification |
Facultatif. Spécifie que cette série de tests contient des tests de vérification de build qui contrôlent les fonctionnalités de base de votre build. |
/include |
Facultatif. Spécifie que tous les tests qui sont sélectionnés pour la série de tests sont inclus, même si les tests n'ont pas actuellement l'état Actif. |
/noprompt |
Facultatif. Spécifie que l'utilisateur n'est pas invité à confirmer la suppression d'une série de tests. |
/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>
Exécution des tests et gestion des séries de tests
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.
Important
Pour exécuter des tests automatisés à partir de la ligne de commande à l'aide de tcm.exe, vos cas de test doivent être associés à vos tests automatisés.Vous devez également configurer votre plan de test correctement afin d'utiliser une build pour localiser les tests automatisés à exécuter si vous ne spécifiez pas les informations de build sur la ligne de commande.Pour plus d'informations sur la manière de procéder, consultez Comment : créer des cas de test à partir d'un assembly de tests automatisés avec tcm.exe.
Pour obtenir les ID nécessaires pour les commandes suivantes, vous devrez peut-être utiliser tcm afin de répertorier les artefacts de test et leurs ID. Pour plus d'informations sur la manière de procéder, consultez tcm: liste des plans de test, des suites de tests, des configurations de test et des environnements et Exécuter des tests automatisés à partir de la ligne de commande à l'aide de tcm.
La commande suivante exécute des tests à l'aide d'une requête de point de test :
tcm run /create /title:"Nightly Run" /planid:1 /querytext:"SELECT * FROM TestPoint WHERE ConfigurationId=13" /settingsname:"<Name of your automated test settings>" /testenvironment:"<Name of a matching environment>" /collection:<CollectionURL> /teamproject:<Team Project name>
La commande suivante exécute des tests à l'aide d'une configuration et d'une suite de tests spécifiques :
tcm run /create /title:"Nightly Run" /planid:1 /suiteid:5 /configid:13 /settingsname:"<Name of your automated test settings>" /testenvironment:"<Name of a matching environment>" /collection:<CollectionURL> /teamproject:<Team Project name>
La commande suivante exécute les tests à l'aide d'un ID spécifique :
Tcm run /execute /id:1207 /collection:<CollectionURL> /teamproject:<Team Project name>
La commande suivante répertorie les séries de tests pour un plan de test spécifique :
tcm run /list /planid:1 /collection:<CollectionURL> /teamproject:<Team Project name>
La commande suivante supprime une série de tests spécifique :
tcm run /delete /id:1009 /collection:<CollectionURL> /teamproject:<Team Project name>
La commande suivante exporte une série de tests vers un fichier .trx :
tcm run /export /id:1273 /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>
La commande suivante publie une série de tests pour une suite de tests et une configuration de test spécifiques, et réaffecte le propriétaire. Cela met à jour les points de test existants pour les cas de test dans la suite de tests associée à cette configuration, avec les résultats dans le fichier .trk :
tcm run /publish /suiteid:5 /configid:13 /resultowner:"<Name of new owner>" /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>
Voir aussi
Référence
tcm: liste des plans de test, des suites de tests, des configurations de test et des environnements