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

Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

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

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

プロセス構成 XML 要素

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

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

注意

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

重要

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

プロセス構成を更新する

注意

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

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

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

ヒント

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

ヒント

witadmin を使用すると、定義ファイルをインポートおよびエクスポートできます。 使用できるその他のツールには、プロセス エディターが含まれます (Visual Studio のバージョンをインストールしている必要があります)。 Visual Studio Marketplace から TFS プロセス テンプレート エディターをインストールします。 このバージョンのプロセス エディターを使用して、古いスタイルの作業項目フォームを変更できます。 これを使って、新しい Web フォームに関連付けられているフォームを編集することはできません。

または、GitHub から入手できるオープンソース クライアントである TFS Team Project Manager を使用することもできます。

バックログを構成する

プロダクト バックログ、スプリント バックログ、およびポートフォリオ バックログで、以下の要素をカスタマイズできます。

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

  • [クイック追加] パネル: バックログに項目をすばやく追加するために表示される 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>

注意

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

PortfolioBacklogs 要素の構文

要素

説明

PortfolioBacklogs

任意。 ポートフォリオ バックログのコンテナー要素。

PortfolioBacklog

任意。 最大 5 個のインスタンス。

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

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

次のように属性に値を割り当てます。

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

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

  • pluralName: このバックログの種類に関連付けられている WIT を参照するときに使用する複数形ラベルを指定します。 たとえば、Stories、Goals、Initiatives、Epics などです。

  • singularName: このバックログ型に関連付けられている WIT を参照するときに使用する単数形ラベルを指定します。 たとえば、Story、Goal、Initiative、Epic などです。

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

RequirementBacklog

必須。 1 個のインスタンスだけです。

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

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

TaskBacklog

必須。 1 個のインスタンスだけです。

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

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

実装に関するメモ

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

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

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

一方、状態カテゴリは、アジャイル計画ツールが各ワークフロー状態をどのように扱うかを決定します。 バックログとタスク ボードで使用される主な状態カテゴリは、 ProposedInProgressComplete です。 状態カテゴリは 属性に 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 の有効な値は、次のいずれかの列挙値に対応します。

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

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

注意

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

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

状態

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 要素のコレクションを指定します。 バックログ要素の必須要素: PortfolioBacklogRequirementBacklogおよび 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

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

Fields

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

フィールド

作業項目フィールドがプロダクト バックログのパネル内に表示されるように指定します。

<Field refname="FieldReferenceName"/>

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

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

パフォーマンス上の理由から、タスク ボードに表示される作業項目は最大 1000 個に制限されます。 タスク ボードを開くと、すべての作業項目がキャッシュに読み込まれます。 作業項目の数を制限することにより、読み込み時間が短縮される場合があります。 この制限は、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

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

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

FeedbackRequestWorkItems

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

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

FeedbackResponseWorkItems

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

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

TestPlanWorkItems

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

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

<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 カテゴリに割り当てられた作業項目の種類の状態カテゴリ マッピングを定義する Container 要素。 次に例を示します。

<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>

注意

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

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

キャパシティ、バーンダウン チャート、予測、およびベロシティの計算で使用される作業項目フィールドを変更できます。 既定の割り当てのいずれかに対するすべての変更は、その値の情報を定義およびキャプチャするために使用される 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 で使用される同じフィールドを指定します。

注意

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

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

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

注意

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

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

注意

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

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

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

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

TypeFieldValues

の場合type="ApplicationType"TypeFieldValue に必要です。 フィードバック要求フォームで使用される 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>

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

注意

オンプレミス 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" />

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

設定できる BugsBehavior 最初の 2 つのプロパティ。 HiddenBacklogs プロジェクトの既定値を設定します。 ただし、各チームは、チーム設定を使用して動作を変更できます。 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 要素の構文

要素

説明

Properties

任意。 既定のプロパティおよび動作を指定するためのコンテナー要素。

プロパティ

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

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

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

注意

機能の可用性: ホスト型 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" />

注意

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

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

注意

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

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

ここでは、作業項目フォームでの表示方法を示します。

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

注意

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

詳細:

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

WIT アイコンを指定する

注意

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

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

icon_airplane、icon_asterisk、 icon_book、icon_car、icon_chart、icon_chat_bubble、icon_check_box、icon_clipboard、icon_code_response、icon_palette、icon_code_review 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

注意

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

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

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

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

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

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

Web 作業項目フォームの詳細と、次の追加トピックからカスタマイズする方法について説明します。

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