カスタマイズの詳細手順

[アーティクル]
02/21/2013

テンプレートを使用して作成するすべてのチームプロジェクトがチームまたは組織で使用するビジネスプロセスに従うようにするには、プロセステンプレートをカスタマイズします。以前のリリースから Visual Studio Team Foundation Server をアップグレードし、引き続き使用する既存のプロセステンプレートに変更を加えた場合、プロセステンプレートをカスタマイズする場合があります。新しいプロセステンプレートに対するこれらの変更を追加または現在のリリースに用意されている機能を追加するために古いテンプレートをカスタマイズする場合があります。

プロセステンプレートをカスタマイズするには、まず、既存または空のプロセステンプレートをダウンロードし、ファイルを変更または追加して、プロセステンプレートファイルをアップロードします。次に、変更を検証します。次の図に、プロセステンプレートのカスタマイズで実行する主な 5 つのタスクの順序を示します。

プロセステンプレートのカスタマイズワークフロー

プロセステンプレートのカスタマイズは、反復的作業です。プロセステンプレートが正しくカスタマイズされているかどうかを確認するには、そのプロセステンプレートをテストできる Team Foundation Server を実行しているサーバーで定義されたチームプロジェクトコレクションが必要です。

ここでは、プロセステンプレートをカスタマイズするアクティビティをサポートするために推奨される手順の順序および操作上のヒントを示します。

[!メモ]

現在のリリースの Team Foundation Server にアップグレードすると、Team Foundation Server と共にインストールされていた Microsoft Solutions Framework (MSF) プロセステンプレートが新しいバージョンに置き換えられます。古いテンプレートをカスタマイズして同じ名前で保存していた場合、アップグレードの前にダウンロードしておかないと、新しいバージョンで置き換えられ、カスタマイズが失われます。

カスタマイズされたプロセステンプレートを更新して、最新バージョンの MSF テンプレートに基づくようにする場合は、手動で更新を行う必要があります。詳細については、「カスタマイズされたプロセステンプレートの更新による新機能の利用」を参照してください。

1.プロセステンプレートの選択とダウンロード

プロセステンプレートをカスタマイズする場合は、まず、カスタマイズするプロセステンプレートを選択します。必要な変更を最小限にするには、チームプロセスに最も近いテンプレートを選択する必要があります。通常は、作業項目とワークフローの種類に基づいてプロセステンプレートを選択します。Microsoft Solutions Framework (MSF) のプロセステンプレートの比較については、「プロセステンプレートの選択」を参照してください。

MSF プロセステンプレートおよび Microsoft のパートナーから提供されている追加のテンプレートの詳細については、Microsoft Web サイトの「プロセステンプレートとツール」を参照してください。

カスタマイズのベースとして使用する既存のプロセステンプレートをダウンロードします。カスタマイズの程度に応じて、空のテンプレートまたは完全にデザインされたテンプレートをダウンロードできます。プロセステンプレートをダウンロードするには、プロセステンプレートマネージャーを使用します。詳細については、「カスタマイズの詳細手順」を参照してください。

ページのトップへ

2.プロセステンプレートのカスタマイズ

プロセステンプレートのカスタマイズを開始する前に、次のセクションを参照して、その他の指針、推奨される順序、および便利なツールについて確認してください。

プロセステンプレートの変更の計画
ファイルの変更またはプロセスエディターの使用
作業の追跡用のオブジェクトの作成またはカスタマイズ
プラグインファイルのカスタマイズ
ルートプロセステンプレートファイルのカスタマイズ

ページのトップへ

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

プロセステンプレートはチームのプロセスのさまざまな構成要素に関連するので、加える変更を計画、調整、および追跡することをお勧めします。特に、作業項目トラッキング、レポート、Team Foundation ビルド、Team Foundation バージョン管理、Microsoft Test Manager、および Visual Studio Lab Management を変更する前にプロジェクトリーダー、テストリーダー、開発リーダー、およびリリースマネージャーに確認することをお勧めします。

作業を追跡するためのカスタマイズの指針とカスタマイズできるオブジェクトの概要については、「プロジェクトの追跡データ、フォーム、ワークフロー、その他のオブジェクトのカスタマイズ」を参照してください。便利なチェックリストについては、「チェックリスト: プロセステンプレートの計画と変更履歴の記録」を参照してください。

また、次の注意事項とヒントを確認してください。

