匯入和匯出分類 [witadmin]
您可以使用下列 witadmin 命令，匯入及匯出為 Team 專案定義的分類：
exportcategories：匯出在執行 Team Foundation Server 之伺服器上定義分類的 XML 定義。
importcategories：將工作項目類型 XML 定義檔案匯入執行 Team Foundation Server 之伺服器上的 Team 專案。
如果具有相同名稱的分類已經存在，這個命令就會覆寫現有的定義。 如果工作項目類型不存在，則這個命令會建立新的分類。
若要了解預設分類及其使用方式，請到這裡。
若要執行 witadmin 命令列工具，請開啟安裝 Visual Studio 或 Team Explorer 的命令提示字元視窗，並輸入：
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
在 Windows 32 位元版本中，將 %programfiles(x86)% 取代為 %%programfiles%。
.gif "注意事項") 注意事項 |
|---|
您可以使用 Visual Studio 的強大工具 [流程編輯器] 來建立和修改分類。不支援此強大工具。如需詳細資訊，請參閱 Microsoft 網站上的下列頁面：Team Foundation Server Power Tools。 |
需求
對於定義分類的 Team 專案，您必須設定下列權限：
若要匯出工作項目類型的分類，您必須將 [檢視專案層級資訊] 使用權限設為 [允許]。
若要匯入工作項目類型的分類，您必須是 [Project Administrators] 安全性群組的成員，或將 [編輯專案層級資訊] 權限設為 [允許]。
witadmin exportcategories /collection:CollectionURL /p:Project [/f:FileName] [/e:Encoding]
witadmin importcategories /collection:CollectionURL /p:Project /f:FileName [/e:Encoding]
參數
參數 |
描述 |
|---|---|
/collection:CollectionURL |
指定 Team 專案集合的 URI。 URI 的格式如下：http://ServerName:Port/VirtualDirectoryName/CollectionName 如果不使用任何虛擬目錄，則 URI 格式如下： http://ServerName:Port/CollectionName。 |
/p:Project |
匯出分類或匯入分類的 Team 專案名稱。 |
/f:FileName |
包含要匯出或匯入分類的 XML 定義檔路徑和檔案名稱。 如果您省略這個參數，當使用 exportcategories 命令時，該命令會在 [命令提示字元] 視窗中列出分類。 |
/e:Encoding |
.NET Framework 2.0 編碼格式的名稱。 指定的編碼方式將會用來匯出或匯入 XML 資料。 例如 /e:utf-7 會指定 Unicode (UTF-7) 編碼。 如果您省略這個參數，witadmin 會嘗試偵測編碼，如果偵測失敗，witadmin 就會使用 UTF-8。 |
/? 或help |
顯示 [命令提示字元] 視窗中命令的說明。 |
備註
匯入分類檔案會建立分類 (如果它們不存在)。 如果分類已經存在，witadmin importcategories 命令會警告您將會覆寫目前的清單。 您可以撰寫自己的程式來更新一組現有的分類，或是自行用新資料更新分類。
重要
您對分類所做的變更可能會影響流程組態。請參閱 設定及自訂 Team 專案的 Agile 計劃工具。
如需類別 XML 檔案結構的相關資訊，請參閱Categories XML 項目參考。
範例
除非另行指定，下列的值會套用在每個範例：
Team 專案集合的 URI：http://AdventureWorksServer:8080/tfs/DefaultCollection
專案名稱：AdventureWorks
輸入或輸出檔案名稱：myCategories.xml
預設編碼：UTF-8
列示分類
下列命令會列出為 AdventureWorks 專案定義的工作項目類型分類。
witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks
將分類加入至隱藏類型分類。
將分類加入至隱藏類型分類，不讓使用者在該分類建立工作項目類型。
為您的 Team 專案匯出分類定義檔。
witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml在您慣用的文字編輯器中開啟分類檔，並尋找 "Hidden Types Category" 的 CATEGORY 項目。
<CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory"> <DEFAULTWORKITEMTYPE name="Code Review Request" /> <WORKITEMTYPE name="Code Review Response" /> <WORKITEMTYPE name="Feedback Request" /> <WORKITEMTYPE name="Feedback Response" /> <WORKITEMTYPE name="Shared Steps" /> </CATEGORY>將指定您要加入之工作項目類型的易記名稱的 WORKITEMTYPE 項目加入。
例如，下列語法會將「整合組建」的自訂工作項目類型加入至隱藏類型分類。
<CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory"> <DEFAULTWORKITEMTYPE name="Code Review Request" /> <WORKITEMTYPE name="Code Review Response" /> <WORKITEMTYPE name="Feedback Request" /> <WORKITEMTYPE name="Feedback Response" /> <WORKITEMTYPE name="Shared Steps" /> <WORKITEMTYPE name="Integration Build" /> </CATEGORY>將分類的定義檔匯入到您的 Team 專案。
witadmin importcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml