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 incluent les types d'éléments de travail, des requêtes d'élément de travail, des catégories, des types de liens, et d'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

[!REMARQUE]

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 instances d'élément de travail de définitions, vous devez spécifier une tâche supplémentaire pour chaque.

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.

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 Assigning Permissions for Work Item Queries.

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

Concepts

Personnaliser des modèles de processus

Processus étape par étape de personnalisation

Personnaliser les données de suivi de projet, les formulaires, les flux de travail et d'autres objets

Utilisation de fichiers de modèles de processus

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