Categories XML 項目參考

您使用 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 分類檔內的必要項目。 用於指定一個或多個為 Team 專案定義之 CATEGORY 項目的容器項目。
CATEGORY		必要的 CATEGORIES 子項目。 指定具名的分類群組，其包含一個預設 DEFAULTWORKITEMTYPE 項目，以及零或多個 WORKITEMTYPE 項目。
	name	必要的 CATEGORY 屬性。 屬性類型為 typelib:FriendlyName。 指定分類的顯示名稱。 必須介於 1 到 254 個字元，而且在 Team 專案中是唯一的。
	refname	必要的 CATEGORY 屬性。 屬性類型為 typelib:ReferenceName。 如需詳細資訊，請參閱工作項目追蹤物件的命名慣例。
DEFAULTWORKITEMTYPE		必要的 CATEGORY 項目。 指定將工作項目類型標記為屬於具名分類，並且用來做為該分類的預設類型。
	name	必要的 DEFAULTWORKITEMTYPE 屬性。 屬性類型為 WorkItemTypeRef。 指定將當做預設分類類型來使用的有效 Team 專案工作項目類型的參考名稱。
WORKITEMTYPE		選擇性 CATEGORY 項目。 指定將工作項目類型標記為屬於具名分類。
	name	必要的 WORKITEMTYPE 屬性。 屬性類型為 WorkItemTypeRef。 指定將屬於具名分類之有效 Team 專案工作項目類型的參考名稱。

備註

CATEGORIES 是分類結構描述的根項目。

類別是定義在 CATEGORIES 項目的 CATEGORY 集合內，而這個集合是由 Team 專案所儲存和使用。 每個 CATEGORIES 項目都至少必須定義一個 CATEGORY 項目。

類別不能是空的。 每個 CATEGORY 項目至少必須定義一個 DEFAULTWORKITEMTYPE 或 WORKITEMTYPE 項目。

每個類別都會有一個易記名稱以及一個在 Team 專案內必須是唯一的參考名稱。 每個分類的易記名稱必須符合下列需求：

• 名稱可以多達 254 個 Unicode 字元

• 名稱不得為空白。

• 名稱的開頭與結尾不可以有空格。

• 名稱不可包含反斜線 (\) 字元。

• 名稱不可包含兩個連續的空白字元。

分類的易記名稱不會當地語系化，而且不可在語彙基元中，而工作項目類型的名稱則會當地語系化，並且可以在語彙基元中。

如需參考命名慣例，請參閱工作項目追蹤物件的命名慣例。

Agile 工具、分類需求與限制

您可以指定哪些工作項目類型可以當成待處理項目 (Backlog) 或目前工作項目。 例如，Scrum 流程範本會將 Bug 和產品待處理項目 (Backlog) 類型指派給需求分類，而 Agile 範本會將使用者劇本和 CMMI 範本指派給需求。 所有預設流程範本都會將工作項目的工作類型指派給工作分類。

當指派工作項目類型給類別時，請考量下列作業附註：

• 若要使用待處理項目和工作面板，您必須至少指派一個工作項目類型給需求分類，以及一個工作項目類型給工作分類。

• 您不能將相同的工作項目類型指派至需求分類和工作分類。

• 如果將一個以上的工作項目類型包含在需求分類或工作分類中，指派給 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
可以是空白	是

請參閱

其他資源

使用分類以分組工作項目類型