类别 XML 元素参考

Azure DevOps Services |Azure DevOps Server 2022 |Azure DevOps Server 2020 |Azure DevOps Server 2019 |TFS 2018

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

特性和元素

元素 Attribute 说明
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 元素必须至少定义一个 DEFAULTWORKITEMTYPEWORKITEMTYPE 元素。

每个类别都有一个友好名称和一个在项目中必须唯一的引用名称。 每个类别友好名称必须满足以下要求:

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

  • 名称不能是空的。

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

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

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

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

Azure Boards工具、类别要求和限制

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

  • 若要使用积压工作和任务板,必须将至少一个工作项类型分配给要求类别,并将一个工作项类型分配给任务类别。

  • 您无法将同一工作项类型同时分配给要求类别和任务类别。

  • 如果在“要求类别”或“任务类别”中包含多个工作项类型,则分配给DEFAULTWORKITEMTYPE该元素的类型将显示在Azure Boards积压工作和板页上的默认类型。

  • 属于在 ProcessConfiguration 文件中定义积压积压的工作项类型必须有一个开始、关闭和至少一个中间工作流状态,如 Process Configuration XML 元素引用中所述,

  • 可以配置分配给 Bug 类别的工作项类型,以便在 每个团队的积压工作和板上显示。 通过在 ProcessConfiguration 文件中定义 BugsBehavior 的属性来设置默认行为。

示例

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

<?xml version="1.0" encoding="utf-8"?>  
<cat:CATEGORIES xmlns:cat="http://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories">  
  <!-- Usage: for resilience in Test system. Even if work item types 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>