tcm：使用命令列公用程式執行測試計劃中的測試
您可以從命令列執行屬於測試計劃一部分的自動化測試。 這可讓您使用批次檔啟動測試回合，以便您對回合進行排程。 您還可以從命令列管理測試回合。 如果您想要匯出測試回合，讓開發人員可以使用 Visual Studio 檢視測試結果，您可以使用 tcm 達到此目的。 您還可以使用 tcm，發行 Visual Studio 測試回合檔案 (.trx) 中的測試回合結果。 您可以指定將此測試回合檔案中的所需結果重新發行至您的測試計劃。 您可以使用下列 tcm 命令完成這些工作：
tcm run /create
tcm run /list
tcm run /abort
tcm run /delete
tcm run /export
tcm run /publish
tcm.exe 位於任何已安裝 Visual Studio Ultimate 之電腦中的 <Drive:>\Program Files\Microsoft Visual Studio 10.0\Common7\IDE。
如需如何將自動化測試匯入至測試專案並設定專案計劃以執行這些測試的詳細資訊，請參閱從自動化測試的組件建立測試案例和 HOW TO：使用 Tcm 從命令列執行具有自動化的測試案例。
tcm run /create /title:title /planid: id /collection:CollectionURL /teamproject:project (suiteid:id /configid:configid | /querytext: query) [/settingsname:name] [/owner:owner] [/builddir:directory] [/testenvironment:name] [/login:username,[password]] [/include]
tcm run /list [/planid:id | /querytext: query] /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm run /abort /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm run /delete /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]] [/noprompt]
tcm run /export /id:id /resultsfile:path /collection:CollectionURL /teamproject:project [/login:username,[password]] [/attachment:attachmentname]
tcm run /publish /suiteid:id /configid:id /resultowner:owner /resultsfile:path /collection:CollectionURL /teamproject:project [/title: runtitle] [/runowner:owner] [/build:buildnumber /builddefinition:builddefinition] [/flavor:flavor [/platform:platform] [/assignfailurestouser:user] [/login:username,[password]] [/buildverification]
參數
參數 |
描述 |
|---|---|
/collection:CollectionURL |
指定 Team 專案集合的 URI。 URI 的格式如下：http://ServerName:Port/VirtualDirectoryName/CollectionName 如果不使用任何虛擬目錄，則 URI 格式如下： http://ServerName:Port/CollectionName |
/teamproject:project |
Team 專案的名稱，此 Team 專案包含您要將自動化測試匯入其中的測試計劃。 |
/title: title |
指定要用於您所建立之回合的標題，或指定是否發行測試回合檔案。 |
/planid:id |
指定包含所要執行之測試的計劃，或指定與所要列出之測試回合相關聯的計劃。 |
/suiteid:id |
指定您要執行的測試套件。 例如，如果您想要執行一個以上的測試套件，可以使用下列語法做為 tcm 命令 /suiteid:2 /suiteid:3 的一部分。 您也可以指定要在發行測試回合時使用的測試套件。 .gif "注意事項") 注意事項
若要找出套件 ID，您可以列出測試計劃的測試套件。如需詳細資訊，請參閱tcm：列出測試計劃、測試套件、測試組態和環境。
|
/configid:configid |
指定要為測試套件執行哪些測試組態。 例如，如果您想要執行一個以上的測試組態，可以使用下列語法做為 tcm 命令 /configid:2 /configid:3 的一部分。 您也可以指定要在發行測試回合時使用的測試組態。 |
/querytext:query |
指定要用於傳回測試回合的查詢，或指定要用於選取所需執行之測試的查詢。 |
/settingsname:name |
選擇項。 指定要用於此測試回合的測試設定。 如果您沒有使用此參數選取測試設定，則會為測試計劃中的自動化測試使用預設測試設定。 |
/owner:owner |
選擇項。 指定測試回合的擁有者。 |
/runowner:owner |
選擇項。 指定測試回合的擁有者。 |
/builddir:directory |
選擇項。 指定要用於尋找自動化測試之測試組件的組建目錄。 如果未指定，則會根據目前指派給測試計劃的組建，使用組建位置。 |
/testenvironment:name |
選擇項。 指定要用於此測試回合的測試環境。 如果您沒有使用此參數選取測試環境，則會為測試計劃中的自動化測試使用預設測試環境。 |
/id:id |
指定要刪除、中止或匯出的回合 ID。 |
/resultsfile:path |
指定要用於匯出測試回合或在其中尋找要發行之測試回合的位置。 例如，"c:\temp\ResultsForDeveloper.trx"。 |
/attachment:attachmentname |
指定您所匯出之測試回合的附件名稱。 |
/resultowner:owner |
指定測試結果的擁有者。 |
/build:buildnumber |
選擇項。 指定要用於發行測試回合的組建編號。 這個參數必須搭配 /builddefinition 使用。 |
/builddefinition:builddefinition |
選擇項。 指定要用於發行測試回合的組建定義。 這個參數必須搭配 /build 使用。 |
/flavor:flavor |
選擇項。 指定組建類別。 例如，Release。 只有在 /build 參數已使用時才能使用此參數。 |
/platform:platform |
選擇項。 指定組建平台。 例如，x86。 只有在 /build 參數已使用時才能使用此參數。 |
/assignfailurestouser:user |
選擇項。 指定要接受指派測試回合中任何失敗測試的人員。 |
/buildverification |
選擇項。 指定此測試回合包含檢查組建基本功能的組建驗證測試。 |
/include |
選擇項。 指定所選測試回合的所有測試都包括在內，即使這些測試目前未設定為作用中狀態也一樣。 |
/noprompt |
選擇項。 指定不要提示使用者確認刪除測試回合。 |
/login:username,[password] |
選擇項。 指定可登入 Team Foundation Server 應用程式層伺服器和有權限執行命令之使用者的名稱和密碼。 如果您的 Windows 認證沒有適當的權限，或者您使用基本驗證或未連接到網域，就會使用這個選項。 |
您可以將 /collection 和 /teamproject 的參數加入至 tcm.exe.config XML 檔案，這個檔案位於和 tcm.exe: <Drive:>\Program Files\Microsoft Visual Studio 10.0\Common7\IDE 相同的目錄中。 如果您將這些加入至檔案，就不需要每次執行 tcm 命令時在命令列上輸入它們。 您可以將這些索引鍵及其值加入至檔案的 appSettings 區段中，如下所示：
<appSettings>
<add key="TeamFoundationServer" value="http://<ServerName:Port/VirtualDirectoryName/CollectionName>"/>
<add key ="TeamProject" value="DinnerNow"/>
</appSettings>
執行測試並管理測試回合
下列範例假設您已經啟動 Visual Studio 命令提示字元。
若要這樣做，請按一下 [開始]、依序指向 [所有程式]、[Microsoft Visual Studio 2010] 和 [Visual Studio Tools]，然後按一下 [Visual Studio 命令提示字元 (2010)]。
命令提示字元會開啟至資料夾：<drive>:\Program Files\Microsoft Visual Studio 10.0\VC
將目錄變更為包含從您的測試專案所建置之組件的資料夾。
.gif "重要事項") 重要事項 |
|---|
若要從命令列以 tcm.exe 執行自動化測試，您必須使測試案例與自動化測試產生關聯。 如果未在命令列上指定組建資訊，您也必須正確設定測試計劃，才能使用組建找到要執行的自動化測試。 如需這個做法的詳細資訊，請參閱 HOW TO：使用 tcm.exe 從自動化測試的組件建立測試案例。 |
若要取得下列命令所需的 ID，您可能要使用 tcm 列出測試成品及其 ID。 如需這個做法的詳細資訊，請參閱 tcm：列出測試計劃、測試套件、測試組態和環境和 HOW TO：使用 Tcm 從命令列執行具有自動化的測試案例。
下列命令會使用測試點查詢來執行測試：
tcm run /create /title:"Nightly Run" /planid:1 /querytext:"SELECT * FROM TestPoint WHERE ConfigurationId=13" /settingsname:"<Name of your automated test settings>" /testenvironment:"<Name of a matching environment>" /collection:<CollectionURL> /teamproject:<Team Project name>
下列命令會使用特定測試套件和組態來執行測試：
tcm run /create /title:"Nightly Run" /planid:1 /suiteid:5 /configid:13 /settingsname:"<Name of your automated test settings>" /testenvironment:"<Name of a matching environment>" /collection:<CollectionURL> /teamproject:<Team Project name>
下列命令會列出特定測試計劃的測試回合：
tcm run /list /planid:1 /collection:<CollectionURL> /teamproject:<Team Project name>
下列命令會刪除特定測試回合：
tcm run /delete /id:1009 /collection:<CollectionURL> /teamproject:<Team Project name>
下列命令會將測試回合匯出至 .trx 檔案：
tcm run /export /id:1273 /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>
下列命令會發行特定測試套件及測試組態的測試回合，並重新指派擁有者。 這會在與此測試組態搭配的測試套件中，將測試案例的現有測試點更新為 .trx 檔案中的結果：
tcm run /publish /suiteid:5 /configid:13 /resultowner:"<Name of new owner>" /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>