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

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>

É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.

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 :

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="http://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>
Afficher: