team foundation server プロセステンプレートの変更 手順書

Team Foundation Server プロセステンプレートの変更 手順書

日本マイクロソフト株式会社

開発ツール推進部

武田 正樹 Masaki.Takeda@microsoft.com

最終更新日 : 2016 年 2 月 24 日

2

事前準備

本資料では、以下のソフトウェアを利用しています。

Visual Studio 2015 Update 1 Team Foundation Server 2015 Update 1 Microsoft Visual Studio Team Foundation Server 2015 Power Tools (Power Tools)

https://visualstudiogallery.msdn.microsoft.com/898a828a-af00-42c6-bbb2-530dc7b8f2e1

3

• Visual Studio 上でプロセステンプレートの追加、変更、削除が GUI で可能

Power Tools

プロセステンプレートのダウンロード

5

1. Visual Studio 2015 で Team Foundation Server 2015 が接続されていることを確認して、 [ チームエクスプローラー ] 内の [ チームプロジェクト名 ] をクリックします。2. [ 設定 ] をクリックします。3. [ チーム プロジェクト コレクション ] の [ プロセステンプレート マネージャー ] をクリックします。

プロセステンプレートのダウンロード (1)

1

2

3

6

1. 今回は CMMI テンプレートをカスタマイズします。 [CMMI] をクリックします。2. [ ダウンロード ] をクリックします。

プロセステンプレートのダウンロード (2)

12

7

1. プロセステンプレートのダウンロード先を [ デスクトップ ] に指定し、 [ フォルダーの選択 ] をクリックします。2. ダウンロードが完了すると、 [ プロセス テンプレートは正常にダウンロードされました。 ] というポップアップウ

インドウが表示されます。 [OK] をクリックして、ポップアップウインドウを閉じます。

プロセステンプレートのダウンロード (3)

1

2

8

1. [ 閉じる ] をクリックして、ウインドウを閉じます。

プロセステンプレートのダウンロード (4)

1

プロセステンプレートのGUID 変更

10

標準搭載されているプロセステンプレート [Agile], [Scrum], [CMMI] を上書きすることはできませんので、別のプロセステンプレートとしてアップロードする必要があります。具体的には、 [ProcessTemplate.xml] の GUID を変更すると別のプロセステンプレートとしてアップロード可能になります。

1. [ デスクトップ ] にある [CMMI] フォルダを開き、 [ProcessTemplate.xml] を メモ帳で開きます。

プロセステンプレートの GUID 変更 (1)

1

11

1. XML ファイル内の GUID を確認します。 [ProcessTemplate.xml] の 6 行目にあることを確認します。

プロセステンプレートの GUID 変更 (2)

1

12

