Ajouter ou supprimer un champ dans un type d'élément de travail

Article
08/10/2011

Pour ajouter ou supprimer un champ de données dans un type d'élément de travail, modifiez le fichier de définition du type d'élément de travail. Vous devez ajouter ou supprimer des éléments FIELD dans la section FIELDS, ainsi que la disposition et les contrôles définis dans la section FORM. Après avoir modifié le type d'élément de travail, vous pouvez importer le fichier XML et commencer à utiliser le type d'élément de travail mis à jour.

Important

Les champs des types d'éléments de travail sont gérés pour une collection de projets d'équipe. Pour plus d'informations, consultez Gestion des champs d'éléments de travail (witadmin).

Dans cette rubrique

Exporter et ouvrir le fichier de définition du type d'élément de travail
Ajouter un champ
Supprimer un champ
Importer le fichier de définition du type d'élément de travail
Vérifier que vos modifications apparaissent dans le formulaire d'élément de travail

Autorisations requises

Pour effectuer cette procédure, vous devez être membre du groupe Team Foundation Administrators ou du groupe Project Administrators pour le projet. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Exporter et ouvrir le fichier de définition du type d'élément de travail

Pour exporter et ouvrir le fichier de définition du type d'élément de travail

Exécutez l'une des procédures suivantes en fonction de la portée de la personnalisation que vous souhaitez effectuer :

Si vous modifiez un type d'élément de travail pour un seul projet :
1. Exécutez witadmin exportwitd pour exporter le fichier XML du type d'élément de travail que vous souhaitez modifier. Tapez la commande suivante, en substituant les arguments indiqués par vos données :
```
witadmin exportwitd /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /p:project /n:typename /f:filename
```
  Pour plus d'informations, consultez Exporter et importer des types d'éléments de travail à partir d'un projet existant.
2. Dans Visual Studio, cliquez sur Fichier, Ouvrir, puis sur Fichier.
  
  La boîte de dialogue Ouvrir un fichier s'affiche.
3. Sous Regarder dans, accédez à l'emplacement où vous avez exporté le fichier.
Si vous modifiez un type d'élément de travail pour personnaliser un modèle de processus :
1. Recherchez l'emplacement où vous avez téléchargé le modèle de processus.
2. Sélectionnez le fichier XML du type d'élément de travail que vous souhaitez mettre à jour, puis cliquez sur Ouvrir. Lorsque vous êtes invité à modifier les fins de ligne, cliquez sur Non.

Ajouter un champ

Pour ajouter un champ à un type d'élément de travail

Recherchez la section suivante du fichier XML :
```
<FIELDS>
```
Créez un champ String en tapant le code XML suivant, mis en surbrillance dans l'exemple ci-après :
```
<FIELDS>
<FIELD name="Issue Level" refname="MyCompany.MyProcess.IssueLevel" type="String" reportable="Dimension">
</FIELD>
```
Notes

Le nom de la référence, ou refname, est le nom de programmation du champ. Toutes les autres règles doivent faire référence à ce refname. Pour plus d'informations, consultez Conventions d'affectation de noms pour les objets de suivi des éléments de travail.
Recherchez la section du fichier XML qui décrit le formulaire d'élément de travail :
```
<FORM>
```

Recherchez les lignes suivantes dans la section <FORM> :

<Group Label="Classification">
  <Column PercentWidth="100">
    <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
    <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
  </Column>
</Group>

Insérez un contrôle pour afficher votre champ en tapant le code XML suivant, mis en surbrillance dans l'exemple ci-après :

<Group Label="Classification">
  <Column PercentWidth="100">
    <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
    <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
    <Control Type="FieldControl" FieldName="MyCompany.MyProcess.IssueLevel" Label="Issue Level" LabelPosition="Left" />
  </Column>
</Group>

Dans le menu Fichier, cliquez sur Enregistrer <nom de fichier>.xml pour enregistrer vos modifications apportées au fichier XML.
Pour importer le nouveau type d'élément de travail dans un projet unique, consultez Importer le fichier de définition du type d'élément de travail. Pour ajouter le type d'élément de travail à votre modèle de processus, consultez Ajouter des définitions de type pour des éléments de travail à un modèle de processus.

Supprimer un champ

Pour supprimer un champ d'un formulaire d'élément de travail

Recherchez et supprimez la définition du champ que vous souhaitez supprimer du type d'élément de travail. L'exemple suivant affiche un champ nommé "Issue Level". Pour supprimer ce champ, vous devez supprimer la section field suivante :

Notes

La section field de votre fichier XML peut ne pas contenir tous les éléments indiqués dans le code suivant. Toutefois, si vous avez personnalisé le champ de type d'élément de travail pour inclure ces éléments, ils doivent également être supprimés.

<FIELDS>
. . .
<FIELD name="Issue Level" refname="MyCompany.MyProcess.IssueLevel" type="String" reportable="dimension">
<HELPTEXT>Describes the issue level to which this special task belongs.</HELPTEXT>
  <WHEN field="Microsoft.VSTS.Common.Discipline" value="Business Analyst">
    <ALLOWEDVALUES>
      <LISTITEM value="Planning" />
      <LISTITEM value="Review" />
    </ALLOWEDVALUES>
  </WHEN>
  <WHENNOT field="Microsoft.VSTS.Common.Discipline" value="Business Analyst">
    <ALLOWEDVALUES>
      <LISTITEM value="Process Management" />
      <LISTITEM value="Planning" />
      <LISTITEM value="Execution" />
      <LISTITEM value="Review" />
    </ALLOWEDVALUES>
  </WHENNOT>
</FIELD>
…
</FIELDS>

Recherchez la section <Layout> où est défini le contrôle du champ d'élément de travail, puis supprimez les sections appropriées afin de supprimer le champ. Les sections suivantes en surbrillance sont des exemples de ce que vous devez chercher.

<Group Label="Classification">
  <Column PercentWidth="50">
    <Group>
      <Column PercentWidth="100">
        <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
        <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
      </Column>
    </Group>
  </Column>
  <Column PercentWidth="50">
    <Group>
      <Column PercentWidth="100">
        <Control Type="FieldControl" FieldName="MyCompany.MyProcess.IssueLevel" Label="IssueLevel" LabelPosition="Left" />
      </Column>
    </Group>
  </Column>
</Group>

Dans le menu Fichier, cliquez sur Enregistrer <nom du fichier> pour enregistrer les modifications dans le fichier XML.

Importer le fichier de définition du type d'élément de travail

Pour importer le fichier de définition du type d'élément de travail

Exécutez witadmin importwitd pour importer le fichier XML du type d'élément de travail que vous avez modifié. Tapez la commande suivante, en substituant les arguments indiqués par vos données :
```
witadmin importwitd /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /p:project /n:typename /f:filename
```
Pour plus d'informations, consultez Exporter et importer des types d'éléments de travail à partir d'un projet existant.

Vérifier que vos modifications apparaissent dans le formulaire d'élément de travail

Pour vérifier les modifications importées dans un projet unique

Dans Team Explorer, cliquez avec le bouton droit sur le nœud du projet d'équipe qui contient la définition du type d'élément de travail que vous avez modifiée, puis cliquez sur Actualiser.

Les mises à jour les plus récentes sont téléchargées à partir du serveur, notamment les modifications que vous venez d'importer. Attendez quelques secondes jusqu'à ce que le nœud Éléments de travail soit actualisé. Les nœuds encore en cours de chargement affichent le mot en cours.
Créez un élément de travail à l'aide du type d'élément de travail que vous avez modifié en cliquant avec le bouton droit sur le nœud Éléments de travail, en pointant sur Ajouter un élément de travail, puis en cliquant sur le type d'élément de travail.

L'élément de travail est créé à partir du type d'élément de travail que vous avez modifié.
Vérifiez que les modifications apportées apparaissent dans le formulaire d'élément de travail.
Cliquez sur Fermer pour fermer le nouvel élément de travail. Cliquez sur Non lorsque vous êtes invité à enregistrer l'élément de travail.

Voir aussi

Partager via