Partager via

Ajouter, utiliser et gérer des listes globales

  • Article

Vous pouvez répartir des éléments de liste en plusieurs types d'éléments de travail en les incluant dans un ou plusieurs éléments GLOBALLIST.

En définissant des types d'élément de travail, vous pouvez constater que certains champs ont le même ensemble de valeurs. Cet ensemble de valeurs englobe souvent plusieurs types d'éléments de travail, voire plusieurs projets d'équipe. Certaines de ces listes peuvent changer fréquemment, par exemple le numéro de build des builds nocturnes, qui nécessite qu'un administrateur mette à jour ces listes à de nombreux emplacements, de manière fréquente. Les listes globales aident à résoudre ce problème.

Notes

Les listes globales ne doivent pas inclure de groupes à portée de projet car elles n'ont pas la même portée qu'un projet. Les listes globales sont gérées pour une collection de projets.

Les procédures suivantes vous montrent comment créer une liste globale intitulée Disciplines pour le type d'élément de travail Task.

Autorisations requises

Pour exporter une liste globale, vous devez être membre du groupe Team Foundation Valid Users pour la collection de projets. Pour importer une liste globale, vous devez être membre du groupe Team Foundation Administrators ou du groupe Project Administrators pour la collection de projets. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Pour ajouter une liste globale à votre collection de projets d'équipe

  1. Dans Visual Studio, cliquez sur Fichier, Nouveau, puis sur Fichier.

  2. Dans le volet Catégories, cliquez sur Général.

  3. Dans le volet Modèles, cliquez sur Fichier XML, puis sur Ouvrir.

  4. À ce nouveau fichier, ajoutez le code XML suivant, comme indiqué en surbrillance dans l'exemple ci-après. Cet exemple définit une liste globale des disciplines qui s'appliquent à votre organisation.

    <?xml version="1.0" encoding="utf-8"?>
<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/globallists">
    <GLOBALLIST name="Disciplines">
        <LISTITEM value="Architecture" />
        <LISTITEM value="Requirements" />
        <LISTITEM value="Development" />
        <LISTITEM value="Release Management" />
        <LISTITEM value="Project Management" />
        <LISTITEM value="Test" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

  5. Dans la barre d'outils, cliquez sur Enregistrer pour enregistrer les modifications apportées au fichier XML.

    La boîte de dialogue Enregistrer le fichier sous apparaît.

  6. Dans la boîte de dialogue Enregistrer le fichier sous, sous Enregistrer dans recherchez l'emplacement où vous souhaitez enregistrer le fichier. Nommez le fichier puis cliquez sur Enregistrer.

    Notes

    Si vous exécutez Windows Vista, il est possible que vous ne disposiez pas d'autorisations 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 d'autorisations définies, la technologie de virtualisation du Registre redirige automatiquement le fichier exporté et l'enregistre dans le magasin virtuel. Pour éviter cette redirection, vous pouvez exporter le fichier vers un emplacement où vous disposez d'autorisations. Pour plus d'informations sur la virtualisation du Registre, consultez le site Web Microsoft : Virtualisation du Registre (page éventuellement en anglais) et Problèmes de virtualisation de fichiers communs et du Registre dans Windows Vista.

  7. Ouvrez une fenêtre d'invite de commandes Visual Studio 2010.

  8. Importez cette liste globale dans la collection de projets en tapant la commande suivante, puis appuyez sur Entrée :

    witadmin importgloballist /collection:http://NomServeur:Port/NomRépertoireVirtuel/NomCollection /f:"CheminAccèsFichier"

    Pour plus d'informations, consultez Gestion de listes globales de types d'éléments de travail (witadmin).

  9. Affichez les listes globales sur le serveur Team Foundation Server en tapant ce qui suit à l'invite de commandes et en appuyant sur Entrée :

    witadmin exportgloballist /collection:http://NomServeur:Port/NomRépertoireVirtuel/NomCollection

    Notez que la liste récemment ajoutée s'affiche.

Pour utiliser les listes globales dans un type d'élément de travail

  1. Exécutez witadmin exportwitd pour exporter Task.xml. Pour plus d'informations, consultez Personnalisation et gestion des types d'éléments de travail (witadmin).

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

    Notes

    Si vous exécutez Windows Vista, il est possible que vous ne disposiez pas d'autorisations 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 d'autorisations définies, la technologie de virtualisation du Registre redirige automatiquement le fichier exporté et l'enregistre dans le magasin virtuel. Pour éviter cette redirection, vous pouvez exporter le fichier vers un emplacement où vous disposez d'autorisations. Pour plus d'informations sur la virtualisation du Registre, consultez le site Web Microsoft : Virtualisation du Registre (page éventuellement en anglais) et Problèmes de virtualisation de fichiers communs et du Registre dans Windows Vista.

  4. Sélectionnez Task.xml, puis cliquez sur Ouvrir. Lorsque vous êtes invité à modifier les fins de ligne, cliquez sur Non.

  5. Recherchez la section suivante du fichier XML qui définit le champ Discipline :

    <FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String" reportable="dimension">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES expanditems="true">
    <LISTITEM value="Development" />
    <LISTITEM value="Test" />
    <LISTITEM value="Project Management" />
    <LISTITEM value="Requirements" />
    <LISTITEM value="Architecture" />
    <LISTITEM value="Release Management" />
  </ALLOWEDVALUES>
