Partager via

Importer et exporter des catégories [witadmin]

  • Article

Vous pouvez importer et exporter des catégories définies 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 en savoir plus sur les catégories par défaut et sur leur utilisation, cliquez ici.

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(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

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

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, sur le site web de Microsoft, consultez la page Team Foundation Server Power Tools.

Spécifications

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.

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 de l'URI est le suivant : http://NomServeur:Port/NomRépertoireVirtuel/NomCollection

Si aucun répertoire virtuel n'est utilisé, le format de l'URI est le suivant :

http://NomServeur:Port/NomCollection.

/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:NomDeFichier

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 Configurer et personnaliser les outils de planification Agile pour un projet d'équipe.

Pour plus d'informations sur la structure du fichier XML de catégories, consultez Référence des éléments XML 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

Énumérer les catégories

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

Ajouter une catégorie aux catégories Types masqués

Vous ajoutez une catégorie aux catégories Types masqués pour supprimer la prise en charge permettant aux utilisateurs de créer des types d'éléments de travail dans cette catégorie.

  1. Exportez le fichier de définition des catégories pour votre projet d'équipe.

    witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml

  2. Ouvrez le fichier Catégories dans l'éditeur de texte de votre choix, puis recherchez l'élément CATEGORY pour "Hidden Types Category".

    <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
   <DEFAULTWORKITEMTYPE name="Code Review Request" />
   <WORKITEMTYPE name="Code Review Response" />
   <WORKITEMTYPE name="Feedback Request" />
   <WORKITEMTYPE name="Feedback Response" />
   <WORKITEMTYPE name="Shared Steps" />
</CATEGORY>

  3. Ajoutez un élément WORKITEMTYPE qui spécifie le nom convivial du type d'élément de travail que vous souhaitez ajouter.

    Par exemple, la syntaxe suivante ajoute le type d'élément de travail personnalisé « Integration Build » à la catégorie des types masqués.

    <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
   <DEFAULTWORKITEMTYPE name="Code Review Request" />
   <WORKITEMTYPE name="Code Review Response" />
   <WORKITEMTYPE name="Feedback Request" />
   <WORKITEMTYPE name="Feedback Response" />
   <WORKITEMTYPE name="Shared Steps" />
   <WORKITEMTYPE name="Integration Build" />
</CATEGORY>

  4. Importez le fichier de définition des catégories dans votre projet d'équipe.

    witadmin importcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml

Voir aussi

Concepts

Configurer et personnaliser les outils de planification Agile pour un projet d'équipe

Autres ressources

Utiliser les catégories pour regrouper les types d'éléments de travail