次の方法で共有


作業項目の種類のカテゴリ要素参照リファレンス

作業項目の種類のカテゴリを定義して、クエリの実行や、類似しているが異なる名前が割り当てられている情報の追跡に役立てることができます。カテゴリを使用することで、作業項目の種類とカテゴリが関連付けられます。作業項目の種類には、特定のカテゴリに属していることを示すタグが付けられます。

また、プロセス操作を構成する、アジャイル計画ツール、My 作業項目クラスの使用カテゴリのようないくつかの機能。カテゴリ ファイルを変更する前に、プロセス構成を使用したバックログ ページおよびボード ページのカスタマイズで提供される情報を確認します。

各カテゴリには表示名と参照名があり、どちらもチーム プロジェクト内で一意である必要があります。詳細については、「作業項目トラッキング オブジェクトの名前付け規則」を参照してください。

チーム プロジェクト管理者および Team Foundation 管理者のみが、カテゴリの変更を許可されています。

このトピックの内容

  • 構文構造

  • カテゴリは既定のプロセス テンプレートによって定義された

  • カテゴリに基づくクエリのフィルター処理

構文構造

カテゴリは、チーム プロジェクトによって格納および使用される CATEGORY 要素の、CATEGORIES セット内で定義します。カテゴリを空にすることはできません。各 CATEGORY 要素には、1 個の DEFAULTWORKITEMTYPE 要素と 0 個以上の WORKITEMTYPE 要素を定義する必要があります。

カテゴリをプロジェクト コレクションに追加するには、witadmin importcategories コマンド ライン ツールを使用して、次の構文をインポートします。

<?xml version="1.0" encoding="utf-8" ?> 
<cat:CATEGORIES xmlns:cat="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories">
   <CATEGORY name="Category Name" refname="Category Reference Name" >
      <DEFAULTWORKITEMTYPE name="MyCorp.Defect"/>
      <WORKITEMTYPE name="work item type name 1" />
      <WORKITEMTYPE name=" work item type name 2" />
      …
      <WORKITEMTYPE name=" work item type name n" />
   </CATEGORY>
   . . . 
</cat:CATEGORIES>

各 DEFAULTWORKITEMTYPE 要素と WORKITEMTYPE 要素に指定する各作業項目の種類の名前は、チーム プロジェクトに対して定義されている作業項目の種類に対応している必要があります。カテゴリ ファイルをインポートすると、以前にインポートした内容は上書きされます。

カテゴリは既定のプロセス テンプレートによって定義された

Team Foundation Serverの最新バージョンに用意されている既定のプロセス テンプレートの 1 つがを使用してチーム プロジェクトを作成すると Visual Studio ALM と Test Managerで使用される機能をサポートするために必要な次のカテゴリを定義しています:

  • バグ カテゴリ

  • コード レビューの要求のカテゴリとコード レビューの応答のカテゴリ

  • フィードバックの要求のカテゴリとフィードバックの応答のカテゴリ

  • 要件カテゴリ

  • 共有ステップ カテゴリ

  • タスク カテゴリ

  • テスト ケース カテゴリ

  • [隠し型カテゴリ]

これらのカテゴリの大部分は自明であり、ほとんどは、カテゴリ内の 1 種類の作業項目の種類のみが含まれます。非表示の型のカテゴリは、ユーザーに手動で作成する必要の作業項目の種類を指定します。これらの型定義がテスト ケースのフィードバックとコード レビューの操作をサポートするために、定義を使用します。

次の例では、Visual Studio Scrum のプロセス テンプレートの既定のカテゴリの定義ファイルの内容を一覧表示します。

<?xml version="1.0" encoding="utf-8"?>
<cat:CATEGORIES xmlns:cat="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories">
<!-- Usage: for resilience in Test system. Even if WITs have different name, they can be referred to by the category -->
   <CATEGORY name="Bug Category" refname="Microsoft.BugCategory" >
      <DEFAULTWORKITEMTYPE name="Bug" />
   </CATEGORY>
   <CATEGORY name="Requirement Category" refname="Microsoft.RequirementCategory">
      <DEFAULTWORKITEMTYPE name="Product Backlog Item" />
      <WORKITEMTYPE name="Bug" />
   </CATEGORY>
   <CATEGORY name="Test Case Category" refname="Microsoft.TestCaseCategory">
      <DEFAULTWORKITEMTYPE name="Test Case" />
   </CATEGORY>
   <CATEGORY name="Shared Step Category" refname="Microsoft.SharedStepCategory">
      <DEFAULTWORKITEMTYPE name="Shared Steps" />
   </CATEGORY>
   <CATEGORY name="Code Review Request Category" refname="Microsoft.CodeReviewRequestCategory">
      <DEFAULTWORKITEMTYPE name="Code Review Request" />
   </CATEGORY>
   <CATEGORY name="Code Review Response Category" refname="Microsoft.CodeReviewResponseCategory">
      <DEFAULTWORKITEMTYPE name="Code Review Response" />
   </CATEGORY>
   <CATEGORY name="Feedback Request Category" refname="Microsoft.FeedbackRequestCategory">
      <DEFAULTWORKITEMTYPE name="Feedback Request" />
   </CATEGORY>
   <CATEGORY name="Feedback Response Category" refname="Microsoft.FeedbackResponseCategory">
      <DEFAULTWORKITEMTYPE name="Feedback Response" />
   </CATEGORY>
   <CATEGORY name="Task Category" refname="Microsoft.TaskCategory">
      <DEFAULTWORKITEMTYPE name="Task" />
   </CATEGORY>
   <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
      <DEFAULTWORKITEMTYPE name="Code Review Request" />
      <WORKITEMTYPE name="Code Review Response" />
      <WORKITEMTYPE name="Feedback Request" />
      <WORKITEMTYPE name="Feedback Response" />
      <WORKITEMTYPE name="Shared Steps" />
   </CATEGORY>
</cat:CATEGORIES>

カテゴリに基づくクエリのフィルター処理

作業項目の種類が選択したカテゴリに属しているすべての作業項目に基づいてリストをフィルター処理する作業項目クエリを定義できます。このクエリを使用するには、グループ内演算子を使用します。たとえば、次のフィルター条件では、現在のチーム プロジェクトにあり、そのチーム メンバーに割り当てられていて、Bug Category に属すると定義されているすべての作業項目が返されます。

および/または

フィールド

[演算子]

価値

 

チーム プロジェクト

=

@Project

AND

担当者

=

@Me

AND

作業項目の種類

グループ内

バグ カテゴリ

参照

関連項目

カテゴリ定義のスキーマ リファレンス

作業項目の種類のカテゴリのカスタマイズ [witadmin]

概念

すべての WITD XML 要素のリファレンス

プロジェクトの追跡データ、フォーム、ワークフロー、その他のオブジェクトのカスタマイズ

その他の技術情報

作業項目の種類のカテゴリをグループ化するカテゴリの定義