Freigeben über

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

  • Artikel

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

Die Datei "tcm.exe" befindet sich auf jedem Computer, auf dem Visual Studio Ultimate installiert ist, im Ordner <Drive:>\Program Files\Microsoft Visual Studio 10.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

Beschreibungen

/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 10.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.

Klicken Sie auf Start, zeigen Sie auf Alle Programme, Microsoft Visual Studio 2010 und Visual Studio-Tools, und klicken Sie anschließend auf Visual Studio-Eingabeaufforderung (2010).

Der Eingabeaufforderung wird im Ordner geöffnet: <drive>:\Program Files\Microsoft Visual Studio 10.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

Weitere Ressourcen

tcm: Running Tests from a Test Plan Using the Command Line Utility

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