指定要使用 Microsoft 測試管理員建檔的 Bug 類型

發行項
08/12/2011

當測試人員使用 Microsoft 測試管理員找到程式碼缺失時，您可以啟用工作項目自動建立作業。 tcm bugfieldmapping 命令列工具支援將對應檔匯入和匯出至 Team 專案。對應檔會定義要建立的工作項目類型，以及要由 Microsoft 測試管理員填入的三個資料欄位。三個欄位是可重現的步驟、系統資訊和發現缺失的組建。當測試人員執行測試並找出缺失時，他們可以建立會自動填入三個欄位的錯誤。

注意事項
如果 Team 專案是使用以 Microsoft Solutions Framework (MSF) 5.0 版為基礎的流程範本所建立，則 Bug 工作項目類型已啟用。但是，如果您將其他工作項目類型加入至 Bug 分類，或是正在使用自訂的流程範本，則可能需要使用 tcm 命令。

tcm 命令列工具在執行 Team 總管的用戶端電腦中位於磁碟機：\Program Files\Microsoft Visual Studio 10.0\Common7\IDE 內。

如需其他 tcm 命令列工具選項的詳細資訊，請參閱 tcm：從命令列匯入和執行測試計劃的自動化測試。

如需工作項目錯誤類型的詳細資訊，請參閱 Bug (Agile) 或 Bug (CMMI)。

必要的使用權限

在定義工作項目類型的 Team 專案中，您必須是 [Team Foundation Administrators] 安全性群組或 [Project Administrators] 安全性群組的成員。如需詳細資訊，請參閱Team Foundation Server 使用權限。

注意事項
即使您使用系統管理權限登入，還是必須開啟較高權限的命令提示字元視窗，在執行 Windows Server 2008 的伺服器上執行此功能。若要開啟更高權限的 [命令提示字元] 視窗，請按一下 [開始]，並以滑鼠右鍵按一下 [命令提示字元]，然後按一下 [以系統管理員身分執行]。如需詳細資訊，請參閱 Microsoft 網站上的下列網頁：使用者存取控制。

即使您使用系統管理權限登入，還是必須開啟較高權限的命令提示字元視窗，在執行 Windows Server 2008 的伺服器上執行此功能。若要開啟更高權限的 [命令提示字元] 視窗，請按一下 [開始]，並以滑鼠右鍵按一下 [命令提示字元]，然後按一下 [以系統管理員身分執行]。如需詳細資訊，請參閱 Microsoft 網站上的下列網頁：使用者存取控制。

tcm bugfieldmapping /export /mappingfile:path /collection:CollectionURL /teamproject:Project [/login:username,[password]]

tcm bugfieldmapping /import /mappingfile:path /collection:CollectionURL /teamproject:Project [/login:username,[password]]

參數

參數	描述
/export	指定匯出錯誤欄位對應檔。這個檔案會定義要在使用 Microsoft 測試管理員找到程式碼缺失時建立的工作項目類型。它也會指定將填入定義在 Microsoft 測試管理員之資料的工作項目欄位，例如重現步驟、系統資訊以及裡面找到程式碼缺失的組建。如需詳細資訊，請參閱本主題稍後的錯誤欄位對應檔的內容。
/import	指定匯入錯誤欄位對應檔。
/mappingfile:Path	包含錯誤欄位對應的 XML 定義檔的路徑和檔案名稱。注意事項如果您使用 Windows Vista，則可能沒有特定資料夾的使用權限。如果嘗試將工作項目類型匯出至您沒有權限的位置，登錄模擬技術便會自動重新導向至已匯出的檔案，並將該檔案儲存在虛擬存放區中。若要避免此重新導向，您可以將此檔案匯出至您已擁有權限的位置。如需登錄模擬的詳細資訊，請參閱 Microsoft 網站的下列頁面：登錄模擬 (英文) 和 Windows Vista 中常見的檔案及登錄模擬問題。
/collection:CollectionURL	指定 Team 專案集合的統一資源識別元 (URI)。 URI 的格式如下：http://ServerName:Port/VirtualDirectoryName/CollectionName 如果不使用任何虛擬目錄，則 URI 格式如下： http://ServerName:Port/CollectionName
/teamproject:Project	指定要套用錯誤欄位對應的 Team 專案的名稱。這個 Team 專案必須在 /collection 參數所指定的 Team 專案集合中定義。
/login:UserName,Password	選擇項。指定可登入 Team Foundation 應用程式層伺服器和有權限執行命令之使用者的名稱和密碼。當 Windows 認證沒有適當的權限、您正在使用基本驗證，或者您不是在網域上時，可以使用這個選項。
/? 或 help	顯示 [命令提示字元] 視窗中命令的說明。

備註

錯誤欄位對應檔會對 Microsoft 測試管理員提供要建立的工作項目類型的名稱以及要在建立的工作項目中填入的欄位。

當您執行使用 Microsoft 測試管理員的測試時，只能定義一個要建立的工作項目類型。每次執行 tcm bugfieldmapping import 命令時，BugFilerMappings 項目所指定的工作項目類型會取代先前指定的任何工作項目類型。例如，下列程式碼會指出建立以名為 AWBug 之型別為基礎的工作項目。

<BugFilerMappings workitemtypetocreate="AWBug">

如需詳細資訊，請參閱HOW TO：使用 Microsoft 測試管理員送出 Bug。

錯誤欄位對應檔的內容

下列 XML 語法會列出錯誤欄位對應檔的預設內容。檔案會根據在測試回合期間中找不到的資料，指定要建立的工作項目類型以及 Microsoft 測試管理員自動填入的三個工作項目欄位。當您匯入錯誤欄位對應檔時，必須指定所有的三個欄位。

<?xml version="1.0" encoding="utf-16"?>
<BugFilerMappings workitemtypetocreate="Bug">
   <ReproSteps>Microsoft.VSTS.TCM.ReproSteps</ReproSteps>
   <SystemInformation>Microsoft.VSTS.TCM.SystemInfo</SystemInformation>
   <BuildFoundIn>Microsoft.VSTS.Build.FoundIn</BuildFoundIn>
</BugFilerMappings>

如需用於追蹤 Microsoft 測試管理員所尋找資訊之欄位的詳細資訊，請參閱建置和測試整合。

範例

除非另行指定，下列的值會套用在每個範例：

Team 專案集合的 URI：http://AdventureWorksServer:8080/AWTeam/Collection1
專案名稱：AdventureWorks
錯誤欄位對應檔名稱：bugfieldmappings.xml
資料夾位置："C:\Users\AdminUser\Documents\"

匯入錯誤欄位對應檔

下列命令會將 bugfieldmappings.xml 檔案的內容匯入至在名為 AdventureWorksServer 之伺服器上定義於 Collection1 的 AdventureWorks Team 專案。

tcm bugfieldmapping /import /mappingfile:"C:\Users\AdminUser\Documents\bugfieldmappings.xml" /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /teamproject:AdventureWorks