プロセス構成 XML 要素リファレンス

  • [アーティクル]

Azure DevOps Server 2022 - Azure DevOps Server 2019

プロセス構成では、チームが Web ポータルのアジャイル ツールを使用してアクセスできる既定の構成と機能を定義します。 これらのツールには、製品バックログ、スプリント バックログ、かんばんボード、タスク ボードが含まれており、プロジェクトに追加するチームごとにカスタマイズできます。

構成要素は、作業項目の種類 (WIT)、既定の列、ツールで使用されるフィールド、およびその他の要素を指定します。 メイン構成では、プロセス構成 XML 定義ファイルの PortfolioBacklog、RequirementBacklog、および TaskBacklog セクションを定義することで、ポートフォリオ、製品、およびスプリントバックログに対して表示される項目が決まります。 さらに、プロセス構成では、マッピングを必要とするすべての WIT の状態から状態へのカテゴリのワークフロー マッピングを定義します。

プロセス構成 XML 要素

ユーザー インターフェイスを使用して構成できる内容の概要については、作業の追跡のカスタマイズ、チームの追加、スクラム ツールとかんばんツールの構成に関するページを参照してください。

ProcessConfiguration を使用してカスタマイズできる領域:

バックログ 作業項目の種類 (WIT) その他のツール
- クイック追加パネルを構成する
- 既定の列を定義する
- WIT カテゴリの状態カテゴリをマップする
- タスク ボードアイテムの数を設定する
- 週末 (スクラム) 1 を設定する
- 既定のバックログにバグを表示する 1 を設定する
- 既定の非表示バックログを設定する1		 - WIT の色を指定する
- ワークフロー状態の色を指定する 2
- WIT アイコンを指定する 3		 - アジャイル ツール フィールドの割り当て
- マップ ツール固有の状態カテゴリ
- プロパティの指定

Note

  1. アスタリスクが付いた項目は、プロジェクトの既定値を設定します。 これらの項目は、チーム設定を使用してチームごとに変更できます。
  2. ホストされた XML と、TFS 2015.2 以降のバージョンのオンプレミス XML でサポートされます。
  3. ホストされた XML、および TFS 2017.2 以降のバージョンのオンプレミス XML でサポートされます。

重要

プロジェクトをカスタマイズして、バックログまたはボードに表示するカスタム作業項目の種類を追加したり、カスタムポートフォリオバックログを追加したりする場合は、「バックログとボードに作業項目の種類を追加する」および「ポートフォリオバックログを追加する」を参照してください。

プロセス構成を更新する

Note

プロセス テンプレートの最新バージョンにアクセスするには、最新バージョンの TFS をインストールし、プロセス テンプレート マネージャーを使用してテンプレートを ダウンロードします。

プロジェクトのプロセス構成を更新するには、XML 定義ファイルをエクスポートして編集し、ファイルをインポートします。 これらのファイルをエクスポートするには、プロセスをエクスポートするか、プロセス構成定義ファイルをエクスポートします。

ProcessConfig 定義ファイルのエクスポートXML 定義ファイルの編集WIT 定義ファイルのインポート変更の更新と確認

ヒント

witadmin を使用すると、定義ファイルをインポートおよびエクスポートできます。 使用できるその他のツールには、プロセス エディターが含まれます (Visual Studio のバージョンをインストールしている必要があります)。 Visual Studio Marketplace からプロセス テンプレート エディターをインストールします。

バックログを構成する

製品バックログ、スプリント バックログ、ポートフォリオ バックログの次の要素をカスタマイズできます。

  • 状態カテゴリのマッピング: ワークフローの状態を状態カテゴリ (以前はメタステートと呼ばれた) にマップします。 これらのマッピングは、かんばんやタスク ボードを含むすべてのアジャイル計画ツールの表示をサポートします。

  • [クイック追加] パネル: バックログに項目をすばやく追加するために表示される WIT フィールドと作業項目フィールドを指定します。

    バックログ項目またはタスクと見なされる作業項目の種類を変更するには、対応するカテゴリに追加します。 例については、「タスク ボードまたはバックログにバグを追加する」を参照してください。

  • 列フィールド: 既定のフィールドと列シーケンスを定義します。

次の例に示す XML セクション内でバックログを構成します。

<PortfolioBacklogs>
      <PortfolioBacklog category="Microsoft.EpicCategory" pluralName="Epics" singularName="Epic" workItemCountLimit="1000">
