Personnaliser les catégories pour les types d'éléments de travail
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.
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 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 : Team Foundation Server Power Tools.
Configuration requise
Pour le projet d'équipe pour lequel les catégories sont définies, vous devez disposer des autorisations suivantes :
Pour exporter des catégories de types d'éléments de travail, votre autorisation Afficher les informations au niveau du projet doit avoir la valeur Autoriser.
Pour importer des catégories de types d'éléments de travail, vous devez être membre du groupe de sécurité Project Administrators ou votre autorisation Modifier les informations au niveau du projet doit avoir la valeur Autoriser.
Pour plus d'informations, 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 le menu contextuel Invite de commandes, puis sélectionnez 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 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. |
/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.
Important
Les modifications apportées aux catégories peuvent influer sur la configuration du processus.Consultez Personnaliser le journal des travaux en souffrance et le tableau des tâches à l'aide de la configuration du processus.
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/tfs/DefaultCollection
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/tfs/DefaultCollection /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/tfs/DefaultCollection /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/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml
Voir aussi
Concepts
Autres ressources
Définir des catégories pour regrouper des types d'éléments de travail
Référence d'élément des catégories de types d'éléments de travail
witAdmin : personnaliser et gérer des objets pour le suivi des éléments de travail