tcm: Spouštění testů z testovacího plánu pomocí nástroje příkazového řádku
Publikováno: duben 2016
Automatizované testy, které jsou součástí plánu testů, můžete spustit z příkazového řádku. To umožňuje zahájit spuštění testování pomocí dávkového souboru, takže můžete spuštění naplánovat. Testy můžete také spravovat z příkazového řádku. Pokud chcete exportovat zkušební spuštění tak, aby vývojář mohl zobrazit výsledky testu pomocí Visual Studio, můžete k tomuto účelu použít tcm. Můžete také publikovat výsledky testů ze souboru testu Visual Studio (.trx) pomocí příkazu tcm. Můžete určit, jaké výsledky z tohoto souboru testů chcete publikovat zpět ve vašem plánu testování. Následující příkazy tcm můžete použít k provedení následujících úkolů:
tcm run /create
tcm run /list
tcm run /execute
tcm run /abort
tcm run /delete
tcm run /export
tcm run /publish
TCM.exe je umístěn v <Drive:>\Program Files\Microsoft Visual Studio <version>\Common7\IDE na libovolném počítači, který má Visual Studio Enterprise nebo Visual Studio Test Professional.
Další informace o tom, jak naimportovat do projektu testování automatizovaných testů a nastavit testovací plán pro spuštění tyto testy naleznete v tématu vytvořit testovací případy z sestavení automatizovaných testů a Spuštění automatizovaných testů z příkazového řádku pomocí TCM.
Syntaxe
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]
Parametry
Parametr |
Popis |
|---|---|
/collection:CollectionURL |
Určuje URI kolekce týmového projektu. Formát pro identifikátor URI je následující: http://název_serveru: port/název_virtuálního_adresáře/CollectionName Pokud není použit žádný virtuální adresář, formát identifikátoru URI je následující: http://Název_serveru: port / CollectionName |
/teamproject:project |
Název týmového projektu, který obsahuje testovací plán, který chcete naimportovat do automatizovaných testů. |
/title: title |
Určuje název, který chcete použít pro běh, který vytvoříte, nebo pokud publikujete soubor testovacích běhů. |
/planid:id |
Určuje plán, který obsahuje testy, které chcete spustit, nebo plán, který je přidružen k testovacímu běhu, který chcete uvést v seznamu. |
/suiteid:id |
Určuje testovací sady, které chcete spustit. Můžete také zadat testovací sadu pro použití při publikování testovacího běhu. Poznámka Chcete-li najít id sady, můžete vytvořit seznam testovacích sad pro testovací plán.Další informace naleznete v tématu tcm: Výpis testovacích plánů, testovacích sad, konfigurací testů a prostředí. Tip Chcete-li spustit více než jednu testovací sadu, můžete použít parametr /querytext. |
/configid:configid |
Určuje kterou testovací konfiguraci chcete spustit pro vaše testovací sady. Můžete také zadat konfiguraci testu pro použití při publikování testovacího běhu. Tip Pro spuštění více než jedné testovací konfigurace můžete použít parametr /querytext. |
/querytext:query |
Určuje dotaz, který se má použít k vrácení testovacích běhů, nebo dotaz pro výběr testů, které chcete spustit. Tip Chcete-li spustit více než jednu testovací sadu, můžete použít parametr /querytest.Příklad: querytext:“SELECT * FROM TestPoint WHERE (ConfigurationId=20 OR ConfigurationId=21) AND (Suiteid=1185 OR Suiteid=1186)” |
/settingsname:name |
Volitelné. Určuje nastavení testů, které chcete použít pro tento testovací běh. Pokud nevyberete nastavení testovaní s tímto parametrem, použije se v použitém plánu testování výchozí testovací nastavení pro automatizované testy. |
/owner:owner |
Volitelné. Určuje vlastníka testovacího běhu. |
/runowner:owner |
Volitelné. Určuje vlastníka testovacího běhu. |
/builddir:directory |
Volitelné. Určuje adresář sestavení, který má být použit k vyhledání sestavení testů pro automatizované testování. Pokud není tento parametr zadán, použije se umístění sestavení v závislosti sestavení, které je aktuálně přidruženo k plánu testování. |
/testenvironment:name |
Volitelné. Určuje testovací prostředí, které chcete použít pro tento testovací běh. Pokud nevyberete testovací prostředí s tímto parametrem, použije se v použitém plánu testování výchozí testovací prostředí pro automatizované testy. |
/id:id |
Určuje ID běhu, který chcete odstranit, zrušit nebo exportovat. |
/resultsfile:path |
Určuje umístění pro export testovacího běhu nebo k vyhledání testovacího běhu za účelem publikování. Například "c:\temp\ResultsForDeveloper.trx". |
/attachment:attachmentname |
Určuje název přílohy pro testovací běh, který chcete vyexportovat. |
/resultowner:owner |
Určuje vlastníka pro výsledky testů. |
/build:buildnumber |
Volitelné. Určuje číslo sestavení, které má být použito k publikování běhu testu. Tento parametr je nutné použít s /builddefinition. |
/builddefinition:builddefinition |
Volitelné. Určuje definici sestavení, která má být použita k publikování běhu testu. Tento parametr je nutné použít s /build. |
/flavor:flavor |
Volitelné. Určuje charakter sestavení. Například verze. Tento parametr lze použít pouze v případě, že je používán parametr /build. |
/platform:platform |
Volitelné. Určuje platformu sestavení. Například, x86. Tento parametr lze použít pouze v případě, že je používán parametr /build. |
/assignfailurestouser:user |
Volitelné. Určuje, komu chcete přiřadit všechny neúspěšné testy v testovacím běhu. |
/buildverification |
Volitelné. Určuje, zda tento test obsahuje testy ověření sestavení, které kontrolují základní funkce sestavení. |
/include |
Volitelné. Určuje, že všechny testy, které jsou vybrány pro testovací běh, jsou zahrnuty i v případě, že testy nejsou aktuálně nastaveny do stavu Aktivní. |
/noprompt |
Volitelné. Určuje, že uživatel není vyzván k potvrzení odstranění testovacího běhu. |
/login:username,[password] |
Volitelné. Určuje název a heslo uživatele, který je přihlášen na server aplikační vrstvy pro Team Foundation Server a který má oprávnění ke spuštění příkazu. Tuto možnost byste použili, pokud pověření systému Windows nemá příslušné oprávnění nebo používáte základní ověřování nebo nejste připojeni k doméně. Chcete-li se přihlásit ke službě Visual Studio Online, je také nutné použít /allowalternatecredentials níže. |
/allowalternatecredentials |
Tento příznak musí být zadán kromě /login parametr při připojování ke službě Visual Studio Online. (Tento příznak slouží pouze k dispozici, pokud máte Visual Studio 2013 Update 4 nebo vyšší.) |
Můžete přidat parametry pro /collection a /teamproject na tcm.exe.config soubor XML, který je umístěn ve stejném adresáři jako tcm.exe: <Drive:>\Program Files\Microsoft Visual Studio <version>\Common7\IDE. Pokud je chcete přidat do souboru, nemusíte je zadávat do příkazového řádku při každém spuštění příkazu tcm. Tyto klíče a jejich hodnoty můžete přidat do souboru následujícím způsobem v části appSettings:
<appSettings>
<add key="TeamFoundationServer" value="http://<ServerName:Port/VirtualDirectoryName/CollectionName>"/>
<add key ="TeamProject" value="DinnerNow"/>
</appSettings>
Příklady
Spuštění testů a správa testovacích běhů
Následující příklady předpokládat, že jste vytvořili příkazový řádek sady Visual Studio. (Přejít na začátek, všechny programy, Microsoft Visual Studio, Visual Studio Tools, Developer příkazový řádek.)
Otevře se do složky příkazového řádku: <drive>:\Program Files\Microsoft Visual Studio <version>\VC
Změňte adresář na složku, která obsahuje sestavení vytvořeno z testovací projekt.
Důležité
Pro spuštění automatických testů z příkazového řádku pomocí tcm.exe musíte mít vaše testovací případy přidruženy k vašim automatickým testům.Musíte také správně vytvořit plán testování, aby využíval sestavení k vyhledávání a spouštění automatizovaných testů, pokud do příkazového řádku nezadáte informace o sestavení.Další informace o tom, jak to provést, naleznete v How to: Create Test Cases from an Assembly of Automated Tests Using tcm.exe.
Pro získání potřebných ID pro následující příkazy, bude pravděpodobně nutné použít tcm pro výčet testovacích artefaktů a jejich ID. Další informace o tom, jak to provést, naleznete v tcm: Výpis testovacích plánů, testovacích sad, konfigurací testů a prostředí a Spuštění automatizovaných testů z příkazového řádku pomocí TCM.
Následující příkaz spustí testy pomocí dotazu testovacího bodu:
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>
Následující příkaz spustí testy pomocí konkrétní testovací sady a konfigurace:
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>
Následující příkaz spustí testy pomocí zadaného ID:
Tcm run /execute /id:1207 /collection:<CollectionURL> /teamproject:<Team Project name>
Následující příkaz zobrazí seznam testovacích běhů pro konkrétní testovací plán:
tcm run /list /planid:1 /collection:<CollectionURL> /teamproject:<Team Project name>
Následující příkaz odstraní zadaný testovací běh:
tcm run /delete /id:1009 /collection:<CollectionURL> /teamproject:<Team Project name>
Následující příkaz exportuje testovací běh do souboru TRX:
tcm run /export /id:1273 /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>
Následující příkaz publikuje testovací běh pro konkrétní testovací sady a konfigurace testů a znovu přiřadí vlastníka. Tímto aktualizujete existující testovací body pro testovací případy v testovací sadě spárované s touto konfigurací na výsledky v souboru .trx:
tcm run /publish /suiteid:5 /configid:13 /resultowner:"<Name of new owner>" /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>
Viz také
tcm: Výpis testovacích plánů, testovacích sad, konfigurací testů a prostředí
Používání TCM k importu a spuštění automatizovaných testů pro testovací plán z příkazového řádku