TFS upgrade - 手動重新設定Team專案(專案範本)

 ALM   Team Foundation Server  

▌背景

---

當升級TFS之後(這裡的經驗是TFS2010 →TFS2013 update 5)，可能會遇到Team專案範本無法正常使用的情況。  此時可執行設定功能精靈； 當然很不巧的，這次的升級並無法使用精靈，必須手動設定。 參考了MSDN這篇文章：使用手動更新程序新增功能 在幫助有限的情況下，留下這篇文章希望對其他人有幫助。 ▌環境 l   Windows2008 R2 l   Team Foundation Server 2013 Update 5 l   Visual Studio 2013 Update 5

▌Steps

---

步驟可分為

1.  下載專案流程範本。

2.  利用專案流程範本 import WIT(Work Item Type)回去我們的TFS專案。
過程中有可能需要更新WIT Field 的名稱。

3.  利用專案流程範本 import WIT的Categories回去我們的TFS專案。

4.  利用專案流程範本 import Proccess Conguration回去我們的TFS專案。

最後，設定一下Team專案。 (完成)

▋下載專案流程範本

可到微軟下載最新的專案流程範本。

或是開啟Visual Studio 的Team Explorer，【設定】→【流程範本管理員】→選擇後點選【下載】。

PS. 本篇將以Scrum 2013.5為例。

下載後，比較重要的是以下三個路徑下的XML：

Path	Usage
$\WorkItem Tracking\Process\ ProcessConfiguration.xml	用來定義專案範本的流程
$\WorkItem Tracking\ Categories.xml	WIT的列表及結構
$\WorkItem Tracking\TypeDefinitions\	資料夾底下都是WIT的定義

 

▋匯入專案流程範本的所有WIT

在方才下載回來的 $\WorkItem Tracking\TypeDefinitions\ 是所有 WIT的定義（WITD）。

請逐一利用以下的指令 import 到upgrade後的專案。

witadmin importwitd /collection:http://TfsServer:8080/tfs/defaultcollection /p:ProjectName /f:"…\WorkItem Tracking\TypeDefinitions\Feature.xml"

在匯入WITD時，有可能會出現以下錯誤訊息。

這表示在新的專案範本中，有一些WIT欄位（Field）和目前Team專案中已定義的Field名稱有衝突。

請手動下指令更改這些欄位的名稱：

witadmin changefield /collection:http://TfsServer:8080/tfs/defaultcollection /n:System.IterationId /name:"反覆項目 ID"

PS. 下列指令可列出所有Fields定義。

witadmin listfields /collection:http://TfsServer:8080/tfs/defaultcollection

重複以上步驟直到所有WITD被匯入到Team專案，否則下面步驟的Categories.xml會無法匯入。

▋匯入Categories

直接下以下指令:

witadmin importcategories /collection:http://TfsServer:8080/tfs/defaultcollection /p:ProjectName  /f:"…\WorkItem Tracking\Categories.xml"

▋匯入Process Configuration

witadmin importprocessconfig /collection:http://TfsServer:8080/tfs/defaultcollection /p:ProjectName  /f:"…/WorkItem Tracking/Process/ProcessConfiguration.xml"

▋設定Team 專案

回到Team專案入口網站，此時已可正常使用了!

不過需要重新設定目前小組的「反覆項目」和「區域」； 直接在portal設定即可。

完成以上設定後~~ It’s back!