tcm : exécution des tests à partir d'un plan de test à l'aide de l'utilitaire de ligne de commande
Vous pouvez exécuter des 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 afin que vous puissiez 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 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 /abort
tcm run /delete
tcm run /export
tcm run /publish
tcm.exe est situé dans <Drive:>\Program Files\Microsoft Visual Studio 10.0\Common7\IDE sur tout ordinateur doté de Visual Studio Ultimate.
Pour plus d'informations sur l'importation de tests automatisés dans votre projet de test et la configuration de votre plan de test pour l'exécution de ces tests, consultez Création de cas de test à partir d'un assembly de tests automatisés et Comment : exécuter des cas de test avec l'automation à 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 /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 du projet 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. |
/title: title |
Spécifie le titre que vous voulez utiliser pour la série que vous créez ou si vous publiez un fichier 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. Par exemple, si vous souhaitez exécuter plusieurs suites de tests, vous pouvez utiliser la syntaxe suivante dans le cadre de la commande tcm /suiteid:2 /suiteid:3. Elle peut aussi spécifier la série de tests à utiliser lorsque vous publiez une série de tests. .gif "Remarque") Remarque
Pour trouver l'ID de suite, vous pouvez répertorier les suites de tests pour 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.
|
/configid:configid |
Spécifie quelles configurations de test vous souhaitez exécuter pour vos suites de tests. Par exemple, si vous souhaitez exécuter plusieurs configurations de test, vous pouvez utiliser la syntaxe suivante dans le cadre de la commande tcm /configid:2 /configid:3. Elle peut aussi spécifier la configuration de test à utiliser lorsque vous publiez une série de tests. |
/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. |
/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 ce n'est pas spécifié, l'emplacement de la build 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. |
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 10.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 de tests et gestion des séries de tests
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 (2010).
L'invite de commandes permet de naviguer vers le dossier : <drive>:\Program Files\Microsoft Visual Studio 10.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 procédure à suivre, 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 Comment : exécuter des cas de test avec l'automation à 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 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
Autres ressources
tcm: liste des plans de test, des suites de tests, des configurations de test et des environnements