tcm: Listing test plans, test suites, test configurations, and environments
Führen Sie Ihre Tests von der Befehlszeile mit "tcm.exe" aus, oder importieren Sie die Testfälle in eine bestimmte Testauflistung – dazu benötigen Sie die Namen und IDs der Artefakte, die zum Ausführen der Tests erforderlich sind. Sie können eine Liste der Testartefakte von der Befehlszeile aus mithilfe der folgenden tcm-Befehle abrufen:
tcm plans /list
tcm suites /list
tcm configs /list
tcm testenvironments /list
"tcm.exe" befindet sich auf jedem Computer, auf dem Visual Studio Ultimate, Visual Studio Premium oder Visual Studio Test Professional installiert ist, unter <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE.
tcm plans /list [/querytext:query] /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm suites /list [/planid: id | /querytext:query] /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm configs /list [/querytext:query] /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm testenvironments /list /collection:CollectionURL /teamproject:project [/login:username,[password]]
Parameter
Parameter |
Beschreibung |
|---|---|
/querytext:query |
Gibt die Abfrage an, mit der die Testartefakte zurückgegeben werden sollen. |
/planid:id |
Gibt an, dass nur die Testauflistungen in diesem Testplan aufgeführt werden. |
/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. |
/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>
Auflisten der Testelemente
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
Mit dem folgenden Befehl werden die Testkonfigurationen im DinnerNow-Teamprojekt aufgelistet:
tcm configs /list /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow
Mit dem folgenden Befehl wird nur der Testplan "Sprint 1" im DinnerNow-Teamprojekt aufgelistet, sodass Sie seine ID anzeigen können:
tcm plans /list /querytext:"SELECT * FROM TestPlan WHERE PlanName=’Sprint 1’" /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow
Mit dem folgenden Befehl werden die Testauflistungen im Testplan mit ID 3 im DinnerNow-Teamprojekt aufgeführt:
tcm suites /list /planid:3 /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow
Siehe auch
Referenz
tcm: Running Tests from a Test Plan Using the Command Line Utility