. . . 
      </PortfolioBacklog>
      <PortfolioBacklog category="Microsoft.FeatureCategory" pluralName="Features" singularName="Feature" parent="Microsoft.EpicCategory" workItemCountLimit="1000">
. . . 
      </PortfolioBacklog>
</PortfolioBacklogs>
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="User Story" workItemCountLimit="1000">
. . . 
</RequirementBacklog>
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="1000">
. . . 
</TaskBacklog>

Note

ProcessConfiguration ファイル (アジャイル、スクラム、または CMMIpluralName) に関連付けられているプロセスに応じて、(RequirementCategoryアジャイル)、(スクラム) Backlog Items 、または Requirements (CMMI) にStories対応します。 3 つはすべて似ています。これらは、配信する顧客価値と実行する作業を記述します。

PortfolioBacklogs 要素の構文

要素

説明

PortfolioBacklogs

省略可能。 ポートフォリオ バックログのコンテナー要素。

PortfolioBacklog

省略可能。 最大 5 つのインスタンス。

ポートフォリオ バックログの状態カテゴリ マッピング、既定の列、およびクイック追加パネルを定義するコンテナー要素。

<PortfolioBacklog category="PortfolioCategory" parent="ParentCategory"  
pluralName="PluralName" singularName="SingleName" workItemCountLimit="MaximumLimit>  
<States> . . . </States>  
<Columns> . . . </Columns>  
<AddPanel> . . . </ AddPanel>  
</PortfolioBacklog >

次の説明に従って、属性に値を割り当てます。

  • category: このバックログの種類に関連付ける WIT を含むプロジェクトのカテゴリ定義ファイルで定義したカテゴリの名前を指定します。

  • parent: 階層内の親ポートフォリオ バックログを表すカテゴリの名前を指定します。

  • pluralName: このバックログの種類に関連付けられている WIT を参照するときに使用する複数形ラベルを指定します。 たとえば、ストーリー、目標、イニシアティブ、エピックなどです。

  • singularName: このバックログ型に関連付けられている WIT を参照するときに使用する単数形ラベルを指定します。 たとえば、ストーリー、ゴール、イニシアティブ、エピックなどです。

  • workItemCountLimit: 整数を指定します。 既定値は 1000 です。 バックログとボードでは、この制限に基づいて表示される項目の数が制限されます。

RequirementBacklog

必須。 1 つのインスタンスのみ。

状態カテゴリのマッピング、既定の列、および製品バックログのクイック追加パネルを定義するコンテナー要素。 製品バックログには、チームのバックログ内のすべてのアクティブな項目が表示されます。

<RequirementBacklog category="RequirementCategory"  
pluralName="PluralName" singularName="SingleName"   
workItemCountLimit="MaximumLimit" >  
<States> . . . </States>
<Columns> . . . </Columns>
<AddPanel> . . . </ AddPanel>
</RequirementBacklog >

TaskBacklog

必須。 1 つのインスタンスのみ。

スプリント バックログのレイアウトをカスタマイズするために使用されるコンテナー要素。

<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" 
singularName="Task workItemCountLimit="MaximumLimit">
. . . 
</TaskBacklog >

実装に関するメモ

  • 既定では、各バックログは合計 1,000 個の作業項目に制限されます。 この制限は、属性の値 workItemCountLimit を指定することで変更できます。
  • CategoryName に割り当てられる値は、プロジェクトに対して定義されているカテゴリ グループに対応している必要があります。 カテゴリの定義ファイルでカテゴリ グループを指定します。
  • ポートフォリオ バックログを使用 して、バックログ を整理し、下位レベルでバックログ項目のロールアップを表示し、複数のチームの進行状況を表示します。 新規およびアップグレードされたプロジェクトには、機能とエピックという 2 つのポートフォリオ バックログ レベルが含まれています。 最大 3 つのレベルを追加できます。 最上位レベルのポートフォリオ バックログのみが親カテゴリを指定しません。
  • 製品バックログは、チームが提供する予定のロードマップであるプロジェクト計画に対応します。 このリストには、要件カテゴリに属する WIT を持つ作業項目が一覧表示されます。 既定のプロジェクトで提供される WIT とは異なる WIT を管理するには、要件カテゴリに WIT を追加し、ワークフローの状態を状態カテゴリにマップします。
  • スプリントバックログまたはイテレーションバックログには、特定のスプリント サイクルで自分とチームがコミットした一連の要件と、それらの要件にリンクしたタスクの両方が表示されます。 親子リンクの種類を使用して、タスクを要件にリンクします。 これらのバックログに表示される WIT は、製品バックログに表示されるのと同じ種類に対応するため、製品バックログに対して行うカスタマイズ作業の多くは、スプリント バックログの機能を定義します。

