类别 XML 元素引用

项目
06/09/2015

使用 CATEGORIES 元素可定义用于对工作项类型进行分组的一个或多个类别。

<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。有关详细信息，请参阅工作项跟踪对象的命名约定。
DEFAULTWORKITEMTYPE		必需的 CATEGORY 元素。指定要标记为属于命名类别并将用作类别的默认类型的工作项类型。
	name	必选的 DEFAULTWORKITEMTYPE 特性。特性类型为 WorkItemTypeRef。指定团队项目的有效工作项类型的引用名称，该类型将用作类别的默认类型。
WORKITEMTYPE		可选的 CATEGORY 元素。指定将标记为属于命名类别的工作项类型。
	name	必选的 WORKITEMTYPE 特性。特性类型为 WorkItemTypeRef。指定团队项目的有效工作项类型的引用名称，该类型将属于命名类别。

备注

CATEGORIES 是类别架构的根元素。

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

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

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

名称最多可以有 254 个 Unicode 字符。
名称不能是空的。
名称不能有前导空白或尾随空白。
名称不能包含反斜杠 (\) 字符。
名称不能包含两个连续空格。

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

有关引用命名约定，请参见工作项跟踪对象的命名约定。

Agile 工具、类别要求和限制

您可以指定将哪些类型的工作项视为积压工作 (backlog) 项或任务项。例如，Scrum 过程模板将 Bug 和产品积压工作 (backlog) 项类型分配给要求类别，而 Agile 模板将分配用户情景，CMMI 模板将分配要求。所有默认过程模板将工作项的任务类型分配给任务类别。

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

若要使用积压工作 (backlog) 和任务板，您必须分别向要求类别和任务类别分配至少一个工作项类型。
您无法将同一工作项类型同时分配给要求类别和任务类别。
如果您在要求类别或任务类别中包含多种工作项类型，则分配给 DEFAULTWORKITEMTYPE 元素的类型将在 Agile 积压工作 (backlog) 页和面板页上显示为默认类型。
对于分配给 ProcessConfiguration 文件中引用的类别的所有工作项类型，您必须将工作流状态分配给有效的元状态，如过程配置 XML 元素引用中所述。多个 Team Foundation 客户端将引用在 ProcessConfiguration 文件中定义的类别和元状态分配。

示例

以下示例列出 Visual Studio Scrum 2013.3 过程模板的默认类别 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="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>

元素信息

命名空间	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories
架构名称	类别
验证文件	Categories.xsd
元素类型	CATEGORIES、CATEGORY、DEFAULTWORKITEMTYPE、WORKITEMTYPE
可为空	是

请参见

其他资源

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

通过

类别 XML 元素引用

特性和元素

子元素和特性

备注

Agile 工具、类别要求和限制

示例

元素信息

请参见

其他资源

其他资源