Informazioni di riferimento sullo schema di definizione delle categorie

Si utilizza l'elemento CATEGORIES per definire uno o più categorie per il raggruppamento dei tipi di elemento di lavoro.

Gerarchia dello schema

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>

Attributi ed elementi

Nelle sezioni riportate di seguito vengono descritti gli attributi e gli elementi per il file XML delle categorie.

Elementi figli e attributi

Note

CATEGORIES è l'elemento radice dello schema delle categorie.

Una categoria viene definita all'interno del set CATEGORIES di elementi CATEGORY archiviato e utilizzato da un progetto team.Ogni elemento CATEGORIES deve contenere almeno un elemento CATEGORY definito.

Una categoria non può essere vuota.Ogni elemento CATEGORY deve contenere almeno un elemento DEFAULTWORKITEMTYPE o WORKITEMTYPE definito.

Ogni categoria dispone di un nome descrittivo e un nome riferimento che devono essere univoci all'interno del progetto team.Ogni nome descrittivo del tipo di categoria deve soddisfare i seguenti requisiti:

• I nomi non possono superare i 254 caratteri Unicode.

• I nomi non devono essere vuoti.

• I nomi non possono avere spazi vuoti iniziali o finali.

• I nomi non possono contenere caratteri barra rovesciata (\).

• I nomi non possono contenere due spazi vuoti consecutivi.

I nomi descrittivi della categoria non sono localizzati e non possono essere generati in un token, mentre i nomi per i tipi elemento di lavoro vengono localizzati e possono essere generati in un token.

Per le convenzioni di denominazione dei riferimento, vedere Convenzioni di denominazione per oggetti di rilevamento di elementi di lavoro.

Esempio

Nell'esempio seguente viene specificato un file XML di categorie che possono essere importate in un progetto team.Definisce quattro categorie e assegna solo un tipo di elemento di lavoro predefinito per ciascuno.

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

Informazioni sull'elemento

Definizione dello schema della categoria

Nel codice seguente è riportata la definizione dello schema per l'oggetto di rilevamento degli elementi di lavoro delle categorie.

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

Vedere anche

Altre risorse

Definire categorie per raggruppare tipi di elementi di lavoro