Share via


Référence de tous les éléments XML WITD

vous pouvez personnaliser un type d'élément de travail existant ou en créer un pour répondre à vos besoins en matière de suivi de projets. Un type d'élément de travail définit les règles, les champs, les états et les transitions des éléments de travail qui seront suivis pour un projet d'équipe, par exemple un bogue, une spécification ou un risque.

Un type d'élément de travail ne peut pas être vide. L'élément racine dans chaque définition d'un type d'élément de travail est l'élément WITD, qui doit avoir un seul élément WORKITEMTYPE défini. Le nom de chaque type d'élément de travail doit être unique dans un projet d'équipe. En outre, la longueur de chaque nom de type ne doit pas dépasser 254 caractères Unicode. Pour plus d'informations, consultez Conventions d'affectation de noms pour les objets de suivi des éléments de travail.

Pour personnaliser ou créer une définition de type d'élément de travail, vous devez modifier le fichier XML de définition de type. Vous conservez et gérez des définitions de types d'éléments de travail pour chaque projet d'équipe.

Structure de la syntaxe d'une définition de type d'élément de travail

L'exemple suivant montre la structure de haut niveau d'une définition de type d'élément de travail.

<WITD application="work item type editor" version="1.0">
    <WORKITEMTYPE name="bug">
        <DESCRIPTION>Bug work item types are used to track defects in the code.</DESCRIPTION>
        <GLOBALLISTS> . . . </GLOBALLISTS>
        <FIELDS> . . . </FIELDS>
        <WORKFLOW> . . . </WORKFLOW>
        <FORM> . . . </FORM>
    </WORKITEMTYPE>
</WITD>

Un petit nombre d'éléments XML apparaît entre les balises WORKITEMTYPE aux niveaux les plus élevés de la définition du type d'élément de travail. Vous devez commencer la définition d'un type d'élément de travail en lui attribuant un nom et une description. Vous devez également utiliser certaines balises XML standard pour encapsuler la définition du type d'élément de travail.

Éléments enfants de définition de type d'élément de travail

Les éléments structurels utilisés dans l'exemple précédent sont décrits dans le tableau suivant :

Élément

Description

WITD

La définition complète du type d'élément de travail est entourée de balises WITD. Vous pouvez donner n'importe quel nom à l'application. La version identifie le schéma du type d'élément de travail qui passe d'une version à la suivante. Utilisez "1.0".

<WITD application="Work item type editor" version="1.0 [1]">
   <WORKITEMTYPE> . . .</WORKITEMTYPE>
</WITD>

WORKITEMTYPE

Les noms des types d'éléments de travail d'un projet d'équipe spécifique doivent être uniques. Au moment de l'exécution, vous utilisez le nom spécifié par cet élément. Par exemple, le nom peut s'afficher comme option de menu. Dans ce cas, un utilisateur peut sélectionner Bogue dans le menu Nouvel élément de travail.

<WORKITEMTYPE name="WorkItemTypeName">
    <DESCRIPTION>Text</DESCRIPTION>
    <GLOBALLISTS> . . .</</GLOBALLISTS>
    <FIELDS> . . . </FIELDS>
    <WORKFLOW> . . . </WORKFLOW>
    <FORM> . . .</</FORM>
</WORKITEMTYPE>

DESCRIPTION

Spécifie une chaîne qui décrit le type d'élément de travail que vous définissez. La description doit aider tout utilisateur qui personnalise le type d'élément de travail.

Notes

Vous ne pouvez consulter la description que dans la définition XML.Vous ne pouvez pas consulter la description dans l'interface utilisateur. En outre, la description n'a aucune relation avec le champ System.Definition.

<DESCRIPTION> DescriptionOfWorkItemType</DESCRIPTION>

Vous spécifiez une chaîne de texte qui décrit le type d'élément de travail que vous définissez.

GLOBALLISTS

Contient les définitions de listes globales utilisées par le type d'élément de travail. Vous utilisez les listes globales afin de partager des éléments de liste entre plusieurs types d'éléments de travail pour une collection de projets d'équipe. L'utilisation de listes globales permet de faciliter la maintenance et la collaboration entre groupes.

<GLOBALLIST name="globalListName">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>

Pour plus d'informations, consultez Définir les listes globales.

FIELDS

Contient l'ensemble des définitions de champ utilisées par le type d'élément de travail. Dans l'élément FIELDS, vous définissez tous les champs que vous souhaitez utiliser pour assurer le suivi des données du type d'élément de travail. Cela inclut les champs que vous utiliserez pour exécuter des requêtes et créer des rapports.

<FIELDS>
   <FIELD> . . . </FIELD>
</FIELDS>

Pour plus d'informations, consultez Définir et modifier les champs des éléments de travail.

WORKFLOW

Contient l'ensemble des éléments STATE et TRANSITION qui définissent le flux de travail. Le flux de travail est un jeu de transitions valides d'un état à un autre avec les conditions spécifiques associées à chaque transition.

<WORKFLOW>
   <STATES> . . . </STATES>
   <TRANSITIONS> . . . </TRANSITIONS>
</WORKFLOW>

Pour plus d'informations, consultez Modifier le flux de travail pour un type d'élément de travail.

FORM

Contient LAYOUT, CONTROL, GROUP, TAB, TABGROUP, SPLITTER et d'autres éléments qui définissent les champs et les contrôles qui figurent sur le formulaire, ainsi que l'affichage de ces éléments sur le formulaire.

<FORM>
   <Layout> . . . </Layout>
</FORM>

Pour plus d'informations, consultez Concevoir le formulaire d'élément de travail.

Types d'éléments de travail du modèle de processus

TFS fournit trois modèles de processus par défaut. Ces fichiers se trouvent dans le répertoire suivant :

%programfiles%/Microsoft Team Foundation Server 12.0/Tools/Deploy/ProcessTemplateManagerFiles/1033

Vous pouvez trouver les définitions de types d'éléments de travail dans le dossier WorkItem Tracking\TypeDefinitions. Pour plus d'informations, consultez Utiliser des artefacts de projet d'équipe, choisir un modèle de processus.

Vous pouvez personnaliser ou créer des fichiers de définition de type dans le dossier TypeDefinitions. Vous pouvez ensuite importer votre nouveau type d'élément de travail dans un projet unique ou l'ajouter à votre modèle de processus et télécharger le modèle modifié sur votre serveur Team Foundation Server. Pour plus d'informations, consultez Ajouter les définitions de type pour les éléments de travail à un modèle de processus.

Voir aussi

Concepts

Personnaliser les objets de suivi de travail pour prendre en charge les processus de votre équipe

Autres ressources

witAdmin : personnaliser et gérer des objets pour le suivi des éléments de travail