2015年9月21日 星期一

[TFS] How to use Custom Controls from TFS WIT team

背景

如果你需要在TFS中客製化團隊的控制項,可以參考此篇文章:

對多數人來說這可不是一件簡單的工程 XD

當然如果直接使用官方的TFS WIT Custom Controls 步驟就簡單多了;
目前大家希望納入CheckboxMulti-values下拉式選單,
可直接安裝TFS WIT teamCodeplexWork Item Tracking Custom Controls來達成。

雖然使用別人寫好的Custom Controls步驟相對簡單,但是過程中會遇到一些地雷,因此記錄一下。

下載&安裝


進入Work Item Tracking Custom Controls首頁,馬上下載最新版的來使用!!
But … 如果是這樣,可能會踩到第一個雷。 

因為最新版可能只支援最新版的Team Foundation Server~
記錄本篇文章時,TFS 2015 RTM已發佈,目前首頁上最新的1.3.1.0只支援TFS2015
可是我目前使用的是TFS2013 所以必須要另外下載對應的版本!

Download the correct version

進入到「Download」, 仔細找一下符合自己的版本,TFS 2013的版本為1.2.2.0
利用右方的OTHER DOWNLOADS Release links下載對應的版本。


How to install it

下載回來後,解開後有兩個檔案:

1.  WitCustomControlSetup2013.msi
2.  CodePlex.WitCustomControls.MultiValueControl.zip

PS. File Name可能依據下載的版本而不同。


如果你有了解一下如何自己做控制項,可以打開.zip看一下裡面的東西~~


步驟如下:
l   請在TFS Server安裝.msi檔。
l   打開TFS Portal,進入管理介面後,在「擴充功能」安裝這些客製化控制項。記得路徑必須指向解壓縮後的另一個 .zip


安裝後,請啟用它。


以上步驟完成後, 可至
C:\ProgramData\Microsoft\Team Foundation\Work Item Tracking\Custom Controls

依據TFS的版本*,查看資料夾下是否至少有以下兩個檔案 ~


PS.
2013版本是C:\ProgramData\Microsoft\Team Foundation\Work Item Tracking\Custom Controls\12.0
2015版本是C:\ProgramData\Microsoft\Team Foundation\Work Item Tracking\Custom Controls\14.0


How to use it



Multi-Value Control

開啟Power Editor並加入一個新的Field
並在規則加入 Suggested Values 即為我們稍後的Multi-Values可複選下拉式選單的清單。




接著在Layout加入新的控制項,並指定對應欄位為上面建立的Field
Type選擇:MultiValueControl




存檔! 如果正確的話,你的WIT應該可正常顯示Multi-Value控制項了!BTW,儲存在資料庫是以逗號分隔的字串。




Checkbox Control

如果要建立Checkbox控制項更簡單,只要在建立Field時,Type選擇為 Boolean即可。




備註:
不過你如果使用Visual StudioTeam Explorer來管理工作的話,會發現Checkbox無法帶出,仍為Texbox 這時候就必須手動輸入“true” “false”




注意事項


使用Team Explorer的客戶端,必須安裝WIT Custom Controls套件

是的,如果平常是用Visual StudioTeam Explorer做工作管理
或是在local端使用Power Tool的使用者,除了TFS Server,本地端也必須安裝這一個套件。

但是只有使用TFS Portal的使用者則不必額外安裝。




排除無法載入組件的錯誤

在安裝後使用的過程中,開啟工作編輯畫面時如果你發現以下錯誤:


可以嘗試將
C:\ProgramData\Microsoft\Team Foundation\Work Item Tracking\Custom Controls\12.0
.dll .wicc 複製一份放在
C:\ProgramData\Microsoft\Team Foundation\Work Item Tracking\Custom Controls\

再重新啟動TFS Service;應該就可以排除了。



Reference






沒有留言:

張貼留言