Personnalisation et gestion des types d'éléments de travail (witadmin)
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.
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.
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.
Notes
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 : 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 ou répertorier des 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 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.
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 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 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://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. .gif "Remarque") 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/AWTeam/Collection1
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/AWTeam/Collection1 /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/AWTeam/Collection1 /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/AWTeam/Collection1 /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/AWTeam/Collection1 /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/AWTeam/Collection1 /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/AWTeam/Collection1 /f:myworkitem.xml /p:AdventureWorks /v