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

Elemento

Attribute

Oggetto di descrizione

CATEGORIES

 

Elemento obbligatorio all'interno del file di categorie XML.

Elemento del contenitore per la specifica di uno o più elementi CATEGORY definiti per un progetto team.

CATEGORY

 

Elemento figlio CATEGORIES obbligatorio.

Specifica un gruppo di categorie denominato che contiene un elemento DEFAULTWORKITEMTYPE predefinito e uno zero o più elementi WORKITEMTYPE.

 

name

Attributo CATEGORY obbligatorio.

Il tipo dell'attributo è typelib:FriendlyName.

Specifica il nome della visualizzazione della categoria. Deve essere compreso tra 1 e 254 caratteri e univoco all'interno del progetto team.

 

refname

Attributo CATEGORY obbligatorio.

Il tipo dell'attributo è typelib:ReferenceName.

Per ulteriori informazioni, vedere Convenzioni di denominazione per oggetti di rilevamento di elementi di lavoro.

DEFAULTWORKITEMTYPE

 

Elemento CATEGORY obbligatorio

Specifica il tipo di elemento di lavoro da contrassegnare come appartenente alla categoria denominata e da utilizzare come tipo predefinito per la categoria.

 

name

Attributo DEFAULTWORKITEMTYPE obbligatorio.

Il tipo dell'attributo è WorkItemTypeRef.

Specifica il nome di riferimento di un tipo di elemento di lavoro valido per il progetto team che sarà utilizzato come tipo predefinito per la categoria.

WORKITEMTYPE

 

Elemento CATEGORY facoltativo.

Specifica un tipo di elemento di lavoro che deve essere contrassegnato come appartenente a una categoria denominata.

 

name

Attributo WORKITEMTYPE obbligatorio.

Il tipo dell'attributo è WorkItemTypeRef.

Specifica il nome di riferimento di un tipo di elemento di lavoro valido per il progetto team che apparterrà alla categoria denominata.

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

Spazio dei nomi

https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories

Nome di schema

Categorie

File di convalida

Categories.xsd

Tipo di elemento

CATEGORIES, CATEGORY, DEFAULTWORKITEMTYPE, WORKITEMTYPE

Può essere vuoto

Sì

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

Attività

Creare una categoria per i tipi di elementi di lavoro

Altre risorse

Raggruppamento dei tipi di elementi di lavoro in categorie