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

Article
03/04/2013

Vous pouvez personnaliser un type d'élément de travail existant ou créer un type d'élément de travail répondant aux spécifications de suivi de votre projet.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 associé au type d'élément de travail.Vous conservez et gérez des définitions de types d'éléments de travail pour chaque projet d'équipe.

Dans cette rubrique

Structure de la syntaxe d'un élément WITD
Éléments enfants d'un élément WITD
Types d'éléments de travail du modèle de processus

Structure de la syntaxe d'un élément WITD

L'exemple suivant affiche la structure supérieure d'un 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 d'un élément WITD

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 incluse dans un wrapper par la balise 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 de 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 cliquer sur 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. Remarque 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 des 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 Utilisation des champs d'élément de travail.
WORKFLOW	Contient l'ensemble des éléments STATE et TRANSITION qui définissent le flux de travail du type d'élément 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 Définir et personnaliser le flux de travail des éléments 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 pour le type d'élément de travail. `<FORM> <Layout> . . . </Layout> </FORM>` Pour plus d'informations, consultez Concevoir et personnaliser un formulaire d'élément de travail.

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

Deux ensembles de définitions de types d'éléments de travail du modèle de processus sont à votre disposition. Ils correspondent à ceux définis pour Microsoft Solutions Framework (MSF) for Agile Software Development v5.0 et MSF for Capability Maturity Model Integration (CMMI) Software Development v5.0.Ces fichiers se trouvent respectivement dans les emplacements suivants du répertoire d'installation :

Lecteur:\Program Files\Microsoft Visual Studio v10.0 Team Foundation Server\Application Tier\Web Services\Deploy\ProcessTemplateManagerFiles\MsfAgile\Template.zip
Lecteur:\Program Files\Microsoft Visual Studio v10.0 Team Foundation Server\Application Tier\Web Services\Deploy\ProcessTemplateManagerFiles\MsfFormal\Template.zip

Vous pouvez trouver les définitions de types d'éléments de travail dans le dossier WorkItem Tracking\TypeDefinitions du fichier Template.zip.Par exemple, MSF for Agile Software Development v5.0 définit un fichier XML pour chacun des types d'éléments de travail suivants : bogue, problème, étape partagée, tâche, cas de test et récit utilisateur.Pour plus d'informations sur chacun de ces types d'éléments de travail, consultez Modèle de processus Agile pour Visual Studio ALM.

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 des définitions de type pour des éléments de travail à un modèle de processus.