Partager via


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 :

  • dimension: utilisée pour les champs de type Integer, String et DateTime.

  • detail: utilisée pour les champs de type Integer, Double, String et DateTime.

  • measure: utilisée pour les champs Integer et Double. Le type d'agrégation par défaut est sum. Vous pouvez spécifier un autre type d'agrégation à l'aide du paramètre formula.

  • disable: utilisée pour désactiver la rapportabilité du champ.

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