Comment : modifier la disposition du formulaire d'élément de travail

Article
08/22/2008

Mise à jour : novembre 2007

Vous pouvez modifier la disposition du formulaire d'élément de travail en exportant le fichier XML et en modifiant son contenu. Une fois que vous avez modifié la disposition du formulaire, vous pouvez importer le fichier XML pour commencer à utiliser le type d'élément de travail mis à jour.

Autorisations requises

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

Pour modifier la disposition du formulaire

Si vous modifiez un type d'élément de travail sur un projet unique, exécutez witexport pour exporter le fichier XML du type d'élément de travail que vous souhaitez modifier. Pour plus d'informations, consultez Comment : exporter un type d'élément de travail à partir d'un projet existant.
Dans Visual Studio, cliquez sur Fichier, Ouvrir, puis sur Fichier.

La boîte de dialogue Ouvrir un fichier s'affiche.

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, accédez à l'emplacement où vous avez téléchargé le modèle de processus.

Remarque :
Si vous exécutez Windows Vista, vous ne disposez peut-être pas des droits d'accès à certains dossiers. Si vous tentez d'exporter le type d'élément de travail vers un emplacement où vous n'avez pas de droits d'accès, la technologie de virtualisation du Registre redirige automatiquement le fichier exporté et l'enregistre dans le magasin virtuel. Pour plus d'informations, consultez https://go.microsoft.com/fwlink/?LinkId=92325 et https://go.microsoft.com/fwlink/?LinkId=92323. Pour éviter cette redirection, vous pouvez exporter le fichier vers un emplacement où vous avez des droits d'accès.

Si vous exécutez Windows Vista, vous ne disposez peut-être pas des droits d'accès à certains dossiers. Si vous tentez d'exporter le type d'élément de travail vers un emplacement où vous n'avez pas de droits d'accès, la technologie de virtualisation du Registre redirige automatiquement le fichier exporté et l'enregistre dans le magasin virtuel. Pour plus d'informations, consultez https://go.microsoft.com/fwlink/?LinkId=92325 et https://go.microsoft.com/fwlink/?LinkId=92323. Pour éviter cette redirection, vous pouvez exporter le fichier vers un emplacement où vous avez des droits d'accès.

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.
Recherchez la section <TabGroup> du fichier XML. Notez que les éléments tels que les liens et les pièces jointes sont associés à deux éléments <Tab> qui contiennent chacun un élément <Control> qui restitue le contrôle respectif.
```
<Tab Label="Links">
  <Control Type="LinksControl" />
</Tab>
<Tab Label="File Attachments">
  <Control Type="AttachmentsControl" />
</Tab>
```
Fusionnez les deux éléments <Tab> en un seul élément <Tab> associé à Liens et pièces jointes qui contient les deux contrôles, en remplaçant le code XML affiché à l'étape précédente par le nouveau code XML indiqué dans l'exemple suivant.
```
<Tab Label="Links and Attachments">
  <Control Type="LinksControl" Label="Links" LabelPosition="Top" />
  <Control Type="AttachmentsControl" Label="Attachments" LabelPosition="Top" />
</Tab>
```

Recherchez la section de la définition <Layout> de <FORM> qui décrit le groupe que vous souhaitez modifier, par exemple le groupe Classification.

<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>

Remarque :
Pour de meilleurs résultats, chaque contrôle ou groupe doit s'afficher dans une colonne, même si celle-ci s'étend sur la largeur totale du formulaire. Ensuite, chaque colonne doit s'afficher dans un groupe, même si celui-ci n'a aucune étiquette ou limite visible.

Sélectionnez les lignes suivantes affichées en surbrillance dans l'exemple suivant, puis cliquez sur Copier dans le menu Edition pour copier ce contenu dans le Presse-papiers pour une utilisation ultérieure.

  <Column PercentWidth="70">
    <Group>
      <Column PercentWidth="100">
        <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>
      </Column>
    </Group>
  </Column>

