Référence de schéma de définition de catégories

Vous utilisez l'élément CATEGORIES pour définir un ou plusieurs catégories pour le regroupement de types d'éléments de travail.

Hiérarchie de schéma

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>

Attributs et éléments

Les sections suivantes décrivent les attributs et éléments du fichier XML de catégories.

Éléments enfants et attributs

Notes

CATEGORIES est l'élément racine du schéma de catégorie.

Les catégories sont définies dans l'ensemble CATEGORIES des éléments CATEGORY qui sont stockés et utilisés par un projet d'équipe.Chaque élément CATEGORIES doit avoir au moins un élément CATEGORY défini.

Une catégorie ne peut pas être vide.Chaque élément CATEGORY doit avoir au moins un élément DEFAULTWORKITEMTYPE ou WORKITEMTYPE défini.

Chaque catégorie porte un nom convivial et un nom de référence qui doivent être uniques dans le projet d'équipe.Chaque nom convivial de catégorie doit satisfaire les spécifications suivantes :

• Les noms peuvent contenir jusqu'à 254 caractères Unicode.

• Les noms ne doivent pas être vides.

• Les noms ne peuvent pas contenir d'espaces blancs de début ou de fin.

• Les noms ne peuvent pas contenir de barres obliques inverses (\).

• Les noms ne peuvent pas contenir deux espaces blancs consécutifs.

Les noms conviviaux de catégorie ne sont pas localisés et ne peuvent pas être transformés en jeton, alors que les noms pour les types d'éléments de travail sont localisés et peuvent être transformés en jeton.

Pour les conventions d'affectation des noms de référence, consultez Conventions d'affectation de noms pour les objets de suivi des éléments de travail.

Exemple

L'exemple suivant spécifie un fichier XML de catégories qui peut être importé dans un projet d'équipe.Il définit quatre catégories et assigne uniquement un type d'élément de travail par défaut pour chacune.

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

Informations sur les éléments

Définition de schéma de catégorie

Le code suivant affiche la définition de schéma correspondant à l'objet de suivi des éléments de travail de catégories :

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

Voir aussi

Autres ressources

Définir des catégories pour regrouper des types d'éléments de travail