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>
Nelle sezioni riportate di seguito vengono descritti gli attributi e gli elementi per il file XML delle categorie.
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. |
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.
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>
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ì |
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>