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

プロセスの構成では、チームがアジャイル計画ツールを使用してアクセスできる既定の構成および機能を定義します。 Web ポータルから表示できるこれらのツールには、プロダクト バックログ、スプリント バックログ、かんばんボード、およびタスク ボードが含まれています。 これらのツールは、Visual Studio Online またはオンプレミスの Team Foundation Server (TFS) でチーム プロジェクトを作成すると、利用できるようになります。

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

「チーム プロジェクトに合わせたアジャイル プランニング ツールの構成とカスタマイズ」では、ユーザー インターフェイスを通じて何を構成できるかと、ProcessConfiguration ファイルの定義による構成を必要とするものについての概要を示します。

ProcessConfiguration を通じてカスタマイズできる領域:

プロセスの構成を更新するには、XML 定義ファイルをエクスポートして編集した後、ファイルをインポートします。 witadmin コマンド ライン ツールを使用して、このファイルをインポートおよびエクスポートします。

バックログを構成する

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

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

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

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

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

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

実装に関するメモ

• 既定では、各バックログは合計 1000 の作業項目に制限されています。 workItemCountLimit 属性の値を指定することで、この制限を変更できます。

• CategoryName に割り当てる値は、チーム プロジェクト用に定義されたカテゴリ グループに対応している必要があります。 カテゴリの定義ファイルでカテゴリ グループを指定します。

• バックログを整理し、バックログ項目のロールアップを低いレベルで表示し、複数のチーム全体の進行状況を表示するには、ポートフォリオ バックログを使用します。 新しいアップグレードされたチーム プロジェクトには、Features と Epics という 2 つのポートフォリオ バックログ レベルが含まれています。 最大 3 つのレベルを追加できます。 最上位レベルのポートフォリオ バックログだけが、親カテゴリを指定しません。

  注意

  一部のポートフォリオ バックログ機能を使用するには、上級アクセスが必要な場合があります。

• プロダクト バックログは、チームが納品しようと計画しているもののロードマップであるプロジェクト計画に対応しています。 WIT が要件カテゴリに属している作業項目の一覧を表示します。 既定のチーム プロジェクトに用意されている WIT 以外のさまざまな WIT を管理するために、要件カテゴリに WIT を追加して、ワークフローの状態をメタ状態にマップできます。

• スプリントまたはイテレーション バックログには、自分自身およびチームが特定のスプリント サイクルでコミットした要件およびそれらの要件にリンクしたタスクの両方が表示されます。 タスクは、親子リンクの種類を使用して要件にリンクします。 これらのバックログに表示される WIT はプロダクト バックログに表示される同じ種類に対応するため、プロダクト バックログに対するカスタマイズ作業の多くによって、スプリント バックログの機能が定義されます。

メタ状態へのワークフロー状態のマップ

ほとんどの 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 type="TypeName" value="ValueName"/>

既定の列と列の順序をカスタマイズする

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

以下に、プロダクト バックログ用にスクラム プロセス テンプレートで定義されている既定の構成を示します。

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

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

<Field refname="FieldReferenceName"/>

タスク ボードに表示できる作業項目の数を変更する

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

たとえば、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 category="CategoryName" pluralName="PluralName" singularName="SingleName">
   <States>
. . .
   </States>
</BugWorkItems>

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

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

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

TestPlanWorkItems または TestSuiteWorkItems のメタ状態をマップするには、アプリケーション層サーバーを TFS 2013.3 にアップグレードする必要があります。 その後、テスト計画とテスト スイートのワークフロー状態をカスタマイズできます。

詳細については、「プロセス構成のインポートとエクスポート」を参照してください。

アジャイル計画ツールとグラフで使用されるフィールドを割り当てる

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

たとえば、refname に割り当てられた type="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>

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

<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 定義内で対応する変更を行う必要があります。 たとえば、作業の Effort をキャプチャするために割り当てられたフィールドを変更する場合、プロダクト バックログ項目の WIT 定義でも同じ変更を加える必要があります (Scrum の場合)。

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

非稼働日の割り当て

非稼働日は、キャパシティ プランニング ツールおよびバーンダウン グラフによって行われる計算から除外されます。 既定の Visual Studio Online プロセスおよび TFS プロセス テンプレートでは、土曜日と日曜日が非稼働日になっています。 チーム プロジェクトの作成後、各チームは固有の非稼働日を設定できます。

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

<DayOfWeek>NameOfADay</DayOfWeek>

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

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>

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

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

この時点で指定できるプロパティは 1 つだけです。 BugsBehavior プロパティは、バグ、およびバグ カテゴリで定義されているその他の WIT がバックログおよびボードでどのように表示されるかについての既定の構成を定義します。 基本的には、バグを要件として扱うか、タスクとして扱うか、またはバックログとボードに表示しないかを構成できます。 チーム プロジェクトの作成後、各チームは動作を設定できます。

<Properties>
   <Property name="BugsBehavior" value="AsTasks" />
   <Property name="HiddenBacklogs" value="Microsoft.EpicCategory" />
</Properties>

Q & A

Q: 他のアジャイル ツール機能のカスタマイズ方法を教えてください。

A: 一部のカスタマイズはユーザー インターフェイスから行うことができます。 それ以外は、プロセス構成やその他のチーム プロジェクト オブジェクトを編集する必要があります。 概要については、「チーム プロジェクトに合わせたアジャイル プランニング ツールの構成とカスタマイズ」を参照してください。

Q: タスク ボードやプロダクト バックログに表示される WIT を追加したり変更したりできますか。

A: カスタム WIT をバックログまたはタスク ボードのいずれかに追加できます。 ただし、それらの両方に表示することはきません。 方法については、「バックログとボードへの作業項目の種類の追加」をお読みください。