Partager via

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

  • Article

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

Notes

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 : Outils puissants dédiés à Team Foundation Server - Avril 2010 (page éventuellement en anglais)

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.

Notes

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, cliquez sur Démarrer, cliquez avec le bouton droit sur Invite de commandes, puis cliquez sur 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 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.

RemarqueRemarque
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

Date

Historique

Motif

Janvier 2011

Description des avantages liés à l'utilisation de listes globales et ajout d'informations sur le flux de travail global.

Améliorations apportées aux informations.