Partager via

Personnalisation des catégories pour les types d'éléments de travail (witadmin)

  • Article

Vous pouvez gérer les catégories pour les types d'éléments de travail définis pour un projet d'équipe à l'aide des commandes witadmin suivantes :

  • exportcategories : exporte la définition XML des catégories définies sur un serveur qui exécute Team Foundation Server.

  • importcategories : importe un fichier de définition XML de type d'élément de travail dans un projet d'équipe situé sur un serveur qui exécute Team Foundation Server. 

    Si une catégorie de même nom existe déjà, cette commande remplace la définition existante. Si le type d'élément de travail n'existe pas, cette commande crée une nouvelle catégorie.

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.

Notes

Vous pouvez créer et modifier des catégories à l'aide de l'éditeur de processus, un outil puissant pour Visual Studio. Cet outil puissant 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 le projet d'équipe dans lequel les types d'éléments de travail sont définis, vous devez disposer des autorisations suivantes :

  • Pour exporter des catégories de types d'éléments de travail, vous devez être membre du groupe Readers ou disposer de l'autorisation Afficher les éléments de travail avec la valeur Autoriser

  • Pour importer des catégories de types d'éléments de travail, 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 le site Web Microsoft : Contrôle de compte d'utilisateur.

witadmin exportcategories /collection:CollectionURL /p:Project [/f:FileName] [/e:Encoding] 

witadmin importcategories /collection:CollectionURL /p:Project /f:FileName [/e:Encoding]

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.

/p:Project

Nom du projet d'équipe à partir duquel les catégories sont exportées ou vers lequel les catégories sont importées.

/f :nom de fichier

Le chemin d'accès et le nom de fichier du fichier de définition XML qui contient les catégories à exporter ou importer. Si vous omettez ce paramètre lorsque vous utilisez la commande exportcategories, la commande affiche les catégories dans la fenêtre d'invite de commandes.

/e:Encodage

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.

/? ou help

Affiche de l'aide sur la commande dans la fenêtre d'invite de commandes.

Notes

L'importation d'un fichier de catégories s'accompagne de la création des catégories si celles-ci n'existent pas. Si les catégories existent déjà, la commande witadmin importcategories vous prévient que la liste actuelle sera remplacée. Vous pouvez écrire votre propre programme pour mettre à jour un jeu de catégories existant ou mettre à jour les catégories vous-même avec de nouvelles données.

Pour plus d'informations sur la structure du fichier XML de catégories, consultez Référence de schéma de définition de catégories.

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

  • Nom du projet : AdventureWorks

  • Nom du fichier d'entrée ou de sortie : myCategories.xml

  • Encodage par défaut : UTF-8

Afficher les catégories de types d'éléments de travail

La commande suivante répertorie les catégories de type d'élément de travail définies pour le projet AdventureWorks.

witadmin exportcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks

Exporter les catégories de types d'éléments de travail

La commande suivante exporte les catégories de type d'élément de travail définies pour le projet AdventureWorks vers le fichier XML myCategories.

witadmin exportcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myCategories.xml

Importer les catégories de types d'éléments de travail

L'exemple suivant importe des catégories du fichier XML myCategories vers le projet AdventureWorks.

witadmin importcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myCategories.xml

Voir aussi

Autres ressources

Regroupement de types d'éléments de travail en catégories

Utilisation des catégories de types d'éléments de travail

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