Thursday, September 3, 2015

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!






















No comments:

Post a Comment