类别 XML 元素引用

可使用 CATEGORIES 元素对工作项类型 (WIT) 分组。 使用类别对工作项类型分组提供了 Visual Studio Online 和 Team Foundation Server (TFS) 使用的每个默认类别的描述。

<CATEGORIES>
   <CATEGORY name="category display name" refname="category reference name">
      <DEFAULTWORKITEMTYPE name="work item type reference name" />
      <WORKITEMTYPE name="work item type reference name" />
   </CATEGORY>
</CATEGORIES>

特性和元素

元素	特性	描述
CATEGORIES		XML 类别文件中的必需元素。 用于指定为团队项目定义的一个或多个 CATEGORY 元素的容器元素。
CATEGORY		必需的 CATEGORIES 子元素。 指定一个命名的类别组，该组包含一个默认 DEFAULTWORKITEMTYPE 元素和零个或多个 WORKITEMTYPE 元素。
	name	必选的 CATEGORY 特性。 特性类型为 typelib:FriendlyName。 指定类别的显示名称。 必须介于 1 个和 254 个字符之间，并且在团队项目中必须是唯一的。
	refname	必选的 CATEGORY 特性。 特性类型为 typelib:ReferenceName。 指定一个使用字母数字、下划线和连字符的名称，其长度不超过 70 个 Unicode 字符。 引用名称必须至少包含一个句点 (.)，但不能以句点作为名称的开头或结尾。 此外，引用名称不能以数字或下划线开头，而且不能包含多个连续的连字符，例如 (--)。 请勿指定与保留的系统重叠的名称。 XXX 和 Microsoft。 XXX 命名空间。 请参阅工作项跟踪对象的命名约定。
DEFAULTWORKITEMTYPE		必需的 CATEGORY 元素。 指定要标记为属于命名类别并将用作类别的默认类型的工作项类型。
	name	必选的 DEFAULTWORKITEMTYPE 特性。 特性类型为 WorkItemTypeRef。 指定团队项目的有效工作项类型的引用名称，该类型将用作类别的默认类型。
WORKITEMTYPE		可选的 CATEGORY 元素。 指定将标记为属于命名类别的工作项类型。
	name	必选的 WORKITEMTYPE 特性。 特性类型为 WorkItemTypeRef。 指定团队项目的有效工作项类型的引用名称，该类型将属于命名类别。

备注

CATEGORIES 是类别架构的根元素。

类别是在团队项目存储和使用的 CATEGORIES 元素 CATEGORY 集中定义的。 每个 CATEGORIES 元素必须至少定义一个 CATEGORY 元素。

类别不能为空。 每个 CATEGORY 元素必须至少定义一个 DEFAULTWORKITEMTYPE 或 WORKITEMTYPE 元素。

每个类别都具有一个友好名称和一个引用名称，它们在团队项目中必须是唯一的。 每个类别友好名称必须满足以下要求：

• 名称最多可以有 254 个 Unicode 字符。

• 名称不能是空的。

• 名称不能有前导空白或尾随空白。

• 名称不能包含反斜杠 (\) 字符。

• 名称不能包含两个连续空格。

类别友好名称未本地化，且无法成为标记，而工作项类型的名称将进行本地化，且可以成为标记。

Agile 工具、类别要求和限制

在将 WIT 分配给类别时，请考虑以下操作说明：

• 若要使用积压工作 (backlog) 和任务板，您必须分别向要求类别和任务类别分配至少一种 WIT。

• 您不能将同一 WIT 同时分配给要求类别和任务类别。

• 如果您在要求类别或任务类别中包含多种 WIT，分配给 DEFAULTWORKITEMTYPE 元素的类型将在敏捷积压工作 (backlog) 页和任务板页上显示为默认类型。

• 对于属于在 ProcessConfiguration 文件中定义积压工作 (backlog) 的类别的 WIT，必须具有映射到有效元数据的开始工作流状态、结束工作流状态和至少一个中间工作流状态，如过程配置 XML 元素引用中所述。

• 可将分配给 Bug 类别的 WIT 配置为显示在每个团队的积压工作 (backlog) 和面板上。 通过在 ProcessConfiguration 文件中定义 BugsBehavior 的属性设置默认行为。

示例

下面的示例列出了 Scrum 过程模板的默认类别 XML 文件。

<?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="Epic Category" refname="Microsoft.EpicCategory">
    <DEFAULTWORKITEMTYPE name="Epic" />
  </CATEGORY>
  <CATEGORY name="Feature Category" refname="Microsoft.FeatureCategory">
    <DEFAULTWORKITEMTYPE name="Feature" />
  </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="Shared Parameter Category" refname="Microsoft.SharedParameterCategory">
    <DEFAULTWORKITEMTYPE name="Shared Parameter" />
  </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="Test Plan Category" refname="Microsoft.TestPlanCategory">
    <DEFAULTWORKITEMTYPE name="Test Plan" />
  </CATEGORY>
  <CATEGORY name="Test Suite Category" refname="Microsoft.TestSuiteCategory">
    <DEFAULTWORKITEMTYPE name="Test Suite" />
  </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" />
    <WORKITEMTYPE name="Shared Parameter" />
    <WORKITEMTYPE name="Test Plan" />
    <WORKITEMTYPE name="Test Suite" />
  </CATEGORY>
</cat:CATEGORIES>

请参见

其他资源

使用类别对工作项类型进行分组