Visual Studio で簡単に GUID を新規作成できます。1. Visual Studio のメニューから [ ツール ] をクリックします。2. [GUID の作成 ] をクリックします。3. GUID 作成画面が表示されます。 [6. <Guid(“...] を選択します。4. [ コピー ] をクリックして、 GUID をコピーします。5. [ 終了 ] をクリックして、 GUID 作成画面を閉じます。

プロセステンプレートの GUID 変更 (3)

2

1

3

4

5

13

1. コピーした新 GUID を [ProcessTemplate.xml] に貼り付けます。 貼り付けると [<Guid(“...] のようになりますが、 以下のように GUID 以外の [<Guid(“] と [”)>] を削除します。

2. プロセステンプレートの名前を [CMMI] から [ カスタムテンプレート ] に変更します。3. プロセステンプレートの概要を [ デモ用にテンプレートをカスタマイズしています。 ] に変更します。4. メニュー [ ファイル ] – [ 上書き保存 ] の順にクリックし、 [ProcessTemplate.xml] を保存してからメモ帳を閉じま

す。

プロセステンプレートの GUID 変更 (4)

1

23

4

ワークアイテムの変更

15

ワークアイテムの編集作業は、 Power Tools を使うと GUI で操作することができます。1. エクスプローラーで デスクトップの CMMI フォルダにある [ProcessTemplate.xml] を右クリックします。2. [ プログラムから開く ] をクリックします。3. [Microsoft Visual Studio 2015] をクリックします。

ワークアイテムの変更 (1)

2

3

1

16

Visual Studio が起動し、 Power Tools の画面が表示されます。今回はワークアイテム [ 必要条件 ] を編集します。1. [Type Definitions] をクリックします。2. ワークアイテムの一覧が表示されます。 [ 必要条件 ] をクリックします。3. [Edit] をクリックします。

ワークアイテムの変更 (2)

3

1

2

17

ワークアイテム [ 必要条件 ] に関する編集画面が表示されます。今回はワークアイテムの名前の変更と項目追加をします。1. ワークアイテムの名前を変更します。 [Name] の内容を [ 必要条件 ] から [ 中項目 ] に変更します。2. ワークアイテムの項目を追加します。 [New] をクリックします。

ワークアイテムの変更 (3)

1

2

18

項目定義に関するポップアップウインドウが表示されます。今回はドロップダウンリスト形式で値を選択できる [ 難易度 ] という項目を追加します。1. 項目の表示名を指定します。 [Name] には [ 難易度 ] と入力します。2. データベースに格納される際のスキーマ名を指定します。 [Reference Name] には [Custom.Demo] と入力します。

ワークアイテムの変更 (4)

1

2

19

続いて、ドロップダウンリストで選択できる値を定義します。1. [Rules] タブをクリックします。2. [New] をクリックします。3. ルール形式を選択するポップアップウインドウが表示されます。 [ALLOWEDVALUES] を選択します。4. [OK] をクリックして、ポップアップウインドウを閉じます。

ワークアイテムの変更 (5)

1

23

4

20

ALLOWEDVALUES に関するポップアップウインドウが表示されます。ここにドロップダウンで選択できる値を入力します。1. [New] をクリックします。2. 値を入力するためのポップアップウインドウが表示されます。 [ 初心者向け ] と入力します。3. [OK] をクリックして、ポップアップウインドウを閉じます。4. [ALLOWEDVALUES] のウインドウに [ 初心者向け ] と入力されていることを確認します。

ワークアイテムの変更 (6)

31

2

4

21

1. 前頁の [ ワークアイテムの変更 (6)] の操作を行い、 ALLOWEDVALUES ウインドウに [ 中級者向け ] と [ 上級者向け ] を追加します。

2. [OK] をクリックして、 ALLOWEDVALUES ウインドウを閉じます。3. 項目定義に関するポップアップウインドウに戻ります。 [OK] をクリックして、ウインドウを閉じます。

ワークアイテムの変更 (7)

3

1

2

22

1. ワークアイテム [ 必要条件 ] に関する編集画面に、 [ 難易度 ] という名前の項目が追加されていることを確認します。

ワークアイテムの変更 (8)

1

23

ワークアイテムの項目を追加しましたが、ワークアイテムの編集画面にも追加する必要があります。

1. [Layout] タブをクリックします。

ワークアイテムの変更 (9)

1

24

1. [Preview Form] をクリックします。2. ワークアイテムのプレビューウインドウが表示されます。今回は、 [ 状態 ] グループに先ほど作成した [ 難易度 ] を

追加します。確認したら [X] をクリックして、プレビューウインドウを閉じます。3. [Group 状態 ] の下にある [Column] を右クリックします。4. [New Control] をクリックします。

ワークアイテムの変更 (10)

1

2

3

4

25

1. 状態グループに [ 難易度 ] の項目を追加します。 [Field Name] には、 [Custom.Demo] を選択します。そして、 [Label] には、 [ 難易度 ] と入力します。

2. [ すべて保存 ] ボタンをクリックして、ファイルを保存します。3. [Preview Form] をクリックします。

ワークアイテムの変更 (11)

2

1

3

26

1. 状態グループに [ 難易度 ] の項目が追加されていることを確認します。2. 確認したら [X] をクリックして、プレビューウインドウを閉じます。

ワークアイテムの変更 (12)

2

1

27

今回は [ 必要条件 ] のワークアイテムの名前も変更しているため、このままプロセステンプレートをアップロードするとチームプロジェクトの作成時にエラーとなります。 [Process Settings] にある [ 必要条件 ] も変更する必要があります。1. [ProcessTemplate.xml] タブをクリックします。2. [Process Settings] をクリックします。3. [RequirementBacklog] タグの中にある [pluralName] と [singularName] の [ 必要条件 ] を [ 中項目 ] に変更

します。

ワークアイテムの変更 (13)

3

1

2

28

1. 同じく [Process Settings] にある [WorkItemColors] タグの中にある [name=“ 必要条件” ] を [name=“ 中項目” ] に変更します。

2. [ すべて保存 ] ボタンをクリックします。

ワークアイテムの変更 (14)

1

2

Microsoft Project との連携設定変更

30

Microsoft Project で Team Foundation Server のワークアイテム情報と連携させると、開始日・終了日が空欄になります。これは、 プロセステンプレートのデフォルト設定で、 Microsoft Project からの Publish しか許可していないためです。プロセステンプレートを編集することで、この問題を解決することができます。1. エクスプローラーで デスクトップの CMMI フォルダにある [Classification] フォルダの [FieldMapping.xml] を右

クリックします。2. [ プログラムから開く ] をクリックします。3. [ メモ帳 ] をクリックします。

開始日・終了日を MS Project で表示するための設定 (1)

2

3

1

31

1. [Microsoft.VSTS.Scheduling.StartDate] と [Microsoft.VSTS.Scheduling.FinishDate] の [PulishOnly] の値を [true] から [false] に変更します。

2. メニュー [ ファイル ] – [ 上書き保存 ] の順にクリックして、ファイルを保存します。

開始日・終了日を MS Project で表示するための設定 (2)

2

1

32

作成済みのチームプロジェクトの場合は、データベースを直接変更します。 コレクション [DefalutCollection] のあるチームプロジェクトに対する SQL 文は下記のようになります。チームプロジェクトの ID は、 [dbo.tbl_projects] に格納されています。

開始日・終了日を MS Project で表示するための設定 (3)

USE [Tfs_DefaultCollection]

UPDATE [dbo].[tbl_project_properties] SET [value] = '<?xml version="1.0" encoding="utf-8"?><MSProject> <Mappings> <!-- MS Project calculation engine because of the order of the following mapped fields. To make sure the right calculation result, the following fields must appear in this mapping file in the order respectively: Resource Name, Start Date, Finish Date, Completed Work, Remaining Work --> <Mapping WorkItemTrackingFieldReferenceName="System.AreaPath" ProjectField="pjTaskOutlineCode9" /> <Mapping WorkItemTrackingFieldReferenceName="System.AssignedTo" ProjectField="pjTaskResourceNames" /> <Mapping WorkItemTrackingFieldReferenceName="System.Id" ProjectField="pjTaskText10" ProjectName="作業項目 ID" /> <Mapping WorkItemTrackingFieldReferenceName="System.IterationPath" ProjectField="pjTaskOutlineCode10" /> <Mapping WorkItemTrackingFieldReferenceName="System.Reason" ProjectField="pjTaskText14" /> <Mapping WorkItemTrackingFieldReferenceName="System.Rev" ProjectField="pjTaskText23" /> <Mapping WorkItemTrackingFieldReferenceName="System.State" ProjectField="pjTaskText13" ProjectName="状態 " /> <Mapping WorkItemTrackingFieldReferenceName="System.Title" ProjectField="pjTaskName" /> <Mapping WorkItemTrackingFieldReferenceName="System.WorkItemType" ProjectField="pjTaskText24" /> <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Common.Priority" ProjectField="pjTaskText19" ProjectName="作業項目の優先度 " /> <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Common.Discipline" ProjectField="pjTaskText17" /> <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Common.StackRank" ProjectField="pjTaskNumber1" /> <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.StartDate" ProjectField="pjTaskStart" PublishOnly="false" /> <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.FinishDate" ProjectField="pjTaskFinish" PublishOnly="false" /> <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.OriginalEstimate" ProjectField="pjTaskBaselineWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" /> <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.CompletedWork" ProjectField="pjTaskActualWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" /> <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.Scheduling.RemainingWork" ProjectField="pjTaskRemainingWork" ProjectUnits="pjHour" IfSummaryRefreshOnly="true" /> <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.CMMI.RequirementType" ProjectField="pjTaskText27" /> <Mapping WorkItemTrackingFieldReferenceName="Microsoft.VSTS.CMMI.Probability" ProjectField="pjTaskText28" /> <LinksField ProjectField="pjTaskText26" /> <SyncField ProjectField="pjTaskText25" /> </Mappings></MSProject>' WHERE [name]= 'MSPROJ' and [project_id] = '97F2E5E5-4844-4F47-B61D-9266B90637F3'

実施の場合は必ずバックアップを！！

プロセステンプレートのアップロード

34

編集したプロセステンプレートをアップロードします。1. Visual Studio 2015 で Team Foundation Server 2015 が接続されていることを確認して、 [ チームエクスプローラー ] 内の [ チームプロジェクト名 ] をクリックします。2. [ 設定 ] をクリックします。3. [ チーム プロジェクト コレクション ] の [ プロセステンプレート マネージャー ] をクリックします。

プロセステンプレートのアップロード (1)

1

2

3

35

1. [ アップロード ] をクリックします。

プロセステンプレートのアップロード (2)

1

36

1. デスクトップにある CMMI フォルダを指定し、 [ フォルダーの選択 ] をクリックします。2. アップロードが完了すると、 [ プロセス テンプレートは正常にアップロードされました。 ] というポップアップウ

インドウが表示されます。 [OK] をクリックして、ポップアップウインドウを閉じます。

プロセステンプレートのアップロード (3)

1

2

37

1. アップロードされた [ カスタムテンプレート ] がプロセステンプレートの一覧にあることを確認します。

2. [ 閉じる ] をクリックして、ウインドウを閉じます

プロセステンプレートのアップロード (4)

1

2

チームプロジェクトの作成

39

Team Foundation Server のチームプロジェクトは、 Visual Studio からのみ作成できます。1. Team Foundation Server 2015 が接続されていることを確認して、 [ チームエクスプローラー ] 内

の [ チームプロジェクト名 ] をクリックします。2. [ プロジェクトと担当チーム ] をクリックします。3. [ 新しいチーム プロジェクト ] をクリックします。

チームプロジェクトの作成 (1)

2

3

1

40

チームプロジェクト作成ウイザードが表示されます。1. [ チームプロジェクトの名前 ] を [ テンプレートの確認 ] と入力します。2. [ 次へ ] をクリックします。3. 先ほどアップロードした [ カスタムテンプレート ] を選択します。4. [ 次へ ] をクリックします。

チームプロジェクトの作成 (2)

2

1

4

3

41

1. [ チームプロジェクトのバージョン管理システム ] を [Team Foundation バージョン管理 ] を選択します。2. [ 完了 ] をクリックします。3. チームプロジェクトの作成が完了します。 [ 閉じる ] をクリックしてウイザードを閉じます。

チームプロジェクトの作成 (3)

2

1

3

変更されたワークアイテムの確認

43

作成したチームプロジェクトで、ワークアイテムが変更されていることを確認します。1. [ ホーム ] アイコンをクリックします。2. [Web ポータル ] をクリックします。

変更されたワークアイテムの確認 (1)

2

1

44

1. Web ポータルが開きます。 [WORK] をクリックして、ワークアイテム管理画面に移動します。2. [ 中項目 ] となっており、 [ ワークアイテムの変更 (13)] で変更した名称変更が反映されていることを確認します。3. [ 中項目 ] となっており、 [ ワークアイテムの変更 (3)] で変更した名称変更が反映されていることを確認します。4. ワークアイテムを作成して、その項目に [ 難易度 ] が含まれていることを確認します。 [小項目 ] と入力します。5. [ 追加 ] をクリックして、ワークアイテムを作成します。

変更されたワークアイテムの確認 (2)

2

1

3

4 5

45

1. [小項目 ] というワークアイテムが作成されますので、ダブルクリックします。

変更されたワークアイテムの確認 (3)

1

46

ワークアイテムの編集画面が表示されます。1. [ 難易度 ] の項目が [ 状態 ] グループ内にあり、ドロップダウン形式になっていることを確認します。2. [ 閉じる ] をクリックします。

変更されたワークアイテムの確認 (4)

1

2

Active Directory との人名の同期の実行

48

ワークアイテム項目を Excel で表示した際に、人名を表示する欄が [ 名前 <Domain\User>] と表示される場合があります。

これは、プロセステンプレートのカスタマイズの時にでワークアイテム項目に赤枠の設定が入っていないためです。(例 ) WorkItem Tracking\TypeDefinitions\Requirement.xml のワークアイテム項目 ”領域の専門家 2”

新規 RefName でプロセステンプレートをカスタマイズする場合には、上記のように [syncnamechanges] を [true] と設定すればいいのですが、一度 RefName をアップロードすると Team Foundation Server のデータべースに RefName が登録されてしまうためプロセステンプレートをカスタマイズでは対応できなくなります。

回避策として、これからご紹介する witadmin.exe コマンド実行によってワークアイテム項目 (厳密には RefName) の設定を変更する必要があります。

Active Directory との人名の同期 (1)

49

witadmin.exe はデフォルトで下記フォルダにあります。

witadmin.exe コマンド実行で Active Directory との人名の同期をするには、下記のようなコマンドを実行します。

例えば、 [CollectionURL] が [http://tfsdemo1:8080/tfs/DefaultCollection] で、 [RefName] が [Microsoft.VSTS.CMMI.SubjectMatterExpert2] の場合は、以下のようなコマンドになります。

Active Directory との人名の同期 (2)

C:\Program Files(x86)\Microsoft Visual Studio 14.0\Common7\IDE

witadmin.exe changefield /collection:CollectionURL /n:RefName /syncnamechanges:true

witadmin.exe changefield /collection:http://tfsdemo1:8080/tfs/DefaultCollection /n:Microsoft.VSTS.CMMI.SubjectMatterExpert2 /syncnamechanges:true

50

witadmin.exe 実行後に、 Excel を更新すると Active Directory との人名の同期がされるとことが確認できます。

注意 !!・一度 [RefName] の [syncnamechanges] を [true] に変更すると、二度と [false] に戻せなくなります。　（戻す必要はないと思われますが、念のため）

Active Directory との人名の同期 (3)

チェックインポリシーの設定

52

チェックインポリシーは、基本 Visual Studio 上で設定します。1. Visual Studio 2015 で Team Foundation Server 2015 が接続されていることを確認して、 [ チームエクスプローラー ] 内の [ チームプロジェクト名 ] をクリックします。2. [ 設定 ] をクリックします。3. [ チーム プロジェクト ] の [ ソース管理 ] をクリックします。

チェックインポリシーの設定 (1)

1

2

3

53

ソース管理の設定に関するポップアップウインドウが表示されます。今回はチェックインの際に作業項目の関連付けを必須にします。1. [ チェックインポリシー ] タブをクリックします。2. [ 追加 ] をクリックします。

チェックインポリシーの設定 (2)

1

2

54

チェックインポリシーの追加に関するポップアップウインドウが表示されます。1. [ 作業項目 ] を選択します。2. [OK] をクリックして、ウインドウを閉じます。

チェックインポリシーの設定 (3)

1

2

55

1. チェックインポリシーに [ 作業項目 ] が追加されている事を確認します。2. [OK] をクリックして、ウインドウを閉じます。

チェックインポリシーの設定 (4)

1

2

56

以上でチェックインポリシーの設定は完了です。チェックイン時に作業項目が関連付けされていない場合は、下記のような警告が表示されます。

チェックインポリシーの設定 (5)

プロセステンプレートの削除

58

アップロードしたプロセステンプレートはもちろん削除可能です。1. Visual Studio 2015 で Team Foundation Server 2015 が接続されていることを確認して、 [ チームエクスプローラー ] 内の [ チームプロジェクト名 ] をクリックします。2. [ 設定 ] をクリックします。3. [ チーム プロジェクト コレクション ] の [ プロセステンプレート マネージャー ] をクリックします。

プロセステンプレートの削除 (1)

1

2

3

59

1. 削除するテンプレートを選択します。今回は [ カスタムテンプレート ] をクリックします。2. [ 削除 ] をクリックすると、テンプレートが削除されます。なお、 [Agile], [Scrum], [CMMI] は削除できません。3. [ 閉じる ] をクリックして、ウインドウを閉じます

プロセステンプレートの削除 (2)

1

2

3

ワークアイテムの独自クエリ作成

61

プロセステンプレートの独自クエリの反映

プロセステンプレートの独自クエリの反映することは可能ですが、あまりお勧めしません。

Power Tools で編集する場合でも、 SQL 文の作成が必要になります。

Excel や Web ポータルなどの GUI の方がお手軽です。

Web ポータル Power Tools