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

Article
11/18/2015

Vous utilisez l'élément CATEGORIES pour regrouper des types d'éléments de travail (WIT). Utiliser les catégories pour regrouper les types d'éléments de travail fournit une description de chacune des catégories par défaut utilisées par Visual Studio Online et Team Foundation Server (TFS).

<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é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. Spécifiez un nom de plus de 70 caractères Unicode qui utilise des caractères alphanumériques, des traits de soulignement et des traits d'union. Le nom de référence doit contenir au moins un point (.), mais aucun point ne peut apparaître au début ou à la fin d'un nom. En outre, le nom de référence ne peut pas commencer par un chiffre ou un trait de soulignement, ni contenir plusieurs traits d'union consécutifs tels que (--). Ne spécifiez pas un nom qui reprend le mot réservé System. XXX et Microsoft. Espaces de noms XXX. 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.

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

Quand vous assignez des WIT à des catégories, tenez compte des remarques opérationnelles suivantes :

Pour utiliser le tableau du Backlog et le tableau de tâches, vous devez attribuer au moins un WIT à la catégorie de spécification et un WIT à la catégorie de tâche.
Vous ne pouvez pas assigner le même type d'élément de travail à la catégorie de spécifications et à la catégorie de tâche.
Si vous incluez plusieurs types d'élément de travail à la catégorie de spécifications ou à la catégorie de tâche, le type assigné à l'élément DEFAULTWORKITEMTYPE apparaîtra comme type par défaut sur les pages du tableau et du backlog Agile.
Les WIT appartenant à une catégorie qui définit un backlog dans le fichier ProcessConfiguration doivent avoir un état de démarrage, de fermeture et au moins de flux de travail intermédiaire mappé sur un méta-état valide comme décrit dans Informations de référence sur les éléments XML de configuration de processus.
Les WIT que vous attribuez à la catégorie de bogue peuvent être configurés pour apparaître dans les backlogs et les tableaux de chaque équipe. Vous configurez le comportement par défaut en définissant la propriété pour BugsBehavior 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 Scrum.

<?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="Epic Category" refname="Microsoft.EpicCategory">
    <DEFAULTWORKITEMTYPE name="Epic" />
  </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>

Voir aussi

Autres ressources

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

Partager via