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

Article
11/18/2015

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 champs, les règles, ainsi que les états et les transitions de flux de travail d'un élément de travail qui sera suivi pour un projet d'équipe, par exemple un bogue, une spécification ou un risque. Vous créez une équipe de projet dans Visual Studio Online ou sur un serveur Team Foundation Server (TFS) localement.

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 128 caractères Unicode.

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. La portée des types d'éléments de travail est limitée à un projet d'équipe dans une collection de projets.

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:WITD application="Work item type editor" version="1.0" xmlns:witd="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef">
    <WORKITEMTYPE name="bug" refname="Microsoft.VSTS.WorkItemTypes.Bug">
        <DESCRIPTION> Describes a divergence between required and actual behavior, and tracks the work done to correct the defect and verify the correction.</DESCRIPTION>
        <GLOBALLISTS> . . . </GLOBALLISTS>
        <FIELDS> . . . </FIELDS>
        <WORKFLOW> . . . </WORKFLOW>
        <FORM> . . . </FORM>
    </WORKITEMTYPE>
</witd:WITD>

É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 WIT qui peut changer d'une version à l'autre. Utilisez "1.0". `<witd:WITD application="Work item type editor" version="1.0" xmlns:witd="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef"> <WORKITEMTYPE> . . .</WORKITEMTYPE> </witd: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" refname="WITReferenceName" > <DESCRIPTION>Text</DESCRIPTION> <GLOBALLISTS> . . .</</GLOBALLISTS> <FIELDS> . . . </FIELDS> <WORKFLOW> . . . </WORKFLOW> <FORM> . . .</</FORM> </WORKITEMTYPE>` Nom convivial : ce nom apparaît dans les menus déroulants des requêtes d'éléments de travail. Le nom convivial doit être unique pour tous les noms de type d'élément de travail qui sont définis dans un projet d'équipe. Spécifiez un nom de plus de 128 caractères Unicode qui utilise des caractères alphanumériques, des traits de soulignement et des traits d'union. Nom de référence : 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.
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 WIT. Vous utilisez les listes globales afin de partager des listes de choix entre plusieurs WIT définis pour une collection de projets d'équipe. L'utilisation de listes globales facilite la collaboration entre groupes et la maintenance. `<GLOBALLIST name="globalListName"> <LISTITEM> . . . </LISTITEM> </GLOBALLIST>`
FIELDS	Définit les champs utilisés pour suivre les données du WIT. Dans l'élément FIELDS, vous définissez tous les champs que vous souhaitez utiliser pour assurer le suivi des données. Cela inclut les champs que vous utiliserez pour exécuter des requêtes et créer des rapports. `<FIELDS> <FIELD> . . . </FIELD> </FIELDS>`
WORKFLOW	Définit les éléments de flux de travail qui permettent de suivre l'état d'un élément de travail quand il passe d'un état nouveau à fermé ou terminé. Cet élément 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>`
FORM	Spécifie le design du formulaire d'élément de travail en définissant les champs et les contrôles qui apparaissent sur le formulaire et l'ordre dans lequel ils apparaissent. Il contient LAYOUT, CONTROL, GROUP, TAB, TABGROUP, SPLITTER et d'autres éléments. `<FORM> <Layout> . . . </Layout> </FORM>`

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

Pendant l'installation ou la mise à niveau d'une instance de TFS, les modèles de processus par défaut sont téléchargés dans le répertoire suivant :

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

Les fichiers de définition de WIT sont stockés dans le dossier WorkItem Tracking\TypeDefinitions.

Pour savoir comment créer ou personnaliser un WIT, consultez Personnaliser les objets de suivi de travail pour prendre en charge les processus de votre équipe. Pour ajouter un nouveau WIT à votre modèle de processus. 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

Partager via