Gérer des listes globales de types d'éléments de travail

Article
03/05/2013

Les listes globales sont des listes de sélection que vous pouvez inclure dans un ou plusieurs champs et types d'éléments de travail.Utilisez-les pour réduire le travail nécessaire à la mise à jour d'une liste partagée par plusieurs types d'éléments de travail.Étant donné que les listes globales sont définies pour une collection de projets d'équipe, elles peuvent être incluses dans les types d'éléments de travail pour tous les projets d'équipe de la collection.

[!REMARQUE]

Les listes globales ne doivent pas inclure de groupes de sécurité à portée de projet car elles n'ont pas la même portée qu'un projet d'équipe.

Vous pouvez définir une liste globale dans son propre fichier de définition, dans le fichier de définition pour un type d'élément de travail ou dans le flux de travail global.La définition de liste global gère les listes globales définies pour une collection.La définition de liste globale utilise les commandes suivantes dans l'outil en ligne de commande witadmin :

destroygloballist : détruit une liste globale.
exportgloballist : exporte les listes globales vers un fichier XML ou vers la fenêtre d'invite de commandes.Elle exporte un seul fichier, qui contient toutes les listes globales définies pour la collection de projets d'équipe.
importgloballist : importe les listes globales d'un fichier XML.Si vous essayez d'importer une liste globale qui existe déjà sur le serveur, un message d'avertissement vous demande si vous souhaitez remplacer celle présente sur le serveur.Si vous essayez d'importer une liste globale qui n'existe pas, la commande crée une nouvelle liste globale.
listgloballist : affiche le nom de chaque liste globale définie sur le serveur.

Consultez Définir des listes globales et Personnaliser le flux de travail global.

Pour exécuter l'outil de ligne de commande witadmin, ouvrez une fenêtre d'invite de commandes à l'endroit où Visual Studio ou Team Explorer est installé et entrez :

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

Sur une édition 64 bits de Windows, remplacez %programfiles% par %programfiles(x86)%.

[!REMARQUE]

Vous pouvez créer et modifier des listes globales à l'aide de l'éditeur de processus, un outil puissant pour Visual Studio.Cet outil n'est pas pris en charge.Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : Team Foundation Server Power Tools.

Configuration requise

Pour la collection de projets d'équipe dans laquelle les listes globales sont définies, vous devez disposer des autorisations suivantes :

Pour exporter ou répertorier des listes globales, vous devez être membre du groupe Project Collection Valid Users ou disposer de l'autorisation Afficher les informations au niveau de la collection avec la valeur Autoriser.
Pour détruire ou importer des listes globales, vous devez être membre du groupe de sécurité Team Foundation Administrators ou du groupe de sécurité Administrateurs de projet.

Consultez Autorisations de Team Foundation Server et Groupes, autorisations et rôles par défaut de Team Foundation Server.

[!REMARQUE]

Même si vous vous connectez avec des autorisations d'administration, vous devez ouvrir une fenêtre d'invite de commandes avec élévation de privilèges pour exécuter cette fonction sur un serveur Windows Server 2008.Pour ouvrir une fenêtre d'invite de commandes avec élévation de privilèges, sélectionnez Démarrer, ouvrez la fenêtre du menu contextuel Invite de commandes, puis sélectionnez Exécuter en tant qu'administrateur.Pour plus d'informations, consultez la page du site Web Microsoft : Contrôle de compte d'utilisateur.

witadmin destroygloballist /collection:CollectionURL /n:GlobalListName [/noprompt] [/force]

witadmin exportgloballist /collection:CollectionURL [/f:FileName] [/e:Encoding] 

witadmin importgloballist /collection:CollectionURL /f:FileName [/e:Encoding]

witadmin listgloballist /collection:CollectionURL

Paramètres

Paramètre	Description
/collection:CollectionURL	Spécifie l'URI de la collection de projets d'équipe.Le format pour l'URI est le suivant :http://ServerName:Port/VirtualDirectoryName/CollectionName Si aucun répertoire virtuel n'est utilisé, le format de l'URI est le suivant : http://ServerName:Port/CollectionName.
/n:GlobalListName	Nom de la liste globale à supprimer.
/f:FileName	Le chemin d'accès et le nom du fichier de définition XML de liste globale à exporter ou importer. Remarque Si l'ordinateur client exécute Windows Vista, vous pouvez ne pas avoir d'autorisations sur certains dossiers.Si vous tentez d'exporter la liste globale vers un emplacement pour lequel vous ne disposez d'aucune autorisation, la technologie de virtualisation du Registre redirige automatiquement le fichier exporté et l'enregistre dans le magasin virtuel.Pour plus d'informations, consultez les pages suivantes sur le site Web Microsoft : Virtualisation du Registre (éventuellement en anglais) et Problèmes de virtualisation de fichiers communs et du Registre dans Windows Vista.Pour éviter cette redirection, vous pouvez exporter le fichier vers un emplacement où vous disposez d'autorisations.
/e:Encoding	Nom d'un .NET Framework 2.0 qui encode le format.L'encodage spécifié sera utilisé pour exporter ou importer les données XML.Par exemple, /e utf-7 spécifie l'encodage (UTF-7) Unicode.Si vous omettez ce paramètre, witadmin essaie de détecter l'encodage, et si la détection échoue, witadmin utilise UTF-8.
/noprompt	Désactive l'invite pour la confirmation.
/? or help	Affiche de l'aide sur la commande dans la fenêtre d'invite de commandes.

Notes

L'importation d'une liste globale s'accompagne de la création d'une liste s'il n'en existe aucune.Si la liste existe déjà, la commande witadmin importgloballist vous prévient que la liste actuelle sera remplacée.Vous pouvez écrire votre propre programme pour mettre à jour une liste globale existante ou mettre à jour la liste globale vous-même avec les nouvelles données.

Pour créer une nouvelle liste globale, commencez par le code suivant et modifiez-le selon vos besoins.Cet exemple définit une liste globale des disciplines que vous pouvez affecter à des tâches.

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

Pour ajouter une liste globale à un champ, exportez la définition du type d'élément de travail qui contient le champ et ajoutez-le à la définition de champ, comme indiqué dans l'exemple suivant :

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

Pour afficher les modifications, importez la définition de type et actualisez votre navigateur ou cache client.Vous devrez peut-être fermer tous les éléments de travail qui référencent le champ et les rouvrir.

Pour plus d'informations sur l'exportation et l'importation des définitions de type, consultez Personnaliser et gérer des types d'éléments de travail (witadmin).

Exemples

Sauf spécification contraire, les valeurs suivantes s'appliquent dans chaque exemple :

URI pour la collection de projets d'équipe : http://AdventureWorksServer:8080/tfs/DefaultCollection
Numéro de port du site Web du serveur : 8080

Afficher les noms des listes globales

L'exemple suivant affiche les listes globales définies sur le serveur.Cet exemple exporte les listes globales à l'aide de l'encodage UTF-8 par défaut :

witadmin listgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Exporter la définition des listes globales

L'exemple suivant exporte les listes globales :

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

L'exemple suivant exporte les mêmes listes globales vers le même serveur, mais utilise l'encodage Unicode (UTF-7) :

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e:utf-7

Importer la définition des listes globales

L'exemple suivant importe des listes globales :

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

L'exemple suivant importe les mêmes listes globales vers le même serveur, mais utilise l'encodage Unicode (UTF-7) :

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e utf-7

Voir aussi

Concepts

Définir des listes globales

Autres ressources

Personnaliser le flux de travail global

witAdmin : personnaliser et gérer des objets pour le suivi des éléments de travail

Partager via