Personnaliser et gérer des types d'éléments de travail (witadmin)

Article
03/05/2013

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

destroywitd : détruit un type d'élément de travail et chaque élément de travail de ce type de façon définitive et sans récupération possible.
exportwitd : exporte la définition d'un type d'élément de travail vers un fichier XML ou vers la fenêtre d'invite de commandes.
importwitd : importe les types d'éléments de travail d'un fichier de définition XML dans un projet d'équipe situé sur un serveur qui exécute Team Foundation Server.Si un type d'élément de travail de même nom existe déjà, la nouvelle définition de type d'élément de travail remplace la définition existante.Si le type d'élément de travail n'existe pas, cette commande crée un nouveau type d'élément de travail.Pour valider le XML qui définit un type d'éléments de travail (mais sans importer le fichier), utilisez l'option /v.
listwitd : affiche les noms des types d'éléments de travail du projet spécifié dans la fenêtre d'invite de commandes.
renamewitd : modifie le nom complet d'un type d'élément de travail dans un projet spécifique.Une fois que vous avez exécuté cette commande, les éléments de travail de ce type affichent le nouveau nom.

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)%.

Pour plus d'informations sur les types d'éléments de travail, consultez Ajouter des définitions de type pour des éléments de travail à un modèle de processus.

[!REMARQUE]

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

Pour exporter ou répertorier des types d'éléments de travail, vous devez être membre du groupe Project Administrators ou disposer de l'autorisation Afficher les informations au niveau du projet avec la valeur Autoriser
Pour détruire, importer ou renommer des 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.

[!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 destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]

witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportglobalists]

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

witadmin listwitd /collection:CollectionURL /p:Project

witadmin renamewitd /collection:CollectionURL /p:Project /n:TypeName /new:NewName [/noprompt]

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://NomServeur:Port/NomCollection
/p:Projet	Projet d'équipe pour lequel les types d'éléments de travail seront gérés.Ce projet d'équipe doit être défini dans la collection de projets spécifiée par le paramètre /collection. Le paramètre /p est obligatoire à moins que vous n'exécutiez la commande importwitd avec l'option /v.
/n:TypeName	Nom du type d'élément de travail à détruire, exporter, importer ou renommer.
/f:FileName	Le chemin d'accès et le nom de fichier du fichier de définition XML qui contient les types d'éléments de travail à exporter ou importer.Si vous omettez ce paramètre lorsque vous utilisez la commande exportwitd, le code XML s'affiche dans la fenêtre d'invite de commandes. Remarque Si vous utilisez Windows Vista, il est possible que nous ne disposiez pas d'autorisations sur certains dossiers.Si vous tentez d'exporter le type d'élément de travail vers un emplacement pour lequel aucune autorisation ne vous est attribuée, la technologie de virtualisation du Registre redirige automatiquement le fichier exporté et l'enregistre dans le magasin virtuel.Pour éviter cette redirection, vous pouvez exporter le fichier vers un emplacement où vous disposez d'autorisations. Pour plus d'informations sur la virtualisation de registre, consultez le site Web Microsoft : Virtualisation des registres et Problèmes de virtualisation de fichiers système et du Registre dans Windows Vista.
/e:Encodage	Nom d'un .NET Framework 2.0 qui encode le format.La commande utilise l'encodage spécifié 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 tente de détecter l'encodage, et si la détection échoue, witadmin utilise UTF-8.
/exportgloballists	Exporte les définitions des listes globales référencées par le type d'élément de travail.Les définitions pour les listes globales seront incorporées dans le fichier XML de définition de type d'élément de travail.Lorsqu'elles ne sont pas spécifiées, les définitions pour les listes globales sont omises.
/v	Valide le XML qui définit le type d'élément de travail mais n'importe pas le fichier de définition XML. Remarque Vous pouvez valider la définition de type sans spécifier de projet d'équipe.Les références aux groupes dont la portée se limite au projet sont ignorées.
/new:NewName	Nouveau nom du type d'élément de travail.
/noprompt	Désactive l'invite pour la confirmation.
/? ou help	Affiche de l'aide sur la commande dans la fenêtre d'invite de commandes.

Notes

Lorsque vous utilisez la commande destroywitd, il détruit tous les objets suivants :

Type d'élément de travail
Tous les éléments de travail de ce type
Entrées correspondantes dans les tables d'éléments de travail, les tables de texte de longueur importante et les tables de liaison
Objets dans le cache des métadonnées des types d'éléments de travail

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 : myworkitems.xml
Nom du type d'élément de travail : myworkitem
Encodage par défaut : UTF-8

Exporter la définition d'un type d'élément de travail

La commande suivante exporte la définition pour myworkitem vers le fichier, myworkitems.xml.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem

L'exemple suivant exporte l'élément de travail en utilisant l'encodage Unicode (UTF-7).

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7

Exporter la définition d'un type d'élément de travail et ses listes globales référencées

L'exemple suivant exporte le type d'élément de travail et ses listes globales référencées.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists

Afficher la définition d'un type d'élément de travail

L'exemple suivant affiche la définition du type d'élément de travail dans la fenêtre d'invite de commandes.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /n:myworkitem

Importer la définition des types d'éléments de travail

L'exemple suivant importe la définition d'élément de travail à partir du fichier XML.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks

Valider la définition XML des types d'éléments de travail

L'exemple suivant valide le XML qui définit le type d'élément de travail mais n'importe pas la définition.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v

Voir aussi

Partager via