WIT カテゴリワークフローの状態を状態カテゴリにマップする

いくつかの WIT では、ワークフローの状態を状態カテゴリにマップする必要があります。 ワークフローの状態は、作業項目が最初のアクティブ化または作成から終了または完了までの進行状況を定義します。 たとえば、Scrum 製品バックログ項目に定義されている状態は、New、Approved、Committed、Done の 4 つの状態の進行を定義します。また、実装されずにバックログから削除された状態を考慮する 5 番目の状態 (Removed) も含まれます。 ワークフローの状態は属性に value 関連付けられます。

一方、状態カテゴリは、アジャイル計画ツールが各ワークフロー状態をどのように扱うかを決定します。 バックログとタスク ボードで使用される主な状態カテゴリは、提案済み、InProgress、Complete です。 状態カテゴリは属性に type 関連付けられます。 詳しくは、ワークフローの状態と状態カテゴリに関する記事をご覧ください。

各ワークフロー状態を状態カテゴリに関連付けることで、バックログとタスク ボードを表示するために実行されるバックグラウンド操作は、各作業項目の状態を正しく解釈する方法を認識します。 たとえば、スクラム製品バックログには、次のマッピングが定義されています。

<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 つのグループがあります。 次の表では、マッピングの属性と値について説明します。

States 要素の構文 (WIT カテゴリ)

要素

説明

State

必須。 ワークフロー状態を状態カテゴリに割り当てます。

<State value="ValueName" type="TypeName" />

ValueName の有効な値は、カテゴリ グループに割り当てられている WIT の WORKFLOW セクション内で STATE に割り当てられた値に対応します。

TypeName の有効な値は、次のいずれかの列挙値に対応します。

  • アジャイル: すべての作業項目の種類に使用します。
  • 提案: 新しい作業項目、まだコミットされていない作業項目、またはまだ作業していない作業項目を示します。
  • InProgress: コミット済みまたは作業中の作業項目を示します。
  • 完了: 実装されている作業項目を示します。 かんばんボードを有効にするには、ワークフロー状態を 1 つだけ完了状態カテゴリにマップする必要があります。 追加のワークフロー状態を表す必要がある場合は、解決済み状態カテゴリにマップできます。
    ワークフロー状態が Complete メタステートに関連付けられている状態に遷移すると、関連付けられている作業項目は製品バックログから削除されます。 ただし、かんばんボードの最後の列に引き続き一覧表示されます。

    いずれかの状態カテゴリにマップされていないワークフロー状態の作業項目は、バックログまたはボードに表示されません。
  • バグ: バグ カテゴリ内でグループ化された作業項目の種類にのみ使用します。 アジャイル状態カテゴリに加えて、解決されたバグを示す解決済み状態カテゴリも含まれます。

Note

解決済み状態カテゴリは、BugWorkItems 要素で指定されたワークフロー状態にのみ割り当てることができます。

  • フィードバック: フィードバック要求またはフィードバック応答カテゴリ内でグループ化された作業項目の種類にのみ使用します。 要求済み、受信済み、レビュー済み、拒否済み。

状態

WIT ワークフローの状態を状態カテゴリに関連付ける State 要素のコレクションを指定します。

次の親要素に必要な要素:

  • BugWorkItems
  • PortfolioBacklog
  • RequirementBacklog
  • TaskBacklog
  • TestPlanWorkItems
  • TestSuiteWorkItems
  • FeedbackRequestWorkItems
  • FeedbackResponseWorkItems

既定の列を設定する

[列] セクション内の各バックログに表示するフィールドを指定します。 [列オプション] ダイアログで行った変更は、もう一度変更するまで保持されます。

バックログ ページの既定の列とシーケンス

製品バックログのスクラム プロセス テンプレートによって定義される既定の構成を次に示します。

<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 refname="FieldReferenceName"  width="FieldWidth" />

