tcm: uruchamianie testów z planu testu za pomocą narzędzia wiersza polecenia
Opublikowano: czerwiec 2016
Testy automatyczne, które są częścią planu testów można uruchamiać z wiersza polecenia. Dzięki temu można uruchomić testy przy użyciu pliku wsadowego i zaplanować bieg. Przebiegi testowe można również zarządzać z wiersza polecenia. Jeśli chcesz wyeksportować test, tak aby deweloper mógł wyświetlić wyniki testu za pomocą Visual Studio, możesz użyć w tym celu tcm. Można również publikować wyniki testu z pliku przebiegu testu Visual Studio (.trx) przy użyciu tcm. Można określić, które wyniki z tego pliku testu uruchamiania mają zostać opublikowane w planie testu. Użyj następujących poleceń tcm, aby wykonać następujące zadania:
tcm run /create
tcm run /list
tcm run /execute
tcm run /abort
tcm run /delete
tcm run /export
tcm run /publish
TCM.exe znajduje się w <Drive:>\Program Files\Microsoft Visual Studio <version>\Common7\IDE na dowolnym komputerze, która nie ma programu Visual Studio Enterprise lub programu Visual Studio Test Professional.
Aby uzyskać więcej informacji na temat importowania zautomatyzowanych testów w projekcie testu i skonfiguruj swój plan testu, aby uruchomić te testy, zobacz Tworzenie przypadków testowych z zestawu zautomatyzowanych testów i Uruchamianie testów automatycznych w wierszu polecenia przy użyciu narzędzia tcm.
Składnia
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 |
Opis |
|---|---|
/collection:CollectionURL |
Określa URI kolekcji projektu zespołowego. Format identyfikatora URI jest w następujący sposób: http://nazwa_serwera: port/NazwaKataloguWirtualnego/CollectionName Jeśli katalog wirtualny nie jest używany, format identyfikatora URI jest następujący: http://Nazwa_serwera: port / CollectionName |
/teamproject:project |
Nazwa projektu zespołowego, który zawiera plan testu, który ma zostać zaimportowany zautomatyzowanych testów w. |
/title: title |
Określa tytuł, którego chcesz użyć do utworzonego uruchomienia, lub jeśli publikujesz plik przebiegu testowego. |
/planid:id |
Określa plan, który zawiera testy, które chcesz uruchomić lub plan skojarzony z testem uruchamiania, który ma być wyświetlony. |
/suiteid:id |
Określa zestawy testów, które ma zostać uruchomiony. Można również określić pakiet testowy do użycia podczas publikacji uruchamiania testów. Uwaga Aby znaleźć identyfikator pakietu, można wyświetlić listę pakietów testowych w planie testów.Aby uzyskać więcej informacji, zobacz tcm: umieszczanie na liście planów testów, zestawów testów, konfiguracji testów oraz środowisk. Porada Aby uruchomić więcej niż jeden zestaw testów, można użyć parametru /querytext. |
/configid:configid |
Określa konfigurację testu, który chcesz uruchomić dla swoich pakietów testowych. Można również określić konfigurację testową do użycia podczas publikacji uruchamiania testów. Porada Aby uruchomić więcej niż jedną konfigurację testu, można użyć parametru /querytext. |
/querytext:query |
Określa używane zapytanie, które zwraca uruchomione testy lub zapytanie służące do wybierania testów, które chcesz uruchomić. Porada Aby uruchomić więcej niż jeden zestaw testów, można użyć parametru /querytext.Na przykład: querytext:“SELECT * FROM TestPoint WHERE (ConfigurationId=20 OR ConfigurationId=21) AND (Suiteid=1185 OR Suiteid=1186)” |
/settingsname:name |
Opcjonalnie. Określa ustawienia testu, których chcesz używać do tego przebiegu testowego. Jeśli nie zostaną wybrane ustawienia testu z tym parametrem, używane są domyślne ustawienia testu dla zautomatyzowanych testów w planie testów. |
/owner:owner |
Opcjonalnie. Określa właściciela uruchamiania testu. |
/runowner:owner |
Opcjonalnie. Określa właściciela uruchamiania testu. |
/builddir:directory |
Opcjonalnie. Określa katalog kompilacji, który służy do lokalizowania zestawów badawczych do automatycznego testu. Jeśli tego nie określono, lokalizacja kompilacji jest używana w oparciu o kompilację obecnie przypisaną do planu testu. |
/testenvironment:name |
Opcjonalnie. Określa środowisko testowe, którego chcesz używać do tego przebiegu testowego. Jeśli środowisko testowe z tym parametrem nie zostanie zaznaczone, używane jest domyślne środowisko testowe dla zautomatyzowanych testów w planie testów. |
/id:id |
Określa identyfikator uruchomienia, który chcesz usunąć, przerwać lub eksportować. |
/resultsfile:path |
Określa lokalizację używaną w celu eksportowania testu lub znalezienia testu do opublikowania. Na przykład „c:\temp\ResultsForDeveloper.trx”. |
/attachment:attachmentname |
Określa nazwę załącznika dla uruchomienia testu, który chcesz eksportować. |
/resultowner:owner |
Określa właściciela dla wyników testów. |
/build:buildnumber |
Opcjonalnie. Określa numer kompilacji, który ma być używany do publikowania uruchomień testów. Ten parametr musi być używany z parametrem /builddefinition. |
/builddefinition:builddefinition |
Opcjonalnie. Określa definicję kompilacji, która ma być używa na do publikowania uruchomień testów. Ten parametr musi być używany z parametrem /build. |
/flavor:flavor |
Opcjonalnie. Określa wersję kompilacji. Na przykład Wydanie. Tego parametru należy używać tylko jeśli używany jest parametr /build. |
/platform:platform |
Opcjonalnie. Określa platformę kompilacji. Na przykład x86. Tego parametru należy używać tylko jeśli używany jest parametr /build. |
/assignfailurestouser:user |
Opcjonalnie. Określa, do kogo przypisać wszystkie testy zakończone niepomyślnie w uruchomionym teście. |
/buildverification |
Opcjonalnie. Określa, że ta sesja testu zawiera testy weryfikujące kompilację, które sprawdzają podstawową funkcjonalność kompilacji. |
/include |
Opcjonalnie. Określa, że wszystkie testy, które zostały wybrane do uruchomienia testu, są włączone, nawet jeśli badania nie są ustawione na stan Aktywne. |
/noprompt |
Opcjonalnie. Określa, że użytkownik nie jest monitowany o potwierdzenie usunięcia uruchomień testowych. |
/login:username,[password] |
Opcjonalnie. Określa nazwę i hasło użytkownika, który jest zalogowany do serwera warstwy aplikacji dla programu Team Foundation Server i który ma uprawnienia do uruchamiania tego polecenia. Użyj tej opcji, kiedy poświadczenia systemu Windows nie mają odpowiednich uprawnień, używasz uwierzytelniania podstawowego lub nie masz połączenia z domeną. Aby zalogować się do programu Visual Studio Online, konieczne będzie używać /allowalternatecredentials wymienione poniżej. |
/allowalternatecredentials |
Ta flaga należy określić oprócz /login parametru podczas łączenia się z programu Visual Studio Online. (Ta flaga jest tylko dostępna, gdy program Visual Studio 2013 Update 4 lub nowszego). |
Możesz dodać parametry /collection i /teamproject do tcm.exe.config pliku XML, który znajduje się w tym samym katalogu co tcm.exe: <Drive:>\Program Files\Microsoft Visual Studio <version>\Common7\IDE. Jeśli dodasz je do pliku, nie będzie trzeba wprowadzać ich w wierszu polecenia za każdym przy uruchamianiu polecenia tcm. Można dodać te klucze i wartości do pliku w następujący sposób, w w sekcji appSettings:
<appSettings>
<add key="TeamFoundationServer" value="http://<ServerName:Port/VirtualDirectoryName/CollectionName>"/>
<add key ="TeamProject" value="DinnerNow"/>
</appSettings>
Przykłady
Wykonywanie testów i zarządzanie nimi
Poniższe przykłady założyć, że uruchomiono wiersz polecenia programu Visual Studio. (Przejdź do rozpoczęcia, wszystkie programy, programu Microsoft Visual Studio, Visual Studio Tools, wiersz polecenia deweloperów).
Otwiera wiersza polecenia do folderu: <drive>:\Program Files\Microsoft Visual Studio <version>\VC
Zmień katalog do folderu, który zawiera zestaw utworzony z projektu testu.
Ważne
Aby uruchomić testy automatyczne z wiersza polecenia używając polecenia tcm.exe, należy powiązać przypadki testowe z testami automatycznymi.Jeśli informacje o kompilacji nie zostaną określone w wierszu polecenia, należy poprawnie zdefiniować plan testu do wykorzystywania kompilacji w celu znajdywania testów automatycznych do wykonania.Aby uzyskać więcej informacji na temat jak to zrobić, zobacz How to: Create Test Cases from an Assembly of Automated Tests Using tcm.exe.
Aby uzyskać identyfikatory niezbędne dla następujących poleceń, musisz użyć polecenia tcm, aby wyświetlić listę artefaktów testowych i ich identyfikatory. Aby uzyskać więcej informacji na temat jak to zrobić, zobacz tcm: umieszczanie na liście planów testów, zestawów testów, konfiguracji testów oraz środowisk i Uruchamianie testów automatycznych w wierszu polecenia przy użyciu narzędzia tcm.
Następujące polecenie uruchamia testy za pomocą kwerendy punktu testowego:
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>
Następujące polecenie uruchamia testy przy użyciu pakietu testów określonych i konfiguracji:
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>
Następujące polecenie uruchamia testu za pomocą określonego identyfikatora:
Tcm run /execute /id:1207 /collection:<CollectionURL> /teamproject:<Team Project name>
Następujące polecenie wyświetla listę uruchomień testu dla określonego planu testów:
tcm run /list /planid:1 /collection:<CollectionURL> /teamproject:<Team Project name>
Następujące polecenie usuwa określony przebieg testu:
tcm run /delete /id:1009 /collection:<CollectionURL> /teamproject:<Team Project name>
Następujące polecenie eksportuje test uruchomiony w pliku .trx:
tcm run /export /id:1273 /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>
Następujące polecenie publikuje test uruchamiany dla określonego pakietu testowego i konfiguracji testu, i ponownie przypisuje właściciela. Aktualizuje istniejące punkty testu dla przypadków testowych w zestawie testów, który został połączony w parę z tą konfiguracją, do wyników w pliku .trx:
tcm run /publish /suiteid:5 /configid:13 /resultowner:"<Name of new owner>" /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>
Zobacz też
tcm: umieszczanie na liście planów testów, zestawów testów, konfiguracji testów oraz środowisk
Używanie narzędzia tcm w wierszu polecenia do importowania i uruchamiania testów automatycznych w ramach planu testów