Partager via

Comment : utiliser une liste globale

  • Article

Mise à jour : novembre 2007

Vous pouvez répartir des éléments de liste en plusieurs types d'élément 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ément de travail voire même plusieurs projets d'équipe. Certaines de ces listes peuvent changer fréquemment, par exemple le numéro de build des builds nocturnes. Il n'est pas recommandé de demander à un administrateur de mettre ces listes souvent à jour dans plusieurs emplacements. Les listes globales aident à résoudre ce problème. 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 procédures suivantes vous montrent comment créer une liste globale intitulée Disciplines, pour le type d'élément de travail Tâche.

Autorisations requises

Pour exporter une liste globale, vous devez être membre du groupe Team Foundation Valid Users. Pour importer une liste globale, 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.

Pour utiliser les commandes Team Foundation au niveau de l'invite de commandes

  • Cliquez sur Démarrer, Tous les programmes, pointez sur Microsoft Visual Studio 2008, Visual Studio Tools, puis cliquez sur Invite de commandes de Visual Studio 2008.

    Vous pouvez aussi exécuter vsvars32 dans le chemin d'installation de Visual Studio, généralement LettreLecteur:\Program Files\Microsoft Visual Studio 9.0\Common7\Tools.

    Remarque :

    Pour que vous puissiez utiliser l'invite de commandes Visual Studio 2008, Visual Studio 2008 doit être installé.

Pour ajouter une liste globale à Team Foundation Server

  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 suivant. 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 à un fichier XML.

    La boîte de dialogue Enregistrer le fichier sous s'affiche.

    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.

    Remarque :

    Si vous exécutez Windows Vista, vous ne disposez peut-être pas des droits d'accès à certains dossiers. Si vous tentez d'enregistrer la liste globale à un emplacement où vous n'avez pas de droits d'accès, la technologie de virtualisation du Registre redirige automatiquement le fichier 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 enregistrer le fichier à un emplacement où vous avez des droits d'accès.

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

  7. Importez cette liste globale sur le serveur Team Foundation Server en tapant la commande suivante et en appuyant sur ENTRÉE :

    glimport /f "Chemin d'accès au fichier" /t "nom Team Foundation Server"

    Remarque :

    Une liste globale ayant un effet global sur Team Foundation Server, vous ne spécifiez pas de projet d'équipe lorsque vous exécutez la commande glimport. Pour plus d'informations, consultez glimport.

  8. 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 :

    glexport /t "<NomServeurTeamFoundation>"

    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 witexport pour exporter Task.xml. Pour plus d'informations, consultez Comment : exporter un type d'élément 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, 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.

  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 à un fichier XML.

  9. Importez la tâche modifiée dans Team Foundation Server. Pour plus d'informations, consultez Comment : importer un type d'élément de travail dans un projet existant.

  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 encore en cours de chargement sont étiquetés par le mot 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 à un fichier XML.

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

  4. Importez cette liste globale sur le serveur Team Foundation Server en tapant ce qui suit à l'invite de commandes et en appuyant sur ENTRÉE.

    glimport /f "Chemin d'accès au fichier" /t "nom Team Foundation Server"

  5. 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 encore en cours de chargement sont étiquetés par le mot 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.

    Remarque :

    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

Concepts

Listes globales

Référence

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

GLOBALLISTS, élément (Schéma de définition du type d'élément de travail)

Autres ressources

Schéma de définition du type d'élément de travail