tcm：將自動化測試匯入測試案例中
您可以將自動化的測試 (例如，單元測試或自動程式碼 UI 測試) 匯入至測試專案中，做為測試計劃的一部分使用。 測試是使用下列 tcm 命令從測試組件所匯入：
- tcm testcase /import
您根據提供的參數所選取的每個自動化測試，系統會建立對應的測試案例。 自動化的測試會自動與該測試案例產生關聯。 您可以使用此命令將測試案例加入至靜態測試套件，或是在匯入測試案例後，將測試案例加入至測試套件。 如需如何將測試案例加入至測試套件的詳細資訊，請參閱 使用 Team Web Access 計劃手動測試。 您也可以將這些測試案例與需求相連結，以便檢視需求的自動測試狀態。 如需這個做法的詳細資訊，請參閱將現有測試案例連結至需求。
如需如何從測試計劃執行自動化測試的詳細資訊，請參閱 自動化系統測試。
tcm.exe 位於任何已安裝 Visual Studio Ultimate、Visual Studio Premium 或 Visual Studio Test Professional 之電腦的 <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE。
警告
您也可以使用這個命令，更新現有匯入的測試案例。如果您選取要更新的測試案例不包括先前匯入的測試，則只會更新選取的測試案例。如果您指定要在更新測試案例時同步處理的測試套件，則會從測試套件 (而不是從測試計劃本身) 移除未匯入的測試。
tcm testcase /import /collection:CollectionURL /teamproject:project /storage:path [/maxpriority:priority] [/minpriority:priority] [/category:filter] [/syncsuite:id [/include:]] [/login:username,[password]]
參數
參數 |
描述 |
|---|---|
/collection:CollectionURL |
指定 Team 專案集合的 URI。 URI 的格式如下：http://ServerName:Port/VirtualDirectoryName/CollectionName 如果不使用任何虛擬目錄，則 URI 格式如下： http://ServerName:Port/CollectionName |
/teamproject:project |
Team 專案的名稱，包含您要將自動化測試匯入其中的測試計劃。 |
/storage: path |
指定測試組件的路徑和名稱，該組件包含您要匯入的自動化測試。 |
/maxpriority:priority |
選擇項。 指定要根據測試方法的最高優先順序匯入哪些測試。 例如，如果參數是 /maxpriority:1，則只會將測試方法優先順序屬性小於或等於 1 的測試從組件匯入為測試案例。 |
/minpriority:priority |
選擇項。 指定要根據測試方法的最低優先順序匯入哪些測試。 例如，如果參數是 /minpriority:2，則只會將測試方法優先順序屬性等於或大於 2 的測試從組件匯入為測試案例。 |
/category:filter |
選擇項。 指定要根據測試組件中每個測試方法的分類匯入哪些測試。 您可以搭配 /syncsuite 使用此參數，將某個分類的測試匯入至特定測試套件。 如需測試分類的詳細資訊，請參閱定義測試分類以分組測試。 |
/syncsuite:id |
選擇項。 指定測試計劃中測試套件的套件 ID，在該套件中您想要加入匯入的測試案例。 此套件不可以是動態套件或查詢式套件。 如果您指定測試套件以同步更新已加入的測試，則會從測試套件 (而不是從測試計劃本身) 移除未匯入的測試。 若要確定要使用的測試套件的套件 ID，您可以使用下列命令列出 Team 專案中的測試套件： tcm suites /list 如需此命令的詳細資訊，請參閱 tcm：列出測試計劃、測試套件、測試組態和環境。 |
/include |
選擇項。 指定也要匯入以 Ignore() 屬性標記的測試方法。 |
/login:username,[password] |
選擇項。 指定可登入 Team Foundation Server 應用程式層伺服器和有權限執行命令之使用者的名稱和密碼。 如果您的 Windows 認證沒有適當的權限，或者您使用基本驗證或未連接到網域，就會使用這個選項。 若要登入 Visual Studio Online，您也必須使用下列 /allowalternatecredentials。 |
/allowalternatecredentials |
連接至 Visual Studio Online 時，除了 /login 參數之外，還必須指定這個旗標。 (只有安裝 Visual Studio 2013 Update 4 (含) 以上版本時，才能使用這個旗標)。 |
您可以將 /collection 和 /teamproject 的參數加入 tcm.exe.config XML 檔案，這個檔案和 tcm.exe 位於相同的目錄中：<Drive:>\Program Files\Microsoft Visual Studio 11.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 2012]、[Visual Studio Tools]，再選擇 [開發人員命令提示字元]。
命令提示字元會開啟至資料夾：<drive>:\Program Files\Microsoft Visual Studio 11.0\VC
將目錄變更為包含從您的測試專案所建置之組件的資料夾。
下列命令會將測試從 TestProject1.dll 匯入至 DinnerNow Team 專案：
tcm testcase /import /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow /storage:TestProject1.dll
下列命令僅匯入優先順序為 1 的測試案例：
tcm testcase /import /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow /storage:TestProject1.dll /maxpriority:1
下列命令僅匯入 SmokeTest 和 ShoppingCart 分類中的測試案例，並將其加入至 ID 為 3 的測試套件：
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