ほとんどの Team Foundation オブジェクトの名前またはラベルに制限事項が適用されます。プロセステンプレート、セキュリティグループ、区分ノードとイテレーションノード、作業項目の種類、および作業項目フィールドに適用される名前付けの制限事項の概要については、「Team Foundation の名前付けの制限事項」を参照してください。
カスタマイズするほとんどのプロセステンプレートコンポーネントは、プロセステンプレートを使用して作成したチームプロジェクトにのみ影響します。この規則の例外は、作業項目の種類に対して定義されているグローバルリスト、リンクの種類、および作業項目フィールドです。これらのオブジェクトは、チームプロジェクトコレクションに対して定義されます。
チームプロジェクトを作成した後は、プロセステンプレートのほとんどの機能領域を変更できます。変更できない領域は、テストランナーおよび Microsoft Test Manager によって使用されるテスト解決状態だけです。詳細については、「テストマネージャーの初期構成の定義」を参照してください。
初めてプロセステンプレートをカスタマイズするときは、わずかな変更のみを行います。変更がテンプレートに及ぼす影響を十分に理解しないまま大量の変更を行うと、複数の誤りが発生する可能性があり、デバッグが困難になります。
プロセステンプレートの最大サイズは 2 GB です。プロセステンプレートをカスタマイズするときには、変更によってサイズがこの値を超えないよう注意してください。
作業項目の種類を追加または変更することに重点を置いている場合は、プロセステンプレート全体を変更せずにこの操作を実現できます。既存のチームプロジェクトを使用して変更を追加およびテストできます。witadmin exportwit と importwitd のコマンドラインツールを使用すると、作業項目の種類の XML 定義ファイルをダウンロードおよびアップロードできます。

詳細については、「作業項目の種類の追加とカスタマイズ」および「作業項目の種類のカスタマイズおよび管理 [witadmin]」を参照してください。

ページのトップへ

ファイルの変更またはプロセスエディターの使用

プロセステンプレートをカスタマイズするには、1 つ以上のプロセステンプレートファイルを変更して、チームプロジェクトコレクションへのファイルのアップロードを指定するタスクを追加または削除します。プロセステンプレートファイルを変更する際は、プラグイン要素間に存在する依存関係とオブジェクトおよび作業項目フィールドの名前付けに関する制限事項の依存関係を理解しておく必要があります。

軽微な変更を行う場合、XML 形式を使い慣れているときは、メモ帳などのテキストエディターを使用してファイルを変更できます。また、Visual Studio にアドインとしてインストールされるパワーツールであるプロセスエディターも使用できます。

[!メモ]

Microsoft Web サイトの次のページからのパワーツールをダウンロードできます: Team Foundation Server のパワーツール[.]

プロセスエディターには、プロセステンプレートのさまざまな領域のカスタマイズに使用できるユーザーインターフェイスが用意されています。このエディターを使用して、最新バージョンの MSF プロセステンプレートを変更できます。具体的には、このエディターを使用すると、次の領域をカスタマイズできます。

作業項目トラッキング:
- 作業項目の種類の定義を作成および編集します。
- 作業項目クエリを作成および編集し、クエリをクエリフォルダーに整理します。
- リンクの種類を作成および編集します。
- 作業項目の種類をグループ化するためのカテゴリを作成および編集します。
プロジェクトの分類と階層:
- 製品区分パスを作成および編集します。
- マイルストーンリリースまたはイテレーションパスを作成および編集します。
- Microsoft Project のマッピングファイルを変更します。
セキュリティグループ: Team Foundation Server のグループとアクセス許可を作成および編集します。
バージョンコントロール:
- チェックアウト設定を編集します。
- チェックインメモを作成および編集します。
- Team Foundation Server のグループとアクセス許可を作成および編集します。
ポータルとレポート:
- アップロードするファイルとそのフォルダー構造を確認します。
- アップロードするファイルを追加します。

ページのトップへ

作業の追跡用のオブジェクトの作成またはカスタマイズ

1 つ以上のオブジェクトをカスタマイズして作業項目を追跡することで、チームオブジェクトの追跡方法をカスタマイズしたり、ワークフロー、作業項目フォーム、およびデータフィールドを設計したりできます。次の図に示すように、グローバルワークフローを除くすべての種類のオブジェクトを作成またはカスタマイズできます。これらのオブジェクトに加え、作業項目クエリと作業項目インスタンスを定義できます。

作業項目トラッキングオブジェクト

これらのオブジェクトを定義またはカスタマイズする方法の詳細については、次のトピックを参照してください。

ページのトップへ

