Gestion des champs d'éléments de travail (witadmin)
Vous pouvez gérer les champs de type d'élément de travail définis pour une collection de projets d'équipe à l'aide des commandes witadmin suivantes :
deletefield : supprime le champ spécifié.
listfields : affiche les attributs de tous les champs ou d'un champ spécifié.
indexfield : active ou désactive l'indexation pour le champ spécifié. Lorsque vous activez l'indexation pour un champ, vous pouvez augmenter les performances de recherche des éléments de travail dont les requêtes spécifient le champ concerné. Si vous ajoutez un champ personnalisé que vous utilisez dans un bon nombre de vos requêtes d'élément de travail, vous pouvez activer l'indexation pour ce champ.
changefield : modifie un ou plusieurs attributs d'un champ, tel que le nom de champ convivial, les attributs pour les rapports de l'entrepôt de données ou la capacité à synchroniser un champ qui contient des noms de personnes. Lorsque la synchronisation est activée, le champ est mis à jour étant donné que les mises à jour sont faites sur Active Directory ou un groupe de travail. Pour plus d'informations sur l'utilisation des champs pour la création de rapports, consultez Utilisation des champs d'élément de travail.
Important
Lorsque vous effectuez une mise à niveau d'une version antérieure vers la version actuelle, l'attribut syncnamechanges a la valeur true pour tous les champs String qui contiennent des noms de personnes. Toutefois, vous devez assigner manuellement l'attribut à tout champ personnalisé que vous utilisez pour stocker des noms de personne et que vous souhaitez synchroniser. Pour plus d'informations, consultez Mise à jour des champs de noms de personnes personnalisés pour une synchronisation avec Active Directory ou des groupes de travail.
L'outil de 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 champs, consultez Définition des champs d'éléments de travail.
Notes
Vous pouvez créer et modifier les champs d'élément de travail à l'aide de l'éditeur de processus, un outil puissant pour 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 la collection de projets d'équipe dans laquelle les champs de types d'éléments de travail sont définis, vous devez disposer des autorisations suivantes :
Pour répertorier les champs, vous devez être membre du groupe Readers ou disposer de l'autorisation Afficher les éléments de travail dans ce nœud avec la valeur Autoriser.
Pour supprimer ou renommer des champs ou modifier les caractéristiques de création de rapports d'un champ, 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 deletefield /collection:CollectionURL /n:RefName [/noprompt]
witadmin listfields /collection:CollectionURL /n:RefName [/unused]
witadmin indexfield /collection:CollectionURL /n:Name /index:on|off
witadmin changefield /collection:CollectionURL /n:RefName [/name:NewName] [/syncnamechanges:true | false] [/reportingname:ReportingName] [/reportingrefname:ReportingRefName] [/reportingtype:Type] [/reportingformula:Formula] [/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 |
/n:RefName /n:Name |
Nom de référence d'un champ de type d'élément de travail. |
/index |
Spécifie l'activation ou la désactivation de l'indexation du champ spécifié. Spécifiez on pour activer l'indexation et off pour désactiver l'indexation. |
/name:NewName |
Spécifie le nouveau nom du champ. |
/syncnamechanges |
Spécifie l'utilisation du champ d'élément de travail pour stocker des noms et procéder à une mise à jour à mesure que des modifications sont apportées à Active Directory ou à un groupe de travail. Cette option est valide uniquement lorsqu'un champ avec le type de données String est spécifié pour le typename. Spécifiez true pour permettre la synchronisation du champ de données, spécifiez false pour désactiver la synchronisation du champ de données. |
/reportingname:ReportingName |
Spécifie le nom du champ à utiliser dans l'entrepôt de données pour la création de rapports. |
/reportingrefname:ReportingRefName |
Spécifie le nom de référence du champ à utiliser dans l'entrepôt de données pour la création de rapports. |
/reportingtype:Type |
Spécifie le mode d'utilisation du champ dans l'entrepôt pour la création de rapports. Les valeurs suivantes sont valides :
Pour plus d'informations, consultez Utilisation des champs d'élément de travail. |
/reportingformula:Formula |
Spécifie la formule d'agrégation à utiliser lorsque le champ est signalé comme étant un measure. La seule formule prise en charge est sum. |
/unused |
Affiche tous les champs qui ne sont pas utilisés par les projets d'équipe définis dans la collection de projets d'équipe. |
/noprompt |
Désactive l'invite de confirmation. |
/? or help |
Affiche de l'aide sur la commande dans la fenêtre d'invite de commandes. |
Notes
Lorsque vous assignez l'attribut syncnamechanges à un champ String, le champ accepte toujours des noms d'utilisateur valides. Toutefois, le champ n'autorise pas les noms de groupe stockés dans Team Foundation Server ou dans Active Directory si l'une des conditions suivantes a la valeur true :
La règle VALIDUSER est spécifiée à travers tous les types d'éléments de travail
La règle VALIDUSER est spécifiée pour un type d'élément de travail
La règle ALLOWEDVALUES est spécifiée pour un type d'élément de travail, et cette règle a un critère de filtre qui exclut des groupes
Pour plus d'informations, consultez Référence de tous les éléments XML FIELD.
Pour obtenir un résumé des champs système indexés, consultez Utilisation de champs système et de champs définis par les modèles de processus MSF.
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 champ d'élément de travail : AdventureWorks.Field
Encodage par défaut : UTF-8
Afficher les champs
La commande suivante affiche les informations à propos de chaque champ défini pour Collection1 sur le serveur AdventureWorksServer :
witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1
La commande suivante affiche des informations relatives au champ spécifié AdventureWorks.Field utilisé par Collection1 :
witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field
La commande suivante affiche tous les champs que Collection1 n'utilise pas :
witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /unused
Renommer un champ
La commande suivante remplace le nom convivial du champ référencé AdventureWorks.Field par NewFieldName pour Collection1 :
witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field /name:NewFieldName
Modifier la valeur de rapport d'un champ
La commande suivante spécifie la capacité à rapporter le type du champ DateTime AdventureWorks.CreatedOn à dimension. Les données de ce champ entrent dans les bases de l'entrepôt et d'Analysis Services afin qu'elles puissent être utilisées pour filtrer des rapports.
witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.CreatedOn /reportingtype:dimension
La commande suivante spécifié la capacité à rapporter le type du champ Double AdventureWorks.Field à measure. Toutes les mesures sont agrégées par somme.
witadmin reportfield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field /reportingtype:measure
Activer la synchronisation d'un champ de nom personnalisé
La commande suivante permet la synchronisation pour le champ d'élément de travail AW.CustomerName défini pour Collection1 sur AdventureWorksServer.
witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.CustomerName /syncnamechanges:true
Supprimer un champ
La commande suivante supprime le champ AdventureWorks.Field de Collection1 :
witadmin deletefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field
Voir aussi
Tâches
Répertorier des champs d'élément de travail et afficher les attributs assignés aux champs
Concepts
Utilisation de champs système et de champs définis par les modèles de processus MSF
Autres ressources
Résolution de conflits de schéma qui se produisent dans l'entrepôt de données
Définition des champs d'éléments de travail
Ajout et modification de champs d'éléments de travail pour prendre en charge la création de rapports
Définition des champs d'éléments de travail
witAdmin : administration des objets de suivi des éléments de travail