tcm: Running Tests from a Test Plan Using the Command Line Utility
Sie können automatisierte Tests, die Teil eines Testplans sind, von der Befehlszeile aus ausführen. Damit können Sie einen Testlauf mithilfe einer Batchdatei starten, sodass Sie einen Testlauf planen können. Sie können auch die Testläufe von der Befehlszeile aus verwalten. Wenn Sie einen Testlauf exportieren möchten, sodass Entwickler die Testergebnisse mit Visual Studio anzeigen können, können Sie hierfür tcm verwenden. Sie können auch Testlaufergebnisse aus einer Visual Studio-Testlaufdatei (TRX) mithilfe von tcm veröffentlichen. Sie können angeben, welche Ergebnisse aus dieser Testlaufdatei Sie wieder in Ihrem Testplan veröffentlichen möchten. Sie können diese Aufgaben mit den folgenden tcm-Befehlen ausführen:
tcm run /create
tcm run /list
tcm run /execute
tcm run /abort
tcm run /delete
tcm run /export
tcm run /publish
"tcm.exe" befindet sich auf jedem Computer unter <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE, auf dem Visual Studio Ultimate, Visual Studio Premium oder Visual Studio Test Professional installiert ist.
Weitere Informationen dazu, wie Sie automatisierte Tests in Ihr Testprojekt importieren und Ihren Testplan für das Ausführen dieser Tests einrichten können, finden Sie unter Erstellen von Testfällen auf Grundlage einer Assembly mit automatisierten Tests und Ausführen von automatisierten Tests über die Befehlszeile mit 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]
Parameter
Parameter |
Beschreibung |
|---|---|
/collection:CollectionURL |
Gibt den URI der Teamprojektauflistung an. Das URI-Format lautet wie folgt: http://ServerName:Port/VirtualDirectoryName/CollectionName Wenn kein virtuelles Verzeichnis verwendet wird, hat der URI das folgende Format: http://ServerName:Port/CollectionName |
/teamproject:project |
Der Name des Teamprojekts, das den Testplan enthält, in den Sie Ihre automatisierten Tests importieren möchten. |
/title: title |
Gibt den Titel an, den Sie für den Testlauf verwenden möchten, den Sie erstellen, oder wenn Sie eine Testlaufdatei veröffentlichen. |
/planid:id |
Gibt den Plan an, der die Tests enthält, die Sie ausführen möchten, oder den Plan, der den Testläufen zugeordnet ist, die Sie auflisten möchten. |
/suiteid:id |
Gibt die Testauflistungen an, die Sie ausführen möchten. Es kann auch die beim Veröffentlichen eines Testlaufs zu verwendende Testauflistung angegeben werden. Hinweis Um die Auflistungs-ID zu finden, können Sie die Testauflistungen für einen Testplan aufführen.Weitere Informationen finden Sie unter tcm: Listing test plans, test suites, test configurations, and environments. Tipp Um mehr als eine Testauflistung auszuführen, können Sie den /querytext-Parameter verwenden. |
/configid:configid |
Gibt an, welche Testkonfigurationen für die Testauflistungen ausgeführt werden sollen. Es kann auch die beim Veröffentlichen eines Testlaufs zu verwendende Testkonfiguration angegeben werden. Tipp Um mehr als eine Testkonfiguration auszuführen, können Sie den /querytext-Parameter verwenden. |
/querytext:query |
Gibt die Abfrage an, die zum Zurückgeben des Testlaufs verwendet werden soll, oder die Abfrage, die zum Auswählen der Tests, die Sie ausführen möchten, verwendet werden soll. Tipp Um mehr als eine Testauflistung auszuführen, können Sie den /querytest-Parameter verwenden.Beispiel: querytext:“SELECT * FROM TestPoint WHERE (ConfigurationId=20 OR ConfigurationId=21) AND (Suiteid=1185 OR Suiteid=1186)” |
/settingsname:name |
Dies ist optional. Gibt die Testeinstellungen an, die Sie für diesen Testlauf verwenden möchten. Wenn Sie mit diesem Parameter keine Testeinstellungen auswählen, werden die Standardtesteinstellungen für automatisierte Tests im Testplan verwendet. |
/owner:owner |
Dies ist optional. Gibt den Besitzer des Testlaufs an. |
/runowner:owner |
Dies ist optional. Gibt den Besitzer des Testlaufs an. |
/builddir:directory |
Dies ist optional. Gibt das Buildverzeichnis an, das bei der Suche nach Testassemblys für den automatisierten Test verwendet wird. Wenn dies nicht angegeben ist, wird der Buildort verwendet, basierend auf dem Build, der dem Testplan derzeit zugewiesen ist. |
/testenvironment:name |
Dies ist optional. Gibt die Testumgebung an, die Sie für diesen Testlauf verwenden möchten. Wenn Sie keine Testumgebung mit diesem Parameter auswählen, wird die Standardtestumgebung für automatisierte Tests im Testplan verwendet. |
/id:id |
Gibt die Testlauf-ID an, die Sie löschen, abbrechen oder exportieren möchten. |
/resultsfile:path |
Gibt den Speicherort an, der verwendet wird, um einen Testlauf zu exportieren oder um den Testlauf zu suchen, um ihn zu veröffentlichen. Beispiel: "c:\temp\ResultsForDeveloper.trx". |
/attachment:attachmentname |
Gibt den Namen der Anlage für einen Testlauf an, den Sie exportieren. |
/resultowner:owner |
Gibt den Besitzer für die Testergebnisse an. |
/build:buildnumber |
Dies ist optional. Gibt die Buildnummer an, mit der ein Testlauf veröffentlicht werden soll. Dieser Parameter muss mit /builddefinition verwendet werden. |
/builddefinition:builddefinition |
Dies ist optional. Gibt die Builddefinition an, mit der ein Testlauf veröffentlicht werden soll. Dieser Parameter muss mit /build verwendet werden. |
/flavor:flavor |
Dies ist optional. Gibt die Buildkonfiguration an. Zum Beispiel "Version". Dieser Parameter kann nur verwendet werden, wenn der Parameter /build verwendet wird. |
/platform:platform |
Dies ist optional. Gibt die Buildplattform an. Zum Beispiel "x86". Dieser Parameter kann nur verwendet werden, wenn der Parameter /build verwendet wird. |
/assignfailurestouser:user |
Dies ist optional. Gibt an, welchem Benutzer Tests mit Fehlern im Testlauf zugewiesen werden sollen. |
/buildverification |
Dies ist optional. Gibt an, dass dieser Testlauf Buildüberprüfungstests enthält, die die grundlegende Funktionalität des Builds überprüfen. |
/include |
Dies ist optional. Gibt an, dass alle Tests, die für den Testlauf ausgewählt wurden, enthalten sind, auch wenn die Tests derzeit nicht in den aktiven Zustand gesetzt sind. |
/noprompt |
Dies ist optional. Gibt an, dass der Benutzer nicht aufgefordert wird, das Löschen eines Testlaufs zu bestätigen. |
/login:username,[password] |
Dies ist optional. Gibt den Namen und das Kennwort eines Benutzers an, der am Anwendungsebenenserver für Team Foundation Server angemeldet ist und über Berechtigungen zum Ausführen des Befehls verfügt. Diese Option können Sie verwenden, wenn Ihre Windows-Anmeldeinformationen nicht über die entsprechenden Berechtigungen verfügen, wenn Sie die Standardauthentifizierung verwenden oder wenn Sie nicht mit einer Domäne verbunden sind. Für die Anmeldung bei Visual Studio Online müssen Sie auch die unten aufgelisteten /allowalternatecredentials verwenden. |
/allowalternatecredentials |
Dieses Kennzeichen muss zusätzlich zum /login-Parameter angegeben werden, wenn eine Verbindung zu Visual Studio Online hergestellt wird. (Dieses Kennzeichen ist nur verfügbar, wenn Sie über Visual Studio 2013 Update 4 oder höher verfügen.) |
Sie können Parameter für /collection und /teamproject zur XML-Datei tcm.exe.config hinzufügen, die sich in demselben Verzeichnis wie tcm.exe befindet: <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE. Wenn Sie diese der Datei hinzufügen, müssen Sie sie nicht jedes Mal, wenn Sie einen tcm-Befehl ausführen, in die Befehlszeile eingeben. Sie können diese Schlüssel und ihre Werte der Datei folgendermaßen im Abschnitt appSettings hinzufügen:
<appSettings>
<add key="TeamFoundationServer" value="http://<ServerName:Port/VirtualDirectoryName/CollectionName>"/>
<add key ="TeamProject" value="DinnerNow"/>
</appSettings>
Ausführen von Tests und Verwalten von Testläufen
In den folgenden Beispielen wird davon ausgegangen, dass Sie eine Visual Studio-Eingabeaufforderung gestartet haben.
Wählen Sie dazu Start, zeigen Sie auf Alle Programme, auf Microsoft Visual Studio 2012 und auf Visual Studio Tools, und wählen Sie dann Developer-Eingabeaufforderung.
Der Eingabeaufforderung wird in folgendem Ordner geöffnet: <drive>:\Program Files\Microsoft Visual Studio 11.0\VC
Wechseln Sie in das Verzeichnis, das die aus dem Testprojekt erstellte Assembly enthält.
Wichtig
Zum Ausführen von automatisierten Tests mit "tcm.exe" von der Befehlszeile aus müssen Sie Ihre Testfälle Ihren automatisierten Tests zugeordnet haben.Sie müssen auch Ihren Testplan ordnungsgemäß einrichten, um mithilfe eines Builds die auszuführenden automatisierten Tests zu suchen, wenn Sie die Buildinformationen nicht in der Befehlszeile angeben.Weitere Informationen hierzu finden Sie unter How to: Create Test Cases from an Assembly of Automated Tests Using tcm.exe.
Um die notwendigen IDs für die folgenden Befehle zu erhalten, müssen Sie tcm verwenden, um die Testartefakte sowie deren IDs aufzulisten. Weitere Informationen hierzu finden Sie unter tcm: Listing test plans, test suites, test configurations, and environments und Ausführen von automatisierten Tests über die Befehlszeile mit TCM.
Mit dem folgenden Befehl werden Tests mithilfe einer Testpunktabfrage ausgeführt:
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>
Mit dem folgenden Befehl werden Tests mithilfe einer bestimmten Testauflistung und -konfiguration ausgeführt:
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>
Mit dem folgenden Befehl werden Tests mithilfe einer bestimmten ID ausgeführt:
Tcm run /execute /id:1207 /collection:<CollectionURL> /teamproject:<Team Project name>
Mit dem folgenden Befehl werden die Testläufe für einen bestimmten Testplan aufgelistet:
tcm run /list /planid:1 /collection:<CollectionURL> /teamproject:<Team Project name>
Mit dem folgenden Befehl wird ein bestimmter Testlauf gelöscht:
tcm run /delete /id:1009 /collection:<CollectionURL> /teamproject:<Team Project name>
Mit dem folgenden Befehl wird ein Testlauf in eine TRX-Datei exportiert:
tcm run /export /id:1273 /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>
Mit dem folgenden Befehl wird ein Testlauf für eine spezifische Testauflistung und Testkonfiguration veröffentlicht und der Besitzer neu zugewiesen. Dadurch werden die vorhandenen Testpunkte für die Testfälle in der Testauflistung gepaart mit dieser Konfiguration auf die Ergebnisse in der TRX-Datei aktualisiert:
tcm run /publish /suiteid:5 /configid:13 /resultowner:"<Name of new owner>" /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>
Siehe auch
Referenz
tcm: Listing test plans, test suites, test configurations, and environments