分類と作業項目クエリの依存関係

アジャイルソフトウェア開発用の MSF プロセステンプレートに対して定義されている作業項目クエリでは、Classification.xml ファイルで定義されているイテレーションノードが使用されます。イテレーションノードの定義を変更する場合は、その定義が依存している作業項目クエリも変更する必要があります。このようなクエリを見つけるには、.wiq ファイルで次のマクロを検索します。

イテレーション 1 = @@Iteration%201@@
イテレーション 2 = @@Iteration%202@@
イテレーション 3 = @@Iteration%203@@

ページのトップへ

作業項目オブジェクトの名前付けに適用される制限事項

各作業項目フィールドには、フィールド参照名が関連付けられています。フィールド参照名は各フィールドを一意に識別するもので、割り当てた後で変更することはできません。

また、作業項目フィールドには、レポート名を割り当てることができます。レポート名は、チームプロジェクトコレクションで定義されたすべての作業項目の種類で一致する必要があります。一致しない場合は、プロセステンプレートのアップロード時に検証エラーが発生するか、データウェアハウスデータベースで競合が発生する可能性があります。

作業項目フィールド名、リンクの種類の名前、およびグローバルリストのスコープは、チームプロジェクトコレクションとなります。これらのオブジェクトのいずれかをカスタマイズすると、変更は、コレクションで定義されているすべてのチームプロジェクトと、その作業項目フィールドを含む作業項目の種類に反映されます。

詳細については、「作業項目トラッキングオブジェクトの名前付け規則」を参照してください。

ページのトップへ

プラグインファイルのカスタマイズ

各プラグインファイルは、処理する 1 つ以上のタスクを指定し、独自のタスクのセットを実行します。アップロードするファイルを追加または削除する場合は、アップロードするファイルを指定するための対応するプラグインファイルでタスクを追加または削除してください。また、プラグインファイルで定義されているタスクの中には、依存関係を持つものもあります。変更を行った後でも、必ずすべての依存関係が満たされるようにします。詳細については、「プラグインを処理するタスクの定義」および「プラグインファイルのタスクグループとタスクの依存関係の定義」を参照してください。

次の表では、サポートされている 9 個のプラグインファイルをカスタマイズする場合に推奨される手順と、関連するタスクとトピックへのリンクを示します。

手順	タスク	メモと依存関係
	製品区分とマイルストーン、またはイテレーションを定義する。	区分は、作業項目を論理カテゴリ、物理カテゴリ、または機能カテゴリに整理するために定義します。イテレーションは、作業項目をマイルストーンや時間サイクルのカテゴリにグループ化するために定義します。分類プラグインはすべてのプロセステンプレートに必要です。
	既定のグループ、そのメンバー、およびアクセス許可を定義する。	コレクション、プロジェクト、区分やイテレーションパス、およびイベントサブスクリプションには、アクセス許可を設定できます。グループとアクセス許可のプラグインのタスクは、分類プラグインで定義されたタスクに依存する場合があります。
	作業の追跡用オブジェクト、作業項目クエリ、およびアップロードする作業項目インスタンスを指定する。	ファイルをアップロードするタスクを指定し、一定の順序でクエリを定義する必要があります (最初にリンクの種類、次に作業項目の種類、続いてクエリ)。これらのオブジェクトの各定義ファイルは、その前にあるタスクで指定された定義に依存します。通常は、カスタマイズしているプロセステンプレートで定義されているタスクの順序を維持します。作業項目の種類の定義は、分類プラグイン、グループ、およびアクセス許可の各プラグインに依存する場合があります。
	バージョンコントロール用の既定のポリシーおよびアクセス許可を定義する。	バージョンコントロールのプラグインをカスタマイズすると、チームプロジェクトの初期のアクセス許可、チェックアウトポリシー、およびチェックインノートを構成します。
	ビルド操作をサポートするための既定のビルドアクセス許可およびタスクを定義する。	ビルドプラグインをカスタマイズすると、チームプロジェクトの初期のアクセス許可および Team Foundation ビルドサービスで使用されるテンプレートファイルを構成できます。
	Microsoft テストマネージャーの初期構成を定義する。	テスト管理プラグインをカスタマイズすると、テスト変数や、テスト変数を組み合わせたテスト構成などの設定を定義できます。また、既定のテスト設定、および有効なテスト解決状態のリストをカスタマイズすることもできます。
	Lab Management の初期構成を定義する。	ラボのプラグインをカスタマイズすると、チームプロジェクトの初期のアクセス許可およびテンプレートファイルを構成できます。
	アップロードするレポートおよび [Reports] ノードのフォルダー構造を定義する。	アップロードする .rdl レポートのセットを変更できます。チームプロジェクトに [Reports] ノードを作成するには、レポートのプラグインが必要です。レポートのプラグインでは、チームプロジェクトを作成するチームプロジェクトコレクションが SQL Server Analysis Services および SQL Server Reporting Services で構成済みである必要があります。
	アップロードするドキュメント、作成するドキュメントライブラリ、およびアクティブにする SharePoint 機能を定義する。	アップロードするドキュメントのセット、およびアクティブにする機能は変更できます。チームプロジェクトに [ドキュメント] ノードを作成するには、ポータルのプラグインが必要です。ポータルのプラグインでは、チームプロジェクトを作成するチームプロジェクトコレクションが、SharePoint 製品で構成済みである必要があります。

ページのトップへ

ルートプロセステンプレートファイルのカスタマイズ

新しいチームプロジェクトウィザードで実行されるタスクの順序は、ProcessTemplate.xml ファイルおよびそのファイルで呼び出されるプラグインファイルで定義されているグループ化されたタスクの順序によって決まります。詳細については、「プロセステンプレートプラグインファイルを使用したルートタスクの定義」を参照してください。次の表に、MSF 用のプロセステンプレートで定義されている順序を示します。

アジャイルプラグインの順序	CMMI プラグインの順序
Classification.xml GroupsandPermissions.xml WorkItems.xml VersionControl.xml Build.xml Lab.xml TestManagement.xml ReportsTasks.xml WssTasks.xml	Classification.xml GroupsandPermissions.xml WssTasks.xml ReportsTasks.xml WorkItems.xml VersionControl.xml Lab.xml TestManagement.xml Build.xml

各プラグインファイルで各タスクを配置する順序を依存関係に合わせると、依存関係の欠落に関する問題が発生しなくなります。

ページのトップへ

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

プロセステンプレートは、チームプロジェクトコレクションにアップロードします。他のチームプロジェクトで使用されていないチームプロジェクトコレクションを使用することが理想的です。テストベッドのプロジェクトコレクションで作業すると、開発中の既存のチームプロセスと衝突する可能性がある変更を行わずに済みます。また、プロジェクトポータルやレポートサイトなど、チームメンバーにアクセスさせるリソースと同じリソースをチームプロジェクトコレクションでサポートできます。

プロセステンプレートの名前は固有のものにします。チームプロジェクトコレクションからダウンロードして変更を行ったプロセステンプレートをアップロードする場合は、名前を変更するか、既存のプロセステンプレートをチームプロジェクトコレクションから削除する必要があります。

アップロードプロセスでは、検証チェックを実行して XML が有効であることを確認します。プロセステンプレートをアップロードしようとしてエラーが発生する場合は、加えた変更がエラーの原因となっています。変更を確認し、XML 構文エラーがある場合は修正します。

詳細については、「カスタマイズの詳細手順」を参照してください。

ページのトップへ

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

プロセステンプレートをアップロードしたら、変更を検証するためにチームプロジェクトを作成します。新しいチームプロジェクトウィザードを実行し、テスト用のチームプロジェクトを作成します。エラーが発生した場合は、チームプロジェクト作成ログを確認します。ここには、実行しようとしたタスクのリストが含まれており、どのタスクが失敗したかが示されます。失敗したタスクを XML に対応させて、エラーの原因を調べます。

詳細については、「チームプロジェクトの作成」を参照してください。

新しいプロセステンプレートをテストするには、チームプロジェクトを作成する必要があります。必要がなくなったチームプロジェクトは、TFSDeleteProject コマンドラインツールを使用して削除できます。詳細については、「チームプロジェクトの削除 [TFSDeleteProject]」を参照してください。

ページのトップへ

5.変更の検証

チームプロジェクトを正常に作成したら、変更が正しいかどうかをそのチームプロジェクトで検証するという追加手順も行います。レポートを追加した場合は、チームエクスプローラーにそのレポートが表示されることを確認します。作業項目の種類を削除した場合は、その種類の作業項目が使用できなくなっていることを確認します。

ページのトップへ

参照

処理手順

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

概念

プロセステンプレートファイルの操作

プロセステンプレートの管理

プロセステンプレートのカスタマイズ

Share via

カスタマイズの詳細手順

1.プロセステンプレートの選択とダウンロード