Partager via


Définir des objets pour le suivi des éléments de travail à l'aide du plug-in de suivi des éléments de travail

Le plug-in Suivi des éléments de travail vous permet de définir 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 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 règle générale, vous spécifiez une tâche pour chaque activité de téléchargement majeure, par exemple, 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 un ordre 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 les dépendances pour les groupes de tâches et les tâches dans les fichiers de plug-in.

Nom et emplacement du plug-in

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

Nom du fichier :

WorkItems.xml

Emplacement du fichier :

Dossier de suivi des éléments de travail

Nom du plug-in :

Microsoft.ProjectCreationWizard.WorkItemTracking

Notes

Vous pouvez modifier 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.

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

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 pour les modèles de processus à partir de la page suivante du site web de Microsoft : Schémas de modèles de processus et d'éléments de travail pour 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, pour télécharger respectivement les définitions des types de liens, des types d'éléments de travail, des requêtes et des catégories. Si vous deviez ajouter des définitions 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 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>

Référence des éléments

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.

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ément 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.

Voir aussi

Concepts

Personnaliser un processus

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

Vue d'ensemble des fichiers de modèle de processus