タスク ボードの列見出し

タスク ボードに表示される列見出しは、タスク カテゴリに割り当てられている既定の WIT に割り当てられたワークフローの状態に対応します。 列シーケンスは、ワークフロー遷移の自然な進行に対応し、左から右に移動します。 列レイアウトを変更するには、タスク カテゴリに割り当てられている WIT のワークフローを変更します。 タスク カテゴリの既定のタスクの種類に定義されているワークフローの状態は、作業項目の種類のカテゴリの状態カテゴリのマップで説明されているように、有効な状態カテゴリに割り当てる必要があります。

クイック追加パネルをカスタマイズする

任意のクイック追加パネルのフィールドを追加できます。 たとえば、次の例では、製品のバックログ パネルにビジネス値を追加します。

[ビジネス価値] フィールドが追加された [バックログ] パネル

このパネルには、選択した WIT の WIT 定義の FIELDS セクションに含まれるフィールド のみが表示されます。 たとえば、バグ WIT を選択すると、ビジネス値がバグに対して定義されていないため、タイトルのみが表示されます。 パネルに別の WIT を追加するには、「作業項目の種類をバックログとボードに追加する」の説明に従って、それを要件カテゴリに追加します。

次のコードは、Visual Studio Scrum と MSF for Agile プロセス テンプレートで定義されている既定の割り当てに対応しています。

<AddPanel>
      <Fields>
      <Field refname="System.Title" />
      </Fields>
</AddPanel>

AddPanel 要素の構文

要素

説明

AddPanel

"クイック追加" エクスペリエンスを指定するために使用されるコンテナー要素。新しいバックログ項目が定義されているパネル領域内に表示されるフィールド。

フィールド

Field 要素のコレクションを指定します。

フィールド

製品バックログのパネル内に表示する作業項目フィールドを指定します。

<Field refname="FieldReferenceName"/>

バックログのカテゴリに含まれる各 WIT の作業項目フォームに、同じフィールドが表示されます。

作業項目のタスク ボード番号を設定する

パフォーマンス上の理由から、タスク ボードには最大 1,000 個の作業項目が表示されます。 タスク ボードを開くと、すべての作業項目がキャッシュに読み込まれます。 作業項目の数を制限すると、読み込み時間が短縮される場合があります。 この制限は、TaskBacklog 要素の属性の値をworkItemCountLimit指定することで変更できます。

たとえば、次のように指定することで、制限を workItemCountLimit="800"減らすことができます。

<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="800" >
. . .
</TaskBacklog>

ツール固有の作業項目の種類の状態カテゴリをマップする

状態カテゴリマッピングは、追加の WIT カテゴリに対して定義されます。 スクラム プロセス テンプレートの場合、これにはフィードバック要求と応答カテゴリのマッピングが含まれます。 MSF アジャイルおよび 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

省略可能。 バグ カテゴリに割り当てられた作業項目の種類の状態カテゴリ マッピングを定義するコンテナー要素。 アジャイル ツールの表示でこれらのマッピングを使用する方法に加えて、開発者がマイ ワークを使用してバグを移動する場合に、チーム エクスプローラーのマイ ワーク機能でバグの状態を更新する方法も制御します。 詳細については、「コードをレビューする (TFVC)」を参照してください。

<BugWorkItems category="CategoryName"  
pluralName="PluralName" singularName="SingleName">
<States>
. . .
</States>
</BugWorkItems>

FeedbackRequestWorkItems

必須。 カスタマイズしないでください。 フィードバック要求カテゴリに割り当てられた作業項目の種類の状態カテゴリ マッピングを定義するコンテナー要素。

<FeedbackResponseWorkItems category="CategoryName"  
pluralName="PluralName" singularName="SingleName">
<States>
. . .
</States>
</FeedbackRequestWorkItems>

FeedbackResponseWorkItems

必須。 カスタマイズしないでください。 フィードバック応答カテゴリに割り当てられた作業項目の種類の状態カテゴリ マッピングを定義するコンテナー要素。

<FeedbackResponseWorkItems category="CategoryName"  
pluralName="PluralName" singularName="SingleName">
<States>
. . .
</States>
</FeedbackResponseWorkItems>```

TestPlanWorkItems

テスト 計画のワークフロー状態をカスタマイズし、Visual Studio 2013.2 以前のバージョンでインストールされた Test Manager のバージョンからのプロジェクトへの接続をサポートする場合にのみ必要です。

テスト計画カテゴリに割り当てられた作業項目の種類の状態カテゴリ マッピングを定義するコンテナー要素。 次に例を示します。

<TestPlanWorkItems category="Microsoft.TestPlanCategory"  
pluralName="Test Plans" singularName="Test Plan">
<States>
<State type="InProgress" value="Design" />
<State type="InProgress" value="Testing" />
<State type="Complete" value="Signed Off" />
</States>
</TestPlanWorkItems>

TestSuiteWorkItems

Test Suite のワークフロー状態をカスタマイズし、Visual Studio 2013.2 以前のバージョンでインストールされた Test Manager のバージョンからのプロジェクトへの接続をサポートする場合にのみ必要です。

Test Suite カテゴリに割り当てられた作業項目の種類の状態カテゴリ マッピングを定義するコンテナー要素。 次に例を示します。

<TestSuiteWorkItems  
category="Microsoft.TestSuiteCategory"  
pluralName="Test Suites" singularName="Test Suite">
<States>
<State type="Proposed" value="Authoring" />
<State type="InProgress" value="Testing" />
<State type="Complete" value="Completed" />
</States>
</TestSuiteWorkItems>

Note

機能の可用性: 状態カテゴリをTestPlanWorkItemsTestSuiteWorkItemsマップするには、アプリケーション層サーバーを TFS 2013.3 以降のバージョンにアップグレードする必要があります。 その後、テスト 計画とテスト スイートのワークフロー状態をカスタマイズできます。 詳細については、テスト計画と Test Suite の機能に関するページを参照してください。

アジャイル ツール フィールドの割り当て

能力、バーンダウン チャート、予測、速度の計算に使用される作業項目フィールドを変更できます。 既定の割り当てのいずれかに対して行った変更は、その値の情報を定義およびキャプチャするために使用される WIT に加えられた変更に対応する必要があります。

たとえば、割り当て先をrefnametype="Activity"変更する場合は、アクティビティ情報をキャプチャするタスク カテゴリに割り当てられている 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 要素の構文

要素

説明

TypeFields

必須。 TypeField 要素のコレクションを指定します。

TypeField

必須。 特徴領域のアクティビティの種類をサポートする値を持つフィールドの参照名を指定します。 指定するフィールドは、機能情報のキャプチャに使用する WIT 内で使用するフィールドに対応している必要があります。

<TypeField refname="FieldReferenceName"  
type="NameOfType" [format="{0} TimeUnitString"] / >

場合にのみ type="RemainingWork"、形式を指定します。 現在のスプリント バックログとタスク ボードの 容量バーに表示する TimeUnitString の任意のテキスト文字列を指定できます。

アジャイル ツールの場合:

  • アクティビティ: アクティビティごとの容量機能をサポートするために使用されます。 タスク カテゴリに割り当てられている WIT で使用されるのと同じフィールドを指定します。

Note

Capacity ツールによって表示される値には、プロジェクト コレクション インスタンス内のすべてのプロジェクトでフィールドに定義されているすべての値の和集合が反映されます。 そのため、スプリントキャパシティに表示される値を制限するには、割り当てられた type="Activity"フィールドのすべてのプロジェクトで値を一致させる必要があります。

  • 作業量: チームの速度を計算するために使用されます。 要件カテゴリに割り当てられている WIT で使用するフィールドと同じフィールドを指定します。これは、バックログ項目が実装するために必要な作業量の推定レベル、ストーリー ポイント、またはサイズをキャプチャするために使用します。

  • 順序: バックログとボード上の項目の並べ替え順序を定義するために使用されます。 このタイプのフィールドで定義されている昇順に従って作業項目が一覧表示されます。

Note

項目を移動する場合は、バックログまたはボード上のリストを上下にドラッグします。 アイテムを移動すると、バックグラウンド プロセスによって、.に割り当てられているフィールドが更新されます type="Order"。

  • ReメインingWork: 再メイン作業グラフとバーンダウン グラフを計算するために使用します。 タスクカテゴリに割り当てられたWITで使用するフィールドと同じフィールドを指定します。このフィールドを使用して、タスクを完了するためにメイン時間、日、またはその他の測定単位をキャプチャします。
    形式に指定した値は、スプリント バックログとタスク ボードで、再メイン作業が報告される場所で使用されます。 たとえば、アクティビティごとの容量またはチーム メンバーごとの容量を報告する場合や、タスク ボードのタスク状態の列見出しの横にある場合などです。
    TimeUnitString の場合は、時間や日などの時間値を反映するために使用するテキスト文字列を指定します。
    たとえば、次の値はすべて有効です。
    format="{0} h"
    format="{0} hours"
    format="hours {0}"
    format="time {0}"
  • チーム: バックログをチームに関連付けるために使用されます。 既定値は System.AreaPath です。 チームをエリア パスから切り離すには、「チームをサポートするためのエリア パスではなくチーム フィールドを使用する」で説明されているように、別のフィールドを指定できます。
    フィードバック要求フォームの場合:

Note

次 の TypeField 要素に対して行われる既定の割り当てを変更する必要はありません。 これらの割り当ては、フィードバック要求カテゴリに割り当てられた WIT 内の対応する情報をキャプチャするために使用されるフィールドに対応します。

  • ApplicationStartInformation: アプリケーションを実行するためのパスをキャプチャするために使用されます。

  • ApplicationLaunchInstructions: 起動命令をキャプチャするために使用されます。

  • ApplicationType: アプリケーションの種類をキャプチャするために使用されます。 一覧表示される型は、フィードバック要求の WIT 定義で指定された値に対応します。

TypeFieldValues

TypeFieldValue の場合type="ApplicationType"は必須です。 フィードバック要求フォームで使用される TypeFieldValue 要素のコレクションを指定します。

TypeFieldValue

必須。 カスタマイズしないでください。 フィードバック要求フォームに表示するアプリケーションの種類の名前を指定します。

<TypeFieldValue value="ApplicationTypeName" type="TypeApp"/>

既定の割り当ては、フィードバック要求フォームの型定義で指定された値に対応します。

<TypeFieldValues>
<TypeFieldValue value="Web application" type="WebApp" />
<TypeFieldValue value="Remote machine" type="RemoteMachine" />
<TypeFieldValue value="Client application" type="ClientApp" />
</TypeFieldValues>

実装に関するメモ

  • TypeFields セクション内のフィールドを変更する場合は、WIT 定義で対応する変更を行う必要があります。 たとえば、作業 作業をキャプチャするために割り当てられたフィールドを変更する場合は、製品バックログ項目とバグ (スクラムの場合) の WIT 定義で同じ変更を行う必要があります。

  • この インデックスを使用して、フィールドの参照名を検索できます。

非稼働日を設定する

非稼働日は、容量計画ツールとバーンダウン グラフによって行われた計算から削除されます。 既定のプロセス (アジャイル、 スクラム、または CMMI) では、土曜日と日曜日を非稼働日として指定します。

<Weekends>
   <DayOfWeek>Saturday</DayOfWeek>
   <DayOfWeek>Sunday</DayOfWeek>
</Weekends>

Weekends 要素の構文

要素

説明

DayOfWeek

Weekends 要素の必須の子。

非稼働日に対応する曜日を指定します。

<DayOfWeek>NameOfADay</DayOfWeek>

有効な名前は、日曜日、月曜日、火曜日、水曜日、木曜日、金曜日、土曜日の英語の曜日に対応します。

Note

オンプレミスの TFS のインストールされている言語に関係なく、週の曜日を英語で指定する必要があります。

週末

省略可能。 非稼働日を指定するために使用されるコンテナー要素。

容量グラフとバーンダウン グラフの計算で非稼働日を考慮する非稼働日を指定します。

作業項目の種類の色を変更する

一目で、WIT に割り当てられた色とアイコンに基づいてクエリ結果またはバックログを表示するときに、WIT を区別できます。 作業項目の種類に定義されている色が、WIT に指定されたアイコンに適用されます。

wit の色、アイコン、状態の色を示すクエリ結果

スクラム プロセス テンプレートでは、次の色の割り当てが定義されています。 アジャイルテンプレートとCMMIテンプレートにも似ています。

<WorkItemColors>
      <WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="ProductBacklogItem" />
      <WorkItemColor primary="FF773B93" secondary="FFEEE2F2" name="Feature" />
   <WorkItemColor primary="FFFF7B00" secondary="FFFFD7B5" name="Epic" />
      <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" />
   <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Plan" />
   <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Suite" />
   <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Shared Parameter" />
</WorkItemColors>

WorkItemColors 要素の構文

要素

説明

WorkItemColors

省略可能。 作業項目の種類の色を指定するためのコンテナー要素。

WorkItemColor

Web ポータル内で WIT を表示するために使用する色を指定します。 プライマリ カラーは、リスト ディスプレイで使用されます。 セカンダリ カラーは参照されなくなりましたが、構文を検証するには、その色を指定する必要があります。

色を指定するときは、常に 6 桁の 16 進カラー コードの前に FF を付けます。これは、色が完全に表示されることを示します。

<WorkItemColor primary="HexColorCode" secondary="HexColorCode"  
name="witName" />

プロパティと動作を指定する

最初の 2 つのプロパティを設定しHiddenBacklogs、BugsBehaviorプロジェクトの既定値を設定します。 ただし、各チームは、チーム設定を使用して動作を変更できます。 3 番目のプロパティ StateColors は、すべての WIT のワークフロー状態に関連付けられた色を定義します。 設定した値は、プロジェクト全体のすべてのチームに使用されます。

構成例 Properties :

 <Properties>  
      <Property name="BugsBehavior" value="AsTasks" />  
      <Property name="HiddenBacklogs" value="Microsoft.EpicCategory" />  
      <Property name="StateColors" value="Active=#FF00FF00,Resolved=#FFFF0000" />
      <Property name="WorkItemTypeIcons" value="Epic=Icon_Crown,Feature=Icon_Trophy,User Story=icon_book,
        Task=icon_clipboard,Bug=icon_insect,Issue=icon_traffic_cone,
        Test Plan=icon_test_plan,Test Suite=icon_test_suite,Test Case=icon_test_case,Shared Steps=icon_test_step,
        Shared Parameter=icon_test_parameter" />  
  </Properties>

このプロパティは BugsBehavior 、バグ カテゴリで定義されているバグやその他の WIT をバックログとボードに表示する方法を決定します。 基本的に、バグを要件として扱うか、タスクとして扱うか、バックログやボードに表示しないかを構成できます。 詳細については、バックログとボードにバグを表示するを参照してください。

このプロパティは HiddenBacklogs 、既定で表示されるバックログ/ポートフォリオ バックログを決定します。 既定では、製品バックログと 1 レベルのポートフォリオ バックログである機能バックログだけが表示されます。 Teams は、エピック バックログをアクティブ化するか、その他の変更を行うかを決定できます。 詳細については、バックログの整理、チームのバックログ レベルのアクティブ化に関するページを参照してください。

Properties 要素の構文

要素

説明

プロパティ

省略可能。 既定のプロパティと動作を指定するためのコンテナー要素。

プロパティ

新しい機能を使用してプロジェクトを更新するときに、新しいチームまたは既存のチームに対して行われる既定の割り当てを指定します。 チームは、チーム設定を使用して必要な動作を選択できます。

有効なプロパティ名は次のとおりです。

  • BugsBehavior は、バックログとボードにバグを表示するための既定値を設定します。 使用できる値は次のとおりです。
  • AsRequirements — 要件に似たバックログとボードにバグが表示されます (スクラム プロセスの既定)
  • AsTasks — タスクに似たバックログとボードにバグが表示されます (アジャイルおよび CMMI プロセスの既定)
  • オフ — バックログまたはボードにバグが表示されない
  • HiddenBacklogs は、 既定では非アクティブなバックログを指定 します。
  • StateColors は、 ワークフローの状態の色の値を設定します。 (TFS 2017 以降のバージョンが必要)
    プロパティの値は、状態名と 16 進色のコンマ区切りのリストです。 6 桁の 16 進カラー コードの前に FF を付けます。これは、色が完全に表示されることを示します。
    <Property name="StateColors" value="stateName1=color1, stateName2=color2,..." />

Note

機能の可用性: ホスト型 XML を使用する場合、またはオンプレミスの XML の場合、TFS 2015.2 以降のバージョンにアップグレードした場合は、ワークフロー状態の色を指定できます。
詳細については、次のセクション 「ワークフロー状態の色を指定する」を参照してください。

  • WorkItemTypeIcons は、 作業項目の種類ごとに表示するアイコンを定義します。 このアイコンは、作業項目の一覧と作業項目フォームに表示されます。 アジャイル プロセスの既定のエントリは次のとおりです。 アイコンは、サポートされているアイコンの一覧からのみ指定できます。

<Property name="WorkItemTypeIcons" 
value="Epic=Icon_Crown,Feature=Icon_Trophy,  
User Story=icon_book,Task=icon_clipboard,Bug=icon_insect,  
Issue=icon_traffic_cone,Test Plan=icon_test_plan,Test Suite=icon_test_suite,  
Test Case=icon_test_beaker,Shared Steps=icon_test_step,Shared Parameter=icon_test_parameter" />

Note

機能の可用性: Hosted XML を使用する場合、またはオンプレミスの XML の場合、TFS 2017.2 以降のバージョンにアップグレードした場合は、作業項目の種類に使用するアイコンをカスタマイズできます。

ワークフロー状態の色を指定する

Note

機能の可用性: ワークフロー状態の色を指定するには、TFS 2015.2 以降のバージョンにアップグレードする必要があります。

作業項目の状態に関連付ける色は、製品全体に表示されます。 これには、次の領域が含まれます。

  • 作業項目フォーム (Web ポータル、新しい作業項目エクスペリエンスを参照)
  • 作業項目フォーム リンク コントロール (Web ポータル、LinksControlOptions XML 要素リファレンスを参照)
  • かんばんボードとタスク ボードに表示されるカード (設定については、「カードのカスタマイズ」を参照してください)
  • すべてのバックログ (列オプションを使用して State を追加)
  • クエリ結果 (列オプションを使用して状態を追加)

ここでは、作業項目フォームにどのように表示されるかを示します。

バグ作業項目フォーム ヘッダー、状態の色が表示される

Note

クライアント作業項目フォームまたはクライアント フォーム内の古いリンク コントロール内には、色は表示されません。

詳細:

  • WIT に定義されている色と同様に、色を 8 桁の 16 進数の値として指定する必要があります。
  • 色を追加または編集するには、更新されたプロパティを使用してプロセス構成を再インポートするだけです
  • 状態の色は、すべての作業項目の種類で名前によって定義されます。つまり、"アクティブ" をユーザー ストーリー用に 1 色、バグ用に別の色にする方法はありません
  • マップされていない色は、メタ状態マッピングに基づいて実行時に既定値になります
  • 色が定義されておらず、メタ状態マッピングがない状態には空の円が表示されます。

WIT アイコンを指定する

Note

機能の可用性: Hosted XML を使用する場合、またはオンプレミスの XML の場合、TFS 2017.2 以降のバージョンにアップグレードした場合は、作業項目の種類に使用するアイコンをカスタマイズできます。

作業項目の種類に指定できるサポートされているアイコンのセットを次に示します。

icon_airplane、icon_asterisk、icon_book、icon_car、icon_chart、icon_chat_bubble、icon_チェック_box、icon_clipboard、icon_code_response、icon_code_reviewicon_palette、icon_crown、icon_database_storage、icon_diamond、icon_flame、icon_gavel、icon_gear、icon_gift、icon_government、icon_headphoneicon_insect、icon_key、icon_list、icon_megaphone、icon_paint_brush、icon_parachute、icon_response、icon_review、icon_ribbon、icon_sticky_noteicon_star、icon_test_beaker、icon_test_parameter、icon_test_plan、icon_test_step、icon_test_suite、icon_traffic_cone、icon_trophy

Note

アスタリスクが付いたアイコンは、Azure DevOps Services および TFS 2017.3 以降のバージョンでサポートされています。

作業項目タイプに定義されている色がアイコンに適用されます。 Web ポータルには、作業項目が表示される色とアイコンが表示されます。 これには、PR の関連作業、リンクの一覧、プロジェクト ページ、作業バックログ、ボード、クエリ、プランが含まれます。

たとえば、リスト ビューが表示されます。...

Web ポータル、アイコンを含む作業項目の一覧

作業項目フォーム内にアイコンが表示されます。

バグ作業項目フォーム ヘッダー、作業項目の種類アイコンが表示される

Web 作業項目フォームとそのカスタマイズ方法の詳細については、次の追加トピックを参照してください。

カスタム WIT を追加し、バックログまたはタスク ボードに追加する場合は、これを行うことができます。 両方の場所に表示することはできません。 「バックログとボードに作業項目の種類を追加する」を参照してください。