Partager via

Définir et personnaliser des objets pour le suivi des éléments de travail en utilisant le plug-in de suivi d'élément de travail

  • Article

À l'aide du plug-in Suivi des éléments de travail, vous définissez les objets initiaux d'un projet d'équipe pour le suivi d'un travail. Ces objets comprennent des types d'éléments de travail, des requêtes d'élément de travail, des catégories, des types de liens, des listes globales et des instances d'éléments de travail. Après avoir créé un projet d'équipe, vous pouvez modifier ces objets à l'aide de l'outil en ligne de commande witadmin.

Dans le fichier de plug-in, vous spécifiez une ou plusieurs tâches et leurs dépendances. En général, vous spécifiez une tâche pour chaque activité de téléchargement majeure, telle que des types de liens, des types d'éléments de travail, des requêtes et des catégories.

Important

Vous devez spécifier les tâches pour télécharger des fichiers et définir des requêtes dans une séquence spécifique : les types de liens en premier, suivis des types d'éléments de travail, puis des requêtes. Chaque fichier de définition pour ces objets dépend des définitions spécifiées dans les tâches qui les précèdent. En général, vous devez maintenir la séquence de tâches définie dans le modèle de processus que vous personnalisez. Pour plus d'informations, consultez Définir des dépendances pour des groupes de tâches et des tâches dans des fichiers de plug-in.

Dans cette rubrique

  • Nom et emplacement du plug-in Suivi des éléments de travail

  • Structure de la syntaxe du plug-in Suivi des éléments de travail

  • Référence des éléments pour le plug-in Suivi des éléments de travail

Pour obtenir des informations spécifiques sur chaque type d'objet que vous pouvez définir, consultez l'une des rubriques suivantes :

Nom et emplacement du plug-in Suivi des éléments de travail

Le tableau suivant récapitule le nom et l'emplacement du fichier des modèles de processus Microsoft Solutions Framework (MSF), en plus du nom du plug-in.

Nom du fichier :

WorkItems.xml

Emplacement du fichier :

Dossier WorkItem Tracking

Nom du plug-in :

Microsoft.ProjectCreationWizard.WorkItemTracking

Notes

Vous pouvez changer le nom et l'emplacement du fichier XML, mais pas le nom du plug-in. Visual Studio Team Foundation Server n'inclut aucun mécanisme de déploiement de plug-ins côté client, de stratégies ou d'autres modifications. Si vous ne voulez pas déployer ce genre de fonctionnalités, vous devez utiliser votre propre programme de distribution et d'installation.

Retour au début

Structure de la syntaxe du plug-in Suivi des éléments de travail

Le fichier de plug-in pour le suivi des éléments de travail doit être conforme à la définition de schéma qui est spécifiée dans le fichier WorkItemMethodology.xsd, et le plug-in doit être indiqué dans son propre fichier. Vous pouvez télécharger les fichiers de schéma de modèles de processus à partir de la page suivante du site Web Microsoft : Process Template and Work Item Schemas for Visual Studio Team Foundation.

La syntaxe suivante indique la structure de niveau supérieur du plug-in Suivi des éléments de travail. Quatre tâches sont spécifiées, chacune consistant à télécharger les définitions des types de liens, les types d'éléments de travail, les requêtes et les catégories. Si vous deviez ajouter des définitions de listes globales ou d'instances d'éléments de travail, vous devriez spécifier une tâche supplémentaire pour chacune d'elles.

Pour obtenir une description de chaque élément, consultez la section Référence des éléments pour le plug-in Suivi des éléments de travail plus loin dans cette rubrique.

<?xml version="1.0" encoding="utf-8"?>
<tasks>
  <task id="LinkTypes" name="LinkType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item link types created">
    <taskXml>
      <LINKTYPES>
        <LINKTYPE />
   . . . 
      </LINKTYPES>
    </taskXml>
  </task>
  <task id="WITs" name="WorkItemType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item types created">
    <dependencies>
      <dependency taskId="LinkTypes" />
    </dependencies>
    <taskXml>
      <WORKITEMTYPES>
        <WORKITEMTYPE />
   . . . 
      </WORKITEMTYPES>
    </taskXml>
  </task>
  <task id="Queries" name="Stored Query Definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item queries uploaded">
    <dependencies>
      <dependency taskId="WITs" />
    </dependencies>
    <taskXml>
      <QUERIES>
        <Permission />
   . . . 
        <QueryFolder >
          <Query />
   . . . 
        </QueryFolder>
   . . . 
      </QUERIES>
    </taskXml>
  </task>
  <task id="Categories" name="Categories definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item type categories created">
    <dependencies>
      <dependency taskId="WITs" />
    </dependencies>
    <taskXml>
      <CATEGORIES fileName="WorkItem Tracking\Categories.xml" />
    </taskXml>
  </task>
</tasks>

Retour au début

Référence des éléments pour le plug-in Suivi des éléments de travail

Le tableau suivant décrit les éléments que vous utilisez pour télécharger des objets de suivi des éléments de travail. Vous spécifiez ces éléments dans un élément conteneur taskXml dans le fichier de plug-in Suivi des éléments de travail. Pour plus d'informations sur les éléments de tâche, de dépendance et taskXml, consultez Définir les tâches pour traiter un plug-in.

Élément

Syntaxe

Description

CATEGORIES

 
<CATEGORIES fileName="CategoriesFilePathName" />

Élément enfant facultatif de l'élément taskXml pour le plug-in Suivi des éléments de travail.

Spécifie le chemin d'accès et le nom du fichier qui contient les définitions de catégories à télécharger lorsque la tâche de plug-in Suivi des éléments de travail est traitée.

FIELD

 
<FIELD refname="FieldReferenceName" value="Value" />

Élément enfant obligatoire de WI.

Définit une valeur pour un champ de l'instance d'élément de travail.

GLOBALLISTS

 
<GLOBALLISTS fileName="GlobalListFilePathName" />

Élément enfant facultatif de l'élément taskXml pour le plug-in Suivi des éléments de travail.

Spécifie le chemin d'accès et le nom du fichier qui contient les définitions de listes globales à télécharger lorsque la tâche de plug-in Suivi des éléments de travail est traitée.

HYPERLINK

 
<HYPERLINK URL="URL" relativePath="false" />

Élément enfant facultatif de WI.

Définit un lien hypertexte pour l'instance d'élément de travail.

LINKTYPE

 
<LINKTYPE fileName="LinkTypeFilePathName" />

Élément enfant obligatoire de LINKTYPES.

Spécifie le chemin d'accès et le nom d'un fichier qui contient une définition de type de lien à télécharger.

LINKTYPES

 
<LINKTYPES>
     <LINKTYPE />
 . . .
</LINKTYPES>

Élément enfant facultatif de l'élément taskXml pour le plug-in Suivi des éléments de travail.

Contient une collection d'éléments LINKTYPE spécifiant chacun un fichier de définition à télécharger.

Permission

 
<permission allow="ListOfPermissions" identity="GroupName" />

Élément enfant facultatif de Query.

Spécifie les autorisations par défaut assignées aux requêtes d'équipe. Pour plus d'informations, consultez Assignation d'autorisations pour les requêtes d'éléments de travail.

Query

 
<Query name="QueryName" fileName="QueryFilePathName" />

Élément enfant obligatoire de QUERIES.

Spécifie le nom et le chemin d'accès du fichier .wiq qui définit une requête à télécharger.

QueryFolder

 
<QueryFolder name="
FolderName
">

Élément enfant facultatif de QUERIES.

Spécifie le nom d'un dossier de requêtes.

QUERIES

 
<QUERIES>
   . . . 
</QUERIES>

Élément enfant facultatif de l'élément taskXml pour le plug-in Suivi des éléments de travail.

Spécifie les fichiers de définition de requête à utiliser pour créer des requêtes par défaut.

WI

 
<WI type="WorkItemType">
   <FIELD> . . .</FIELD>
   <HYPERLINK> . . .</HYPERLINK>
</WI>

Élément enfant obligatoire de WORKITEMS.

Définit un type d'élément de travail à créer et les valeurs à assigner à des champs spécifiques.

WORKITEMS

 
WORKITEMS>
   <WI>
      <FIELD> . . .</FIELD>
      <HYPERLINK> . . .</HYPERLINK>
   </WI>
</WORKITEMS >

Élément enfant facultatif de l'élément taskXml pour le plug-in Suivi des éléments de travail.

Contient une collection d'éléments WI définissant chacun une instance d'élément de travail.

WORKITEMTYPE

 
<WORKITEMTYPE fileName="WITFilePathName" />

Élément enfant obligatoire de WORKITEMTYPES.

Spécifie le chemin d'accès et le nom du fichier qui contient une définition de type à télécharger.

WORKITEMTYPES

 
<WORKITEMTYPES> 
    <WORKITEMTYPE />
 . . .
</WORKITEMTYPES>

Élément enfant obligatoire du plug-in Suivi des éléments de travail.

Contient une collection d'éléments WORKITEMTYPE spécifiant chacun un fichier de définition à télécharger.

Retour au début

Voir aussi

Tâches

Vérifier les modifications de définition du type d'élément de travail

Concepts

Processus étape par étape de personnalisation

Personnalisation des données de suivi de projet, de formulaires, de flux de travail et d'autres objets

Utilisation de fichiers de modèles de processus

Personnalisation de domaines fonctionnels au sein d'un modèle de processus

Autres ressources

Personnalisation des modèles de processus

Historique des modifications

Date

Historique

Motif

Avril 2011

Ajout d'une section de référence d'éléments et ajout de liens vers des rubriques individuelles qui présentent chaque type d'objet de suivi. Liens retirés vers les rubriques qui ont été supprimées.

Améliorations apportées aux informations.