分類定義結構描述參考

發行項
08/12/2011

您使用 CATEGORIES 項目來定義一或多個群組工作項目型別的分類。

結構描述階層架構

CATEGORIES Element (CATEGORIES Definition Schema)

** CATEGORY Element (CATEGORIES Definition Schema)**

** DEFAULTWORKITEMTYPE Element (CATEGORIES Definition Schema)**

** WORKITEMTYPE Element (CATEGORIES Definition Schema)**

<xs:element name="CATEGORIES">
<xs:element name="CATEGORY" minOccurs="0" maxOccurs="unbounded">
<xs:element name="DEFAULTWORKITEMTYPE" type="WorkItemTypeRef" />
<xs:element name="WORKITEMTYPE" type="WorkItemTypeRef" minOccurs="0" maxOccurs="unbounded"/>

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

屬性和項目

下列章節描述分類 XML 檔案的屬性和項目。

子項目及屬性

項目	屬性	描述
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 是分類結構描述的根項目。

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

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

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

名稱可以多達 254 個 Unicode 字元
名稱不得為空白。
名稱的開頭與結尾不可以有空格。
名稱不可包含反斜線 (\) 字元。
名稱不可包含兩個連續的空白字元。

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

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

範例

下列範例指定可以匯入至 Team 專案中的分類 XML 檔。它會定義四個分類，並只將預設工作項目類型指派給每個分類。

<?xml version="1.0" encoding="utf-8"?>
<cat:CATEGORIES xmlns:cat="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories">
   <CATEGORY refname="Microsoft.BugCategory" name="Bug Category">
      <DEFAULTWORKITEMTYPE name="Bug" />
   </CATEGORY>
   <CATEGORY refname="Microsoft.RequirementCategory" name="Requirement Category">
      <DEFAULTWORKITEMTYPE name="User Story" />
   </CATEGORY>
   <CATEGORY refname="Microsoft.SharedStepCategory" name="Shared Step Category">
      <DEFAULTWORKITEMTYPE name="Shared Steps" />
   </CATEGORY>
   <CATEGORY refname="Microsoft.TestCaseCategory" name="Test Case Category">
      <DEFAULTWORKITEMTYPE name="Test Case" />
   </CATEGORY>
</cat:CATEGORIES>

項目資訊

命名空間	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories
結構描述名稱	分類
驗證檔	Categories.xsd
項目型別	CATEGORIES, CATEGORY, DEFAULTWORKITEMTYPE, WORKITEMTYPE
可以是空白	是

分類結構描述定義

下列程式碼會列出分類工作項目追蹤物件的結構描述定義：

<?xml version="1.0" encoding="utf-8" ?> 
<xs:schema targetNamespace="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories"
  elementFormDefault="unqualified"
  attributeFormDefault="unqualified"
  xmlns="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories"
  xmlns:xs="http://www.w3.org/2001/XMLSchema"
  xmlns:typelib="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typelib">  
  <xs:import namespace="https://schemas.microsoft.com/VisualStudio/2009/workitemtracking/typelib"/> 
  <xs:element name="CATEGORIES">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="CATEGORY" minOccurs="0" maxOccurs="unbounded">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="DEFAULTWORKITEMTYPE" type="WorkItemTypeRef" />
              <xs:element name="WORKITEMTYPE" type="WorkItemTypeRef" minOccurs="0" maxOccurs="unbounded"/>
            </xs:sequence>
            <xs:attribute name="refname" type="typelib:ReferenceName" use="required"/>
            <xs:attribute name="name" type="typelib:FriendlyName" use="required"/>
          </xs:complexType>
          <xs:unique name="WorkItemTypeName">
            <xs:selector xpath="*"/>
            <xs:field xpath="@name"/>
          </xs:unique>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
    <xs:unique name="CategoryRefName">
      <xs:selector xpath="CATEGORY"/>
      <xs:field xpath="@refname"/>
    </xs:unique>
    <xs:unique name="CategoryName">
      <xs:selector xpath="CATEGORY"/>
      <xs:field xpath="@name"/>
    </xs:unique>
  </xs:element>
  <xs:complexType name="WorkItemTypeRef">
    <xs:attribute name="name" type="typelib:NonEmptyPlainConstant" use="required"/>
  </xs:complexType>
</xs:schema>

共用方式為