Gestion de listes globales de types d'éléments de travail (witadmin)

À l'aide de listes globales, vous pouvez réduire le travail nécessaire à la mise à jour d'une liste utilisée par plusieurs types d'éléments de travail. 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. Vous pouvez définir des listes globales pour un projet d'équipe, une collection de projets d'équipe, un modèle de processus ou un flux de travail global.

Vous pouvez définir une liste globale dans son propre fichier de définition, dans un type d'élément de travail ou dans le flux de travail global. Lorsque vous utilisez la définition de liste globale, vous pouvez gérer les listes globales définies pour une collection en utilisant 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.

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

Pour plus d'informations, consultez Définition des listes globales et Personnalisation du workflow global.

L'utilitaire en ligne de commande witadmin se trouve dans Lecteur:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE sur l'ordinateur client qui exécute Team Explorer. Sur les ordinateurs 64 bits, l'outil se trouve dans Lecteur:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE.

Pour plus d'informations sur les listes globales, consultez Définition des listes globales.

Autorisations requises

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 de champs, vous devez être membre du groupe Readers ou disposer de l'autorisation Afficher les éléments de travail dans ce nœud 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.

Pour plus d'informations, consultez Autorisations de Team Foundation Server et Groupes, autorisations et rôles par défaut de Team Foundation Server.

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 du projet 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.

Exemples

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

• URI pour la collection de projets d'équipe : http://AdventureWorksServer:8080/AWTeam/Collection1

• 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/AWTeam/Collection1 

Importer la définition des listes globales

L'exemple suivant exporte les listes globales :

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /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/AWTeam/Collection1 /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/AWTeam/Collection1 /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/AWTeam/Collection1 /f:C:mygloballists.xml /e utf-7

Voir aussi

Tâches

Ajouter, utiliser et gérer des listes globales

Concepts

Définition des listes globales

Autres ressources

Personnalisation du workflow global

witAdmin : administration des objets de suivi des éléments de travail

Historique des modifications