Supprimez les lignes affichées en gras dans le code XML suivant pour supprimer le groupe Classification de sa position actuelle dans le formulaire.

<Layout>
  <Group>
    <Column PercentWidth="70">
      <Control Type="FieldControl" FieldName="System.Title" Label="&amp;Title:" LabelPosition="Left" />
    </Column>
    <Column PercentWidth="30">
      <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Discipline" Label="&amp;Discipline:" LabelPosition="Left" />
    </Column>
  </Group>
  <Group Label="Classification">    <Column PercentWidth="100">      <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="&amp;Area:" LabelPosition="Left" />      <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="&amp;Iteration:" LabelPosition="Left" />    </Column>  </Group>

Dans la section <TabGroup>, recherchez les lignes suivantes qui définissent l'onglet Détails :

<Tab Label="Details">
  <Group>
    <Column PercentWidth="50">
      <Group Label="General">
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&amp;ue:" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.ExitCriteria" Label="E&amp;xit criteria:" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Build.IntegrationBuild" Label="Integration &amp;build:" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.TaskHierarchy" Label="Task C&amp;ontext:" LabelPosition="Left" ReadOnly="True" />
        </Column>
      </Group>
    </Column>
    <Column PercentWidth="50">
      <Group Label="Schedule">
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.RemainingWork" Label="Remaining &amp;work (hours):" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Label="Com&amp;pleted work (hours):" LabelPosition="Left" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.StartDate" Label="Start Dat&amp;e:" LabelPosition="Left" ReadOnly="True" />
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.FinishDate" Label="&amp;Finish Date:" LabelPosition="Left" ReadOnly="True" />
        </Column>
      </Group>
    </Column>
  </Group>
</Tab>

Collez le contenu du Presse-papiers dans l'emplacement suivant pour déplacer ces contrôles dans l'onglet Détails.

<Tab Label="Details">
  <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />  <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
  <Group>
    <Column PercentWidth="50">
      <Group Label="General">
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&amp;ue:" LabelPosition="Left" />
...

Apportez les modifications suivantes, affichées en gras, pour créer un regroupement autour des champs déplacés et pour diviser les champs en deux colonnes.

<Tab Label="Details">
  <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.Category" Label="Category" LabelPosition="Left" />
        </Column>      </Group>    </Column>  </Group>
  <Group>
    <Column PercentWidth="50">
      <Group Label="General">
        <Column PercentWidth="100">
          <Control Type="FieldControl" FieldName="Microsoft.VSTS.Common.Issue" Label="Iss&amp;ue:" LabelPosition="Left" />
...

Dans la barre d'outils, cliquez sur Enregistrer pour enregistrer les modifications apportées au fichier XML.
Pour importer le nouveau type d'élément de travail dans un projet unique, consultez Comment : importer un type d'élément de travail dans un projet existant. Pour ajouter le type d'élément de travail à votre modèle de processus, consultez Types d'éléments de travail.

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

Dans Team Explorer, cliquez sur Actualiser pour télécharger les mises à jour les plus récentes à partir du serveur.

Ces mises à jour comprennent les modifications que vous venez d'importer. Attendez quelques secondes jusqu'à ce que le nœud Éléments de travail soit chargé. 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é. Pour ce faire, cliquez avec le bouton droit sur le nœud Éléments de travail, pointez sur Ajouter un élément de travail, puis cliquez sur le type d'élément de travail.

Cet élément de travail est créé à partir du type d'élément de travail que vous avez modifié.

Remarquez que le groupe Classification ne se trouve plus dans le formulaire principal. Cliquez sur les onglets Liens et pièces jointes et Détails pour consulter les résultats des modifications que vous avez apportées.
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

Tâches

Comment : personnaliser une étiquette de champ

Concepts

Éléments <Layout>, <Group> et <Column> du formulaire d'élément de travail

Contrôles de formulaire d'élément de travail

Tous les éléments <FORM> des éléments de travail

Exemple de formulaire d'élément de travail

Partager via