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

  • Article

Vous pouvez modifier la façon dont vous suivez la progression de votre équipe en créant et en personnalisant des objets qui suivent les éléments de travail. L'outil en ligne de commande witadmin vous permet de créer, de supprimer, d'importer et d'exporter des objets, tels que des catégories, des listes globales, un flux de travail global, des types de liens et des types d'élément de travail. Vous pouvez également supprimer définitivement des types de types d'éléments de travail, et vous pouvez supprimer, répertorier ou modifier les attributs de champs dans l'élément de travail.

Comme le montre l'illustration suivante, vous gérez des catégories et des types d'éléments de travail pour chaque projet d'équipe. Vous gérez des listes globales, des types de liens et des champs d'élément de travail pour chaque collection de projets d'équipe. Vous pouvez personnaliser un flux de travail global pour un projet d'équipe ou une collection.

Objets de suivi des éléments de travail

L'outil en ligne de commande witadmin se trouve dans le dossier Lecteur:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE sur les ordinateurs clients qui exécutent Team Explorer. Sur les ordinateurs 64 bits, l'outil se trouve dans Lecteur:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE.

Notes

Vous pouvez créer et modifier des objets de suivi des éléments de travail à l'aide de Process Editor, un outil puissant de 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 April 2010.

Dans cette rubrique

  • Composants requis

  • Paramètres globaux

  • Index des commandes

Composants requis

Pour utiliser l'outil en ligne de commande witadmin, vous devez vous connecter à un réseau sur lequel les serveurs et les services suivants pour Team Foundation Server s'exécutent :

  • Serveur de couche Application pour Team Foundation Server

  • Microsoft SQL Server 2008

  • SQL Server Reporting Services

  • Contrôleur de domaine Active Directory

  • Services IIS (Internet Information Services) 6.0 ou 7.0

  • .NET Framework 

Paramètres globaux

Vous pouvez utiliser les paramètres suivants pour afficher le texte d'aide pour witadmin.

Paramètre

Description

/help

ou

/?

Affiche la syntaxe et les paramètres de l'outil en ligne de commande witadmin.

command /help

ou

command /?

Affiche la syntaxe et les paramètres de la commande witadmin que vous spécifiez.

Index des commandes

Tâches

Contenu associé

Créer et modifier des types d'éléments de travail : les types d'éléments de travail définissent les champs et le comportement utilisés pour créer et gérer les éléments de travail. Vous pouvez créer et modifier des types d'éléments de travail pour prendre en charge les objectifs de processus de votre équipe et de votre projet d'équipe.

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

  • destroywitd : supprime un type d'élément de travail.

  • exportwitd : exporte la définition XML d'un type d'élément de travail.

  • importwitd : importe la définition XML d'un type d'élément de travail.

  • listwitd: répertorie les noms des types d'éléments de travail.

  • renamewitd: modifie le nom d'affichage d'un type d'élément de travail.

Définir et gérer des groupes de types d'éléments de travail. En utilisant des catégories, vous pouvez grouper des types d'éléments de travail, puis exécuter des opérations sur eux comme un ensemble. Par exemple, vous pouvez spécifier une catégorie lorsque vous définissez les critères d'une requête d'élément de travail pour rechercher tous les éléments de travail dans cette catégorie, indépendamment des types des éléments.

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

  • exportcategories : exporte les définitions XML de toutes les catégories.

  • importcategories : importe les définitions XML de toutes les catégories.

Créer, modifier, exporter, importer et afficher des listes globales pour les types d'éléments de travail : En utilisant des listes globales, vous pouvez partager des éléments de liste parmi plusieurs types d'éléments de travail.

Vous pouvez gérer les listes globales d'une collection à l'aide des commandes witadmin suivantes :

  • destroygloballist : supprime une liste globale.

  • exportgloballist : exporte le fichier de définition XML qui contient une ou plusieurs listes globales.

  • importgloballist : importe le fichier XML qui définit une ou plusieurs listes globales.

  • listgloballist : répertorie le nom de chaque liste globale définie pour la collection.

Créer, modifier, exporter ou importer un flux de travail global. À l'aide d'un flux de travail global, vous pouvez réduire le travail nécessaire à la définition et à la mise à jour de listes globales et de champs d'élément de travail utilisés par un certain nombre de projets d'équipe et de types d'éléments de travail. Vous pouvez partager des définitions de champs et éléments de liste parmi plusieurs types d'éléments de travail.

Vous gérez le flux de travail global pour chaque projet d'équipe ou collection à l'aide des commandes witadmin suivantes :

  • exportglobalworkflow : exporte le fichier XML qui définit un flux de travail global.

  • importglobalworkflow : importe le fichier XML qui définit un flux de travail global.

Créer, modifier, répertorier, activer, désactiver, importer et exporter des types de liens. Les types de liens vous permettent d'associer des éléments de travail en fonction d'un ensemble de règles de lien. Si vous créez des types personnalisés de liens, vous pouvez suivre des éléments de travail et leurs dépendances de plusieurs façons.

Vous pouvez gérer les types de liens d'une collection à l'aide des commandes witadmin suivantes :

  • deactivatelinktype : désactive un type de lien spécifié.

  • deletelinktype : supprime définitivement le type de lien spécifié de la base de données.

  • exportlinktype : exporte les fichiers de définition XML d'un ou de plusieurs types de liens.

  • importlinktype : importe les fichiers de définition XML d'un ou de plusieurs types de liens.

  • listlinktypes : répertorie l'ensemble de types de liens sur un serveur.

  • reactivatelinktype : réactive le type de lien que vous spécifiez. Vous pouvez également renommer le type de lien.

Supprimer, répertorier et renommer des champs dans des types d'éléments de travail et redéfinir les champs qui déterminent les caractéristiques d'indexation et de création de rapports. Les champs permettent de rechercher des éléments de travail et assurer le suivi de leurs informations.

Vous pouvez gérer les champs d'une collection à l'aide des commandes witadmin suivantes :

  • deletefield : supprime le champ que vous spécifiez.

  • listfields : répertorie les attributs d'un champ que vous spécifiez ou de tous les champs.

  • indexfield : active ou désactive l'indexation d'un champ que vous spécifiez.

  • changefield : modifie un ou plusieurs attributs d'un champ que vous spécifiez.

Détruire des éléments de travail : Vous pouvez supprimer définitivement des éléments de travail d'une collection de projets d'équipe à l'aide de la commande witadmin destroywi.

Forcer une régénération du cache client : Après certaines opérations de maintenance, vous pouvez forcer une reconstruction du cache de tous les ordinateurs clients lors de leur prochaine connexion à une collection de projets d'équipe. Par exemple, vous pouvez forcer une reconstruction après avoir déplacé, renommé, restauré un serveur de couche Données ou Application, ou basculé sur ce type de serveur. En forçant une reconstruction, vous contribuez à la prévention des erreurs liées à l'espace de travail pendant les opérations de contrôle de version ou de génération. Pour effectuer cette opération, vous utilisez la commande witadmin rebuildcache.

Voir aussi

Concepts

Personnalisation des données de suivi de projet, de formulaires, de flux de travail et d'autres objets

Autres ressources

Identification de vos besoins en matière de personnalisation des processus et du suivi

Utilisation des outils en ligne de commande Team Foundation Server

Historique des modifications

Date

Historique

Motif

Janvier 2011

Ajout d'informations sur le flux de travail global et illustration des objets pour le suivi des éléments de travail.

Améliorations apportées aux informations.