Partager via

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

  • Article

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

Élément

Attribut

Description

CATEGORIES

 

Élément requis dans le fichier de catégories XML.

Élément conteneur pour la spécification d'un ou plusieurs éléments CATEGORY définis pour un projet d'équipe.

CATEGORY

 

Élément enfant CATEGORIES requis.

Spécifie un groupe de catégories nommées qui contient un élément DEFAULTWORKITEMTYPE par défaut et zéro, un ou plusieurs éléments WORKITEMTYPE.

 

name

Attribut CATEGORY requis.

Le type de l'attribut est typelib:FriendlyName.

Spécifie le nom complet de la catégorie. Doit être entre 1 et 254 caractères et unique dans le projet d'équipe.

 

refname

Attribut CATEGORY requis.

Le type de l'attribut est typelib:ReferenceName.

Pour plus d'informations, consultez Conventions d'affectation de noms pour les objets de suivi des éléments de travail.

DEFAULTWORKITEMTYPE

 

Élément CATEGORY obligatoire.

Spécifie un type d'élément de travail qui doit être référencé comme appartenant à la catégorie nommée et être utilisé comme type par défaut pour la catégorie.

 

name

Attribut DEFAULTWORKITEMTYPE requis.

Le type de l'attribut est WorkItemTypeRef.

Spécifie le nom de référence d'un type d'élément de travail valide pour le projet d'équipe qui sera utilisé comme type par défaut pour la catégorie.

WORKITEMTYPE

 

Élément CATEGORY facultatif.

Spécifie un type d'élément de travail devant être référencé comme appartenant à la catégorie nommée.

 

name

Attribut WORKITEMTYPE requis.

Le type de l'attribut est WorkItemTypeRef.

Spécifie le nom de référence d'un type d'élément de travail valide pour le projet d'équipe qui appartiendra à la catégorie nommée.

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

Espace de noms

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

Nom du schéma

Catégories

Fichier de validation

Categories.xsd

Type d'élément

CATEGORIES, CATEGORY, DEFAULTWORKITEMTYPE, WORKITEMTYPE

Peut être vide

Oui

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

Tâches

Créer une catégorie de types d'éléments de travail

Autres ressources

Regroupement de types d'éléments de travail en catégories