Informazioni di riferimento sullo schema di definizione delle categorie

Articolo
03/26/2013

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

Altre risorse

Definire categorie per raggruppare tipi di elementi di lavoro

Condividi tramite