tcm: Importing Automated Tests into Test Cases

Artikel
07/20/2011

Sie können automatisierte Tests, z. B. Komponententests oder Codierte-UI-Tests, in Ihr Testprojekt importieren, um sie als Teil eines Testplans zu verwenden. Die Tests werden von einer Testassembly mithilfe des folgenden tcm-Befehls importiert:

Unknown List Class

Für jeder automatisierten Test, den Sie basierend auf den bereitgestellten Parametern auswählen, ist ein Testfall erstellt. Der automatisierte Test wird automatisch mit diesem Testfall verknüpft. Sie können einer statischen Testsuite Testfälle mithilfe dieses Befehls hinzufügen, oder Sie können Testfälle Testsuites hinzufügen, nachdem Sie sie importiert haben. Weitere Informationen zum Hinzufügen von Testfällen zu Testsammlungen finden Sie unter Gewusst wie: Hinzufügen eines Testfalls zu einer Testsammlung. Sie können diese Testfälle auch mit Anforderungen verknüpfen, um den Status von automatisierten Tests für die Anforderung anzeigen zu können. Weitere Informationen hierzu finden Sie unter Verknüpfen vorhandener Testfälle mit einer Anforderung.

Weitere Informationen zum Ausführen automatisierter Tests in einem Testplan finden Sie unter Grundlagenhandbuch zum Ausführen von automatisierter Tests anhand eines Testplans.

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.

Warnung

Sie können auch vorhandene importierte Testfälle mit diesem Befehl aktualisieren. Wenn die Testfälle, die Sie zum Aktualisieren ausgewählt haben, nicht Tests einschließen, die zuvor importiert wurden, werden nur die ausgewählten Testfälle aktualisiert. Wenn Sie eine Testsuite zum Synchronisieren angeben, wenn Sie die Testfälle aktualisieren, werden die Tests, die nicht importiert werden, aus der Test-Suite, aber nicht aus dem Testplan selbst entfernt.

tcm testcase /import /collection:CollectionURL /teamproject:project /storage:path [/maxpriority:priority] [/minpriority:priority] [/category:filter] [/syncsuite:id [/include:]] [/login:username,[password]]

Parameter

Parameter	Beschreibungen
/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.
/storage: path	Gibt den Pfad und Namen der Testassembly an, die Ihre automatisierten Tests enthält, die Sie importieren möchten.
/maxpriority:priority	Optional. Gibt an, welche Tests basierend auf der maximalen Priorität der Testmethode importiert werden sollen. Wenn beispielsweise der Parameter /maxpriority:1 ist, werden nur Tests mit einem Priority-Attribut für die Testmethode, das kleiner oder gleich 1 ist, als Testfälle aus der Assembly importiert.
/minpriority:priority	Optional. Gibt an, welche Tests basierend auf der minimalen Priorität der Testmethode importiert werden sollen. Wenn beispielsweise der Parameter /minpriority:2 ist, werden nur Tests mit einem Priority-Attribut für die Testmethode, das größer oder gleich 2 ist, als Testfälle aus der Assembly importiert.
/category:filter	Optional. Gibt an, welche Tests basierend auf der Kategorie der Testmethode in der Testassembly importiert werden sollen. Dieser Parameter können Sie zusammen mit /syncsuite zum Importieren von Tests mit einer bestimmten Kategorie in eine bestimmte Test-Suite verwenden. Weitere Informationen zu Testkategorien finden Sie unter Definieren von Testkategorien zum Gruppieren von Tests.
/syncsuite:id	Optional. Gibt die Suite-ID für die Testsuite in Ihrem Testplan an, dem Sie die Testfälle hinzufügen, die Sie importieren möchten. Diese Suite darf keine dynamische Suite oder eine abfragebasierte Suite sein. Wenn Sie eine Testsuite zum Synchronisieren angeben, um Tests zu aktualisieren, die bereits hinzugefügt wurden, werden die Tests, die nicht importiert werden, aus der Test-Suite, aber nicht aus dem Testplan selbst entfernt. Zur Bestimmung der Suite-ID für die Testsuite, die Sie verwenden möchten, können Sie mit dem folgenden Befehl Testsuites in Ihrem Teamprojekt listen: tcm suites /list Weitere Informationen zu diesem Befehl finden Sie unter tcm: Listing test plans, test suites, test configurations, and environments.
/include	Optional. Gibt an, dass Testmethoden, die mit einem Ignore()-Attribut markiert sind, ebenfalls importiert werden.
/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>

Import-Testfälle

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

Wechseln Sie in das Verzeichnis, das die aus dem Testprojekt erstellte Assembly enthält.

Der folgende Befehl importiert Tests aus TestProject1.dll in das DinnerNow-Teamprojekt:

tcm testcase /import /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow /storage:TestProject1.dll

Der folgende Befehl importiert nur die Testfälle mit der Priorität 1:

tcm testcase /import /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow /storage:TestProject1.dll /maxpriority:1

Der folgende Befehl importiert nur die Test-Fälle in den Kategorien SmokeTest und ShoppingCart und fügt sie der Test-Suite mit der ID 3 hinzu:

tcm testcase /import /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow /storage:TestProject1.dll /category:"ShoppingCart&SmokeTest" /syncsuite:3

Siehe auch

Aufgaben

How to: Create Test Cases from an Assembly of Automated Tests Using tcm.exe

Weitere Ressourcen

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

Freigeben über