Référence des éléments XML de catégories

Article
06/09/2015

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

<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

É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 comporter entre 1 et 254 caractères et être 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 requis. 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 remplir les conditions 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 des types d'éléments de travail sont localisés et peuvent être transformés en jeton.

Pour connaître 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.

Outils Agile, spécifications de catégorie et restrictions

Vous pouvez spécifier les types d'éléments de travail considérés comme éléments du Backlog ou comme éléments de tâche. Par exemple, le modèle de processus Scrum assigne les types Bogue et Élément du Backlog du produit à la catégorie Spécifications, alors que le modèle Agile assigne Récit utilisateur et le modèle CMMI assigne Spécification. Tous les modèles de processus par défaut assignent le type d'élément de travail Tâche à la catégorie Tâche.

Lorsque vous assignez des types d'éléments de travail à des catégories, tenez compte des remarques opérationnelles suivantes :

Pour utiliser les tableaux de Backlog et de tâches, vous devez assigner au moins un type d'élément de travail à la catégorie Spécifications et un type d'élément de travail à la catégorie Tâche.
Vous ne pouvez pas assigner le même type d'élément de travail à la catégorie Spécifications et à la catégorie Tâche.
Si vous incluez plusieurs types d'élément de travail à la catégorie Spécifications ou à la catégorie Tâche, le type assigné à l'élément DEFAULTWORKITEMTYPE apparaît comme type par défaut sur les pages du tableau et du Backlog Agile.
Pour tous les types d'éléments de travail que vous assignez à une catégorie référencée dans le fichier ProcessConfiguration, vous devez affecter les états du flux de travail à un méta-état valide comme décrit dans la section Référence des éléments XML de configuration du processus. Plusieurs clients Team Foundation référencent les assignations des catégories et des méta-états définies dans le fichier ProcessConfiguration.

Exemple

L'exemple suivant répertorie les catégories par défaut du fichier XML pour le modèle de processus Visual Studio Scrum 2013.3.

<?xml version="1.0" encoding="utf-8"?>
<cat:CATEGORIES xmlns:cat="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/categories">
  <!-- Usage: for resilience in Test system. Even if WITs have different name, they can be referred to by the category -->
  <CATEGORY name="Bug Category" refname="Microsoft.BugCategory">
    <DEFAULTWORKITEMTYPE name="Bug" />
  </CATEGORY>
  <CATEGORY name="Feature Category" refname="Microsoft.FeatureCategory">
    <DEFAULTWORKITEMTYPE name="Feature" />
  </CATEGORY>
  <CATEGORY name="Requirement Category" refname="Microsoft.RequirementCategory">
    <DEFAULTWORKITEMTYPE name="Product Backlog Item" />
    <WORKITEMTYPE name="Bug" />
  </CATEGORY>
  <CATEGORY name="Test Case Category" refname="Microsoft.TestCaseCategory">
    <DEFAULTWORKITEMTYPE name="Test Case" />
  </CATEGORY>
  <CATEGORY name="Shared Step Category" refname="Microsoft.SharedStepCategory">
    <DEFAULTWORKITEMTYPE name="Shared Steps" />
  </CATEGORY>
   <CATEGORY name="Shared Parameter Category" refname="Microsoft.SharedParameterCategory">
    <DEFAULTWORKITEMTYPE name="Shared Parameter" />
  </CATEGORY>
  <CATEGORY name="Code Review Request Category" refname="Microsoft.CodeReviewRequestCategory">
    <DEFAULTWORKITEMTYPE name="Code Review Request" />
  </CATEGORY>
  <CATEGORY name="Code Review Response Category" refname="Microsoft.CodeReviewResponseCategory">
    <DEFAULTWORKITEMTYPE name="Code Review Response" />
  </CATEGORY>
  <CATEGORY name="Feedback Request Category" refname="Microsoft.FeedbackRequestCategory">
    <DEFAULTWORKITEMTYPE name="Feedback Request" />
  </CATEGORY>
  <CATEGORY name="Feedback Response Category" refname="Microsoft.FeedbackResponseCategory">
    <DEFAULTWORKITEMTYPE name="Feedback Response" />
  </CATEGORY>
  <CATEGORY name="Test Plan Category" refname="Microsoft.TestPlanCategory">
    <DEFAULTWORKITEMTYPE name="Test Plan" />
  </CATEGORY>
  <CATEGORY name="Test Suite Category" refname="Microsoft.TestSuiteCategory">
    <DEFAULTWORKITEMTYPE name="Test Suite" />
  </CATEGORY>
  <CATEGORY name="Task Category" refname="Microsoft.TaskCategory">
    <DEFAULTWORKITEMTYPE name="Task" />
  </CATEGORY>
  <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
    <DEFAULTWORKITEMTYPE name="Code Review Request" />
    <WORKITEMTYPE name="Code Review Response" />
    <WORKITEMTYPE name="Feedback Request" />
    <WORKITEMTYPE name="Feedback Response" />
    <WORKITEMTYPE name="Shared Steps" />
    <WORKITEMTYPE name="Shared Parameter" />
    <WORKITEMTYPE name="Test Plan" />
    <WORKITEMTYPE name="Test Suite" />
  </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

Voir aussi

Autres ressources

Utiliser les catégories pour regrouper les types d'éléments de travail

Partager via