</FIELD>

  6. Supprimez la liste des valeurs autorisées en supprimant le code XML suivant affiché en surbrillance dans l'exemple suivant :

    <FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES expanditems="true">
    <LISTITEM value="Development" />
    <LISTITEM value="Test" />
    <LISTITEM value="Project Management" />
    <LISTITEM value="Requirements" />
    <LISTITEM value="Architecture" />
    <LISTITEM value="Release Management" />
  </ALLOWEDVALUES>
</FIELD>

  7. Affectez les valeurs autorisées du champ Discipline à la liste globale que vous avez définie précédemment en ajoutant le code XML suivant au fichier :

    <FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES>
    <GLOBALLIST name="Disciplines" />
  </ALLOWEDVALUES>
</FIELD>

  8. Dans la barre d'outils, cliquez sur Enregistrer pour enregistrer les modifications apportées au fichier XML.

  9. Importez la tâche modifiée dans Team Foundation Server. Pour plus d'informations, consultez Personnalisation et gestion des types d'éléments de travail (witadmin).

  10. Dans la fenêtre Team Explorer de Visual Studio, 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 que tous les nœuds soient chargés. Les nœuds qui sont encore en cours de chargement sont étiquetés En cours.

  11. Créez une tâche. 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 Tâche.

    Cette tâche est créée à partir du type d'élément de travail que vous avez modifié et importé.

  12. Sélectionnez la zone Discipline sur le nouveau formulaire d'élément de travail.

    Notez que les valeurs autorisées sont maintenant remplies selon la liste Disciplines globale.

  13. Cliquez sur Fermer pour fermer la nouvelle tâche. Cliquez sur Non lorsque vous êtes invité à enregistrer la tâche.

Pour ajouter des valeurs à un champ sans modifier ni importer un fichier XML de type d'élément de travail

  1. Pour ajouter des valeurs au champ Discipline sans modifier ni réimporter le fichier de définition du type d'élément de travail, ouvrez le fichier disciplines.xml à l'aide de Visual Studio et ajoutez les nouvelles valeurs suivantes, comme indiqué en surbrillance dans l'exemple suivant :

    <GLOBALLIST name="Disciplines">
  <LISTITEM value="Architecture" />
  <LISTITEM value="Requirements" />
  <LISTITEM value="Development" />
  <LISTITEM value="Release Management" />
  <LISTITEM value="Project Management" />
  <LISTITEM value="Test" />
  <LISTITEM value="Marketing and Sales" />
  <LISTITEM value="General Management" />
  <LISTITEM value="Other" />
</GLOBALLIST>

  2. Dans la barre d'outils, cliquez sur Enregistrer pour enregistrer les modifications apportées au fichier XML.

  3. Ouvrez une fenêtre d'invite de commandes Visual Studio.

  4. Importez cette liste globale dans la collection de projets en tapant ce qui suit à l'invite de commandes, puis appuyez sur Entrée :

    witadmin importgloballist /collection:http://NomServeur:Port/NomRépertoireVirtuel/NomCollection /f:"CheminAccèsFichier"

  5. 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 que tous les nœuds soient chargés. Les nœuds qui sont encore en cours de chargement sont étiquetés En cours.

  6. Créez une tâche. 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 Tâche.

  7. Sélectionnez la zone Discipline.

    Notez que les nouvelles valeurs dans la liste globale apparaissent désormais comme des choix dans la zone.

    Notes

    Vous pouvez référencer des listes globales pour des valeurs autorisées qui sont partagées entre plusieurs types d'éléments de travail ou projets d'équipe. Cela permet à une seule mise à jour de la liste globale de mettre à jour automatiquement les valeurs autorisées de tous les types d'éléments de travail qui font référence à la liste.

  8. Cliquez sur Fermer pour fermer la nouvelle tâche. Cliquez sur Non lorsque vous êtes invité à enregistrer la tâche.

Voir aussi

Référence

GLOBALLISTS, élément (Schéma des listes globales)

GLOBALLISTS Element (Work Item Type Definition Schema)

Concepts

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

Définition des listes globales

Définition et utilisation de listes, listes de choix et listes globales

Autres ressources

Index des définitions d'éléments XML pour les types d'éléments de travail