プロセス構成 XML 要素のリファレンス
プロセスの構成では、チームがアジャイル計画ツールを使用してアクセスできる既定の構成および機能を定義します。
Team Web Access (TWA) を介して表示されるこれらのツールは、プロセス構成 XML 定義ファイルの PortfolioBacklog、RequirementBacklog、および TaskBacklog セクションに加えられる構成に基づいて、フィルター処理された作業項目のセットを表示します。 また、プロセスの構成では、マッピングを必要とするすべての作業項目の種類 (WIT) について、ワークフローの状態とメタ状態とのマッピングを定義します。
詳細については、「チーム プロジェクトに合わせたアジャイル プランニング ツールの構成とカスタマイズ」を参照してください。
カスタマイズ可能な区分:
バックログ ページを構成する
作業項目の種類のカテゴリに対してメタ状態をマップする
既定の列と列の順序をカスタマイズする
クイック追加パネルをカスタマイズする
タスク ボードに表示できる作業項目の数を変更する
ツール特有の作業項目の種類に対してメタ状態をマップする
アジャイル計画ツールとグラフで使用されるフィールドを割り当てる
週末の曜日を指定する
作業項目の種類の色を変更する
プロセスの構成を更新するには、XML 定義ファイルをエクスポートして編集した後、ファイルをインポートします。 witadmin コマンド ライン ツールを使用して、このファイルをインポートおよびエクスポートします。
注意
このトピックで示す構文のサンプルは、Visual Studio Scrum 2013 のプロセス テンプレートで定義されている既定の割り当てに対応しています。プロセス テンプレートの最新バージョンにアクセスするには、TFS の最新バージョンをインストールし、プロセス テンプレート マネージャーを使用してテンプレートをダウンロードします。
バックログ ページを構成する
バックログ ページには、プロダクト バックログ、イテレーションまたはスプリント バックログ、ポートフォリオ バックログの 3 つの種類があります。 各バックログ ページは、次の方法でカスタマイズできます。
メタ状態のマッピング: ワークフロー状態をメタ状態にマップします。 これらのマッピングは、かんばんボードとタスク ボードを含む、すべてのアジャイル計画ページの表示をサポートします。
クイック追加パネル: 簡単に項目をバックログに追加するために表示される WIT および作業項目フィールドを指定します。
バックログ項目またはタスクと見なされる作業項目の種類を変更するには、対応するカテゴリに作業項目の種類を追加します。 例については、「タスク ボードまたはバックログへのバグの追加」を参照してください。
列フィールド: 既定のフィールドと列の順序を定義します。
次の例に示す XML のセクションでバックログ ページを構成します。
<PortfolioBacklogs>
<PortfolioBacklog category="Microsoft.FeatureCategory" pluralName="Features" singularName="Feature">
. . .
</PortfolioBacklog>
</PortfolioBacklogs>
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName=" Backlog items" singularName=" Backlog item">
. . .
</RequirementBacklog>
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task">
. . .
</TaskBacklog>
要素 |
説明 |
---|---|
PortfolioBacklogs |
省略可能です。 ポートフォリオ バックログ ページのコンテナー要素。 |
PortfolioBacklog |
省略可能です。 最大 5 個のインスタンス。 ポートフォリオ バックログ ページのメタ状態のマッピング、既定の列、およびクイック追加パネルを定義するコンテナー要素。
次のように属性に値を割り当てます。
|
RequirementBacklog |
必ず指定します。 1 個のインスタンスだけです。 プロダクト バックログ ページのメタ状態のマッピング、既定の列、およびクイック追加パネルを定義するコンテナー要素。 プロダクト バックログでは、チームのバックログのアクティブな項目がすべて表示されます。
|
TaskBacklog |
必ず指定します。 1 個のインスタンスだけです。 特定のイテレーションに割り当てられた作業項目を表示するページのレイアウトをカスタマイズするために使用されるコンテナー要素。
既定では、タスク ボードは合計 500 の作業項目に制限されています。 workItemCountLimit 属性の値を指定することで、この制限を変更できます。 |
実装に関するメモ
CategoryName に割り当てる値は、チーム プロジェクト用に定義されたカテゴリ グループに対応している必要があります。 カテゴリの定義ファイルでカテゴリ グループを指定します。 詳細については、「カテゴリ XML 要素リファレンス」を参照してください。
バックログ項目のロールアップを低いレベルで表示し、複数のチーム全体の進行状況を表示するには、ポートフォリオ バックログを使用します。 新しい、アップグレードされたチーム プロジェクトには、1 つのレベルのラベル付き機能が含まれています。 最大 4 つのレベルを追加できます。
注意
ポートフォリオ ページの使用には、上級のアクセス許可が必要になることがあります。詳細については、「アクセス レベルの変更」を参照してください。
ポートフォリオ バックログ ページの使用方法については、「ポートフォリオ バックログの使用」を参照してください。
プロダクト バックログは、開発している製品の要件の一覧を表します。 バックログ項目は、プロダクト バックログ項目、ユーザー ストーリー、要件など、チーム プロジェクトを作成するために使用されるプロセス テンプレートに基づいて、特定の作業項目の種類に対応します。 さまざまな作業項目の種類を使用する場合や、複数の作業項目の種類を使用して要件をキャプチャする場合は、プロダクト バックログ ページをカスタマイズしてこれらの使用法をサポートできます。
プロダクト バックログ ページの使用方法の詳細については、「バックログの作成」を参照してください。
スプリントまたはイテレーション バックログ ページには、自分自身およびチームが特定のイテレーション サイクルでコミットした要件およびそれらの要件にリンクしたタスクの両方が表示されます。 タスクは、子リンクの種類を使用して要件にリンクする必要があります。 これらのページに表示される作業項目の種類がプロダクト バックログ ページに表示される同じ種類に対応するため、プロダクト バックログ ページに対するカスタマイズ作業の多くによって、タスク バックログ ページの機能が定義されます。
スプリント バックログ ページの使用方法の詳細については、「スプリントでの作業」を参照してください。
メタ状態へのワークフロー状態のマップ
ほとんどの WIT では、ワークフロー状態をメタ状態にマップする必要があります。 ワークフロー状態では、作業項目が最初のアクティブ化または作成から終了または完了に移行する方法を定義します。 たとえば、スクラム プロダクト バックログ項目に対して定義された状態は、4 つの状態の進行状況 (新規作成、承認済み、コミット済みから完了まで) を定義し、実装されずにバックログから削除された状態に対応する 5 番目の状態である削除済みも含みます。
一方、メタ状態は、アジャイル計画ツールによる各ワークフロー状態の処理方法を決定します。 バックログとタスク ボードで使用される主なメタ状態は、Proposed、InProgress、および Complete です。
メタ状態に各ワークフロー状態を関連付けることで、バックログおよびタスク ボードを表示するために実行されるバックグラウンド操作で、各作業項目の状態を正しく解釈する方法が認識されます。 たとえば、スクラム プロダクト バックログ ページについては、次のマッピングが定義されています。
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Backlog items" singularName="Backlog item">
<States>
<State value="New" type="Proposed" />
<State value="Approved" type="Proposed" />
<State value="Committed" type="InProgress" />
<State value="Done" type="Complete" />
</States>
. . .
</RequirementBacklog >
メタ状態には、アジャイル、バグ、フィードバックの 3 つのカテゴリがあります。 次の表に、マッピング属性と値の説明を示します。
要素 |
説明 |
---|---|
State |
必ず指定します。 メタ状態にワークフロー状態を割り当てます。
TypeName の有効値は、カテゴリ グループに割り当てられた WIT の WORKFLOW セクション内の STATE に割り当てられる値に対応します。 ValueName の有効値は、次の列挙値のいずれかに対応します。
|
States |
WIT のワークフロー状態をメタ状態に関連付ける State 要素のコレクションを指定します。 次の親要素に必須の要素。
|
既定の列と列の順序をカスタマイズする
バックログ ページを表示するページの列の追加や削除、列の順序の変更、または列幅の変更を行うことができます。 [列のオプション] ダイアログでページに変更を加えた場合、それらの変更内容は再度変更するまで保持されます。 コードの次のセクションでは、既定の列セットと順序を簡単に定義します。
<Columns>
<Column refname="Microsoft.VSTS.Common.Priority" width="400" />
<Column refname="System.Title" width="400" />
<Column refname="System.State" width="100" />
<Column refname="Microsoft.VSTS.Scheduling.Effort" width="50" />
<Column refname="System.IterationPath" width="200" />
</Columns>
要素 |
説明 |
---|---|
Columns |
Column の要素のコレクションを指定します。 バックログ ページの要素に必須の要素: PortfolioBacklog、RequirementBacklog、および TaskBacklog。 |
Column |
フィールドがバックログ ページの列として表示されるように指定します。
|
タスク ボードの列見出し
タスク ボード ページに表示される列ヘッダーは、タスク カテゴリに割り当てられる既定の WIT に割り当てられるワークフロー状態に対応します。 列の順序は、左から右に移動するワークフローの遷移の自然な進行に対応します。 列のレイアウトを変更するには、タスク カテゴリに割り当てられる WIT のワークフローを変更します。 タスク カテゴリの既定のタスクの種類に対して定義されたワークフロー状態は、「作業項目の種類のカテゴリに対してメタ状態をマップする」で説明されているように、有効なメタ状態に割り当てられている必要があります。
クイック追加パネルをカスタマイズする
クイック追加パネルのフィールドを追加できます。 たとえば、次の例では、プロダクト バックログ パネルに [ビジネス価値] を追加します。
パネルには、選択された WIT の WIT 定義の FIELDS セクションに含まれているフィールドのみが表示されます。 たとえば、バグの WIT を選択すると、バグにはビジネス価値が定義されていないため、タイトルのみが表示されます。 パネルに別の WIT を追加するには、ここで説明されているように、要件カテゴリに追加します。
次のコードは、Visual Studio Scrum および MSF for Agile のプロセス テンプレートで定義されている既定の割り当てに対応しています。
<AddPanel>
<Fields>
<Field refname="System.Title" />
</Fields>
</AddPanel>
要素 |
説明 |
---|---|
AddPanel |
"クイック追加" エクスペリエンス (新しいバックログ項目が定義されたパネル領域内にフィールドが表示される) を指定するために使用されるコンテナー要素。 |
Fields |
Field の要素のコレクションを指定します。 |
Field |
作業項目フィールドがプロダクト バックログ ページのパネル内に表示されるように指定します。
同じフィールドが、バックログのカテゴリに含まれる各 WIT の作業項目フォームに表示されます。 |
タスク ボードに表示できる作業項目の数を変更する
パフォーマンス上の理由から、タスク ボードに表示される作業項目は最大 500 個に制限されます。 タスク ボードを開くと、すべての作業項目がキャッシュに読み込まれます。 作業項目の数を制限することにより、読み込み時間が短縮される場合があります。 この制限を変更するには、TaskBacklog 要素の workItemCountLimit 属性の値を指定します。
たとえば、workItemCountLimit="800" を追加することによって制限値を大きくすることができます。
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="800" >
. . .
</TaskBacklog>
ツール特有の作業項目の種類に対してメタ状態をマップする
メタ状態のマッピングは、追加の WIT のカテゴリに対して定義されます。 スクラム プロセス テンプレートの場合、これにはフィードバック要求および応答のカテゴリのマッピングが含まれます。 MSF Agile と CMMI のプロセス テンプレートの場合、バグ カテゴリのマッピングも含まれます (スクラムには要件カテゴリ内のバグが含まれるため、RequirementBacklog セクション内のメタ状態のマッピングが定義されます)。
<FeedbackRequestWorkItems category="Microsoft.FeedbackRequestCategory" pluralName="Feedback Requests" singularName="Feedback Request">
<States>
<State value="Active" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
</FeedbackRequestWorkItems>
<FeedbackResponseWorkItems category="Microsoft.FeedbackResponseCategory" pluralName="Feedback Responses" singularName="Feedback Response">
<States>
<State value="Active" type="InProgress" />
<State value="Closed" type="Complete" />
</States>
</FeedbackResponseWorkItems>
次の表は、ツール固有の作業項目の種類のメタ状態マッピングを定義するために使用される追加の要素を示します。 実際の状態の値および種類の割り当てについては、「作業項目の種類のカテゴリに対してメタ状態をマップする」を参照してください。 CategoryName は、チーム プロジェクト用に定義されたカテゴリに対応している必要があります。
要素 |
説明 |
---|---|
BugWorkItems |
省略可能です。 バグ カテゴリに割り当てられた作業項目の種類のメタ状態マッピングを定義するコンテナー要素。 これらのマッピングが TWA のアジャイル計画ページの表示でどのように使用されるかに加えて、開発者が担当作業を使用してバグを移動したときに、チーム エクスプローラーの担当作業機能でバグの状態がどのように更新されるかも制御します。 詳細については、「ユーザー ストーリーの書き込みの新しいコード」を参照してください。
|
FeedbackRequestWorkItems |
必ず指定します。 カスタマイズしないでください。 フィードバック要求カテゴリに割り当てられた作業項目の種類のメタ状態マッピングを定義するコンテナー要素。
|
FeedbackResponseWorkItems |
必ず指定します。 カスタマイズしないでください。 フィードバック応答カテゴリに割り当てられた作業項目の種類のメタ状態マッピングを定義するコンテナー要素。
|
TestPlanWorkItems |
テスト計画のワークフロー状態をカスタマイズし、Visual Studio 2013.2 以前のバージョンとともにインストールされたテスト マネージャーのバージョンによるチーム プロジェクトへの接続をサポートする場合にのみ必要。 テスト計画カテゴリに割り当てられた作業項目の種類のメタ状態マッピングを定義するコンテナー要素。 次に例を示します。
|
TestSuiteWorkItems |
テスト スイートのワークフロー状態をカスタマイズし、Visual Studio 2013.2 以前のバージョンとともにインストールされたテスト マネージャーのバージョンによるチーム プロジェクトへの接続をサポートする場合にのみ必要。 テスト スイート カテゴリに割り当てられた作業項目の種類のメタ状態マッピングを定義するコンテナー要素。 次に例を示します。
|
TestPlanWorkItems または TestSuiteWorkItems のメタ状態をマップするには、アプリケーション層サーバーを TFS 2013.3 にアップグレードする必要があります。 その後、テスト計画とテスト スイートのワークフロー状態をカスタマイズできます。
詳細については、「プロセス構成のインポートとエクスポート」を参照してください。
アジャイル計画ツールとグラフで使用されるフィールドを割り当てる
キャパシティ、バーンダウン チャート、予測、およびベロシティの計算で使用される作業項目フィールドを変更できます。 既定の割り当てのいずれかに対するすべての変更は、その値の情報を定義およびキャプチャするために使用される WIT に対する変更に対応している必要があります。
たとえば、type="Activity" に割り当てられた refname を変更する場合、アクティビティ情報をキャプチャするタスク カテゴリに割り当てられた WIT 定義に同じフィールドを含める必要があります。
<TypeFields>
<TypeField refname="System.AreaPath" type="Team" />
<TypeField refname="Microsoft.VSTS.Scheduling.RemainingWork" type="RemainingWork" format="format h" />
<TypeField refname=" Microsoft.VSTS.Common.BacklogPriority" type="Order" />
<TypeField refname="Microsoft.VSTS.Scheduling.Effort" type="Effort" />
<TypeField refname="Microsoft.VSTS.Common.Activity" type="Activity" />
<TypeField refname="Microsoft.VSTS.Feedback.ApplicationStartInformation" type="ApplicationStartInformation" />
<TypeField refname="Microsoft.VSTS.Feedback.ApplicationLaunchInstructions" type="ApplicationLaunchInstructions" />
<TypeField refname="Microsoft.VSTS.Feedback.ApplicationType" type="ApplicationType">
<TypeFieldValues>
<TypeFieldValue value="Web application" type="WebApp" />
<TypeFieldValue value="Remote machine" type="RemoteMachine" />
<TypeFieldValue value="Client application" type="ClientApp" />
</TypeFieldValues>
</TypeField>
</TypeFields>
要素 |
説明 |
---|---|
TypeFields |
必ず指定します。 TypeField の要素のコレクションを指定します。 |
TypeField |
必ず指定します。 値が機能領域のアクティビティの種類をサポートするフィールドの参照名を指定します。 指定したフィールドが、機能の情報をキャプチャするために使用される WIT 内で使用するフィールドに対応している必要があります。
type="RemainingWork" の場合にのみ形式を指定します。 現在のイテレーション バックログ ページおよびタスク ボードのキャパシティ バーに表示する TimeUnitString として任意の文字列を指定できます。 アジャイル計画のページの場合:
フィードバック要求フォームの場合: 注意 次の TypeField 要素に対する既定の割り当てを変更する必要はありません。これらの割り当ては、フィードバック要求カテゴリに割り当てられる WIT の対応する情報をキャプチャするために使用されるフィールドに対応しています。
|
TypeFieldValues |
type="ApplicationType" の場合、TypeFieldValue 要素では必須。 フィードバック要求フォームで使用されている TypeFieldValue の要素のコレクションを指定します。 |
TypeFieldValue |
必ず指定します。 カスタマイズしないでください。 フィードバック要求フォームに表示するアプリケーションの種類の名前を指定します。
既定の割り当ては、フィードバック要求フォームの種類の定義で指定されている許可値に対応します。
|
実装に関するメモ
TypeFields セクション内のフィールドを変更する場合は、WIT 定義内で対応する変更を行う必要があります。 たとえば、作業の Effort をキャプチャするために割り当てられたフィールドを変更する場合、プロダクト バックログ項目の WIT 定義でも同じ変更を加える必要があります (Scrum の場合)。
このインデックスを使用してフィールドの参照名を検索できます。
非稼働日の割り当て
キャパシティ プランニングやバーンダウン チャートは非稼働日を参照します。 各 TFS プロセス テンプレートでは、次の非稼働日が定義されています。
<Weekends>
<DayOfWeek>Saturday</DayOfWeek>
<DayOfWeek>Sunday</DayOfWeek>
</Weekends>
要素 |
説明 |
---|---|
DayOfWeek |
Weekends 要素の子です (必須)。 非稼働日に対応する曜日を指定します。
有効な名前は、英語の曜日に対応しています。Sunday、Monday、Tuesday、Wednesday、Thursday、Friday、および Saturday。 注意 Team Foundation Server のインストールされている言語に関係なく、英語で曜日を指定する必要があります。 |
Weekends |
省略可能です。 非稼働日を指定するために使用されるコンテナー要素。 キャパシティやバーンダウン チャートの計算で非稼働日を考慮する場合は非稼働日を指定します。 バーンダウン チャートでのこの情報の表示およびこれが削除できないことについて指摘があります。 |
作業項目の種類の色を変更する
WIT に割り当てられた色に基づいてクエリの結果またはバックログを表示すると、WIT を容易に識別できます。
次の色の割り当ては、スクラム プロセス テンプレート内で定義されます。
<WorkItemColors>
<WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="ProductBacklogItem" />
<WorkItemColor primary="FF773B93" secondary="FFEEE2F2" name="Feature" />
<WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />
<WorkItemColor primary="FFCC293D" secondary="FFFAEAE5" name="Bug" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Code Review Request" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Code Review Response" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Feedback Request" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Feedback Response" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Impediment" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Shared Step" />
<WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Case" />
</WorkItemColors>
要素 |
説明 |
---|---|
WorkItemColors |
省略可能です。 作業項目の種類の色を指定するためのコンテナー要素。 |
WorkItemColor |
TWA 内で WIT を表示するために使用される色を指定します。 基本色はリストの表示で使用され、2 番目の色は、タスク ボードやかんばんボードなどのボードの表示で使用されます。
|
Q & A
Q: TWA でアジャイル計画ツールに表示される他の機能をカスタマイズする方法を教えてください。
A: 一部のカスタマイズはユーザー インターフェイスから行うことができます。 それ以外は、プロセス構成やその他のチーム プロジェクト オブジェクトを編集する必要があります。 概要については、「チーム プロジェクトに合わせたアジャイル プランニング ツールの構成とカスタマイズ」を参照してください。
Q: 複数のポートフォリオ バックログを使用する必要がありますか。
A: 既定のエクスペリエンスでポートフォリオ バックログのいずれかのレベルがサポートされています。 アジャイル ポートフォリオ管理へのバックログの追加 」の手順に従って 5 レベルまで追加できます。
Q: タスク ボードやプロダクト バックログに表示される WIT を追加したり変更したりできますか。
A: カスタム WIT をバックログまたはタスク ボードのいずれかに追加できます。 ただし、それらの両方に表示することはきません。 詳細はこちらをお読みください。バックログまたはタスク ボードへのバグの追加.
Q: プロセス構成のインポートおよびエクスポート例を参照できますか。
A: それらの例については、「プロセスの構成のインポートとエクスポート [witadmin]」を参照してください。