tcm: Listing test plans, test suites, test configurations, and environments

Artikel
02/26/2013

Führen Sie Ihre Tests von der Befehlszeile mit tcm.exe aus, oder importieren Sie die Testfälle in einer bestimmten Test-Suite – dazu benötigen Sie die Namen und IDs der Artefakte, die zum Ausführen der Tests erforderlich sind.Sie können eine Liste der Test-Artefakte 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 in <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE auf jedem Computer, auf dem Visual Studio Ultimate Visual Studio Premium oder Visual Studio Test Professional installiert.

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 Testsammlungen in diesem Testplan aufgeführt werden.
/collection:CollectionURL	Gibt den URI der Teamprojektsammlung an.Das Format für den URI sieht folgendermaßen aus: http://Servername:Port/VirtuellerVerzeichnisname/Sammlungsname Wenn kein virtuelles Verzeichnis verwendet wird, hat der URI das folgende Format: http://Servername:Port/Auflistungsname
/teamproject:project	Der Name des Teamprojekts, das den Testplan enthält, in den Sie Ihre automatisierten Tests importieren möchten.
/login:username,[password]	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.

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 in der Befehlszeile eingeben, jedes Mal, wenn Sie einen tcm-Befehl ausführen.Sie können diese Schlüssel und ihre Werte der Datei wie im Folgenden im Abschnitt appSettings hinzufügen:

    <appSettings>
         <add key="TeamFoundationServer" value=""http://<ServerName:Port/VirtualDirectoryName/CollectionName>"/>
         <add key ="TeamProject" value="DinnerNow"/>
    </appSettings>

Listen-Testelemente

In den folgenden Beispielen wird davon ausgegangen, dass Sie eine Visual Studio Eingabeaufforderung gestartet haben.

Hierzu wählen Sie Start, zeigen Sie auf Alle Programme, zeigen Sie auf Microsoft Visual Studio 2012, zeigen Sie auf Visual Studio-Tools, und wählen Sie dann Developer-Eingabeaufforderung.

Der Eingabeaufforderung wird im Ordner geöffnet: <drive>:\Program Files\Microsoft Visual Studio 11.0\VC

Der folgende Befehl listet die Testkonfigurationen im DinnerNow-Teamprojekt auf:

tcm configs /list /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow

Der folgende Befehl listet nur den Testplan Sprint 1 im DinnerNow-Teamprojekt, so dass Sie seine ID anzeigen können:

tcm plans /list /querytext:"SELECT * FROM TestPlans WHERE PlanName=’Sprint 1’" /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow

Der folgende Befehl listet die Testsuites im Testplan mit ID 3 im DinnerNow-Teamprojekt:

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

Weitere Ressourcen

tcm: Importing and Running Automated Tests for a Test Plan from the Command Line

Freigeben über