tcm: Importing Automated Tests into Test Cases
Sie können automatisierte Tests, z. B. Komponententests oder Coded 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:
- tcm testcase /import
Für jeden automatisierten Test, den Sie basierend auf den bereitgestellten Parametern auswählen, wird ein Testfall erstellt. Der automatisierte Test wird automatisch diesem Testfall zugeordnet. Sie können einer statischen Testauflistung Testfälle mithilfe dieses Befehls hinzufügen, oder Sie können Testauflistungen Testfälle hinzufügen, nachdem Sie sie importiert haben. Weitere Informationen zum Hinzufügen von Testfällen zu einer Testauflistung finden Sie unter Planen von manuellen Tests mit Team Web Access. 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 zur Vorgehensweise finden Sie unter Verknüpfen vorhandener Testfälle mit einer Anforderung.
Weitere Informationen zum Ausführen automatisierter Tests in einem Testplan finden Sie unter Automatisieren von Systemtests.
"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.
Warnung
Sie können auch vorhandene importierte Testfälle mithilfe dieses Befehls aktualisieren.Wenn die Testfälle, die Sie zum Aktualisieren ausgewählt haben, keine Tests einschließen, die zuvor importiert wurden, werden nur die ausgewählten Testfälle aktualisiert.Wenn Sie eine Testauflistung zum Synchronisieren angeben, wenn Sie die Testfälle aktualisieren, werden die Tests, die nicht importiert werden, aus der Testauflistung, jedoch 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 |
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. |
/storage: path |
Gibt den Pfad und Namen der Testassembly an, die Ihre automatisierten Tests enthält, die Sie importieren möchten. |
/maxpriority:priority |
Dies ist 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 Prioritätsattribut für die Testmethode, das kleiner oder gleich 1 ist, als Testfälle von der Assembly importiert. |
/minpriority:priority |
Dies ist 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 Prioritätsattribut für die Testmethode, das größer oder gleich 2 ist, als Testfälle von der Assembly importiert. |
/category:filter |
Dies ist optional. Gibt an, welche Tests basierend auf der Kategorie jeder Testmethode in der Testassembly importiert werden sollen. Diesen Parameter können Sie zusammen mit /syncsuite zum Importieren von Tests mit einer bestimmten Kategorie in eine bestimmte Testauflistung verwenden. Weitere Informationen zu Testkategorien finden Sie unter Definieren von Testkategorien zum Gruppieren von Tests. |
/syncsuite:id |
Dies ist optional. Gibt die Auflistungs-ID für die Testauflistung in Ihrem Testplan an, dem Sie die Testfälle hinzufügen möchten, die Sie importieren. Diese Auflistung darf keine dynamische Auflistung oder eine abfragebasierte Auflistung sein. Wenn Sie eine Testauflistung zum Synchronisieren angeben, um Tests zu aktualisieren, die bereits hinzugefügt wurden, werden die Tests, die nicht importiert werden, aus der Testauflistung, jedoch nicht aus dem Testplan selbst entfernt. Zum Bestimmen der Auflistungs-ID für die Testauflistung, die Sie verwenden möchten, können Sie mit dem folgenden Befehl Testauflistungen in Ihrem Teamprojekt auflisten: tcm suites /list Weitere Informationen zu diesem Befehl finden Sie unter tcm: Listing test plans, test suites, test configurations, and environments. |
/include |
Dies ist optional. Gibt an, dass Testmethoden, die mit einem Ignore()-Attribut markiert sind, ebenfalls importiert werden. |
/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>
Importieren von Testfällen
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.
Mit dem folgenden Befehl werden Tests von "TestProject1.dll" in das DinnerNow-Teamprojekt importiert:
tcm testcase /import /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow /storage:TestProject1.dll
Mit dem folgenden Befehl werden nur die Testfälle mit der Priorität 1 importiert:
tcm testcase /import /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow /storage:TestProject1.dll /maxpriority:1
Mit dem folgenden Befehl werden nur die Testfälle in den Kategorien SmokeTest und ShoppingCart importiert und der Testauflistung mit der ID 3 hinzugefügt:
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