Renommer un champ de type d'élément de travail

Article
08/10/2011

Vous pouvez modifier le nom convivial d'un champ d'élément de travail pour respecter les conventions d'affectation de noms utilisées par votre équipe via l'outil en ligne de commande witadmin changefield. Notez que le nouveau nom est appliqué à tous les types d'éléments de travail qui référencent le champ modifié dans tous les projets d'équipe de la collection de projets. Le nom convivial s'affiche lorsque vous définissez des critères de filtre dans une requête d'élément de travail. Le nom qui s'affiche sur un formulaire d'élément de travail peut être différent du nom convivial défini pour le champ.

Pour afficher la liste des champs définis pour une collection de projets, consultez Répertorier des champs d'élément de travail et afficher les attributs assignés aux champs.

Autorisations requises

Pour effectuer cette procédure, vous devez être membre du groupe Team Foundation Administrators ou du groupe Project Administrators pour tous les projets où le champ est utilisé. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Dans cette rubrique

Renommer le nom convivial d'un champ d'élément de travail
Vérifier que vos modifications s'affichent dans Team Explorer

Renommer le nom convivial d'un champ d'élément de travail

Pour renommer un champ d'élément de travail

Ouvrez une fenêtre d'invite de commandes.
Accédez au répertoire qui contient les types d'éléments de travail dont vous souhaitez dresser la liste, en tapant la commande suivante et en appuyant sur Entrée.

cd ..Lecteur:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE

Pour renommer un champ d'élément de travail, tapez ce qui suit, puis appuyez sur ENTRÉE.

witadmin changefield /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /n:typename /name:newname

Par exemple :

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:Microsoft.VSTS.Common.Rank /name:"Important Rank"

Cette commande renomme le champ Microsoft.VSTS.Common.Rank en Important Rank.

À l'invite de confirmation tapez y et appuyez sur ENTRÉE. Attendez jusqu'à ce que le message suivant s'affiche :

Field renamed.

Pour plus d'informations, consultez Gestion des champs d'éléments de travail (witadmin).

Vérifier que vos modifications s'affichent dans Team Explorer

Pour vérifier les modifications importées dans un projet unique

Dans Team Explorer, cliquez avec le bouton droit sur le nœud du projet d'équipe qui contient un type d'élément de travail comportant le champ renommé, puis cliquez sur Actualiser.

Les mises à jour les plus récentes sont téléchargées à partir du serveur, notamment les modifications que vous venez d'apporter au nom du champ. Attendez quelques secondes jusqu'à ce que le nœud Éléments de travail soit actualisé. Les nœuds encore en cours de chargement affichent le mot en cours.
Cliquez avec le bouton droit sur le nœud Éléments de travail, puis sélectionnez Ajouter une requête pour créer une requête.
Cliquez sur la zone étiquetée Cliquez ici pour ajouter une clause afin d'ajouter une ligne, sélectionnez la cellule Champ vide, puis tapez Rang dans cette dernière. Remarquez le message suivant qui apparaît au-dessus de la liste des résultats. Ce message indique que le Rang est introuvable.

Exécutez la requête pour consulter ses résultats. TF51005 : la requête fait référence à un champ qui n'existe pas. L'erreur est provoquée par <<Rang>>.
Supprimez la valeur Rang de la cellule Champ, puis tapez Rang important dans la cellule.
Sélectionnez <> dans la cellule Opérateur, puis tapez 1 dans la cellule Valeur.
Dans la barre d'outils Requête, cliquez sur .
Cliquez avec le bouton droit sur une ligne quelconque dans les résultats et sélectionnez Options de colonne. Faites défiler la liste Colonnes disponibles. Notez que le champ Rang a été remplacé par le champ Rang important.
Sélectionnez Rang important dans la zone Colonnes disponibles, puis cliquez sur le bouton Ajouter les colonnes sélectionnées, (>). Cliquez sur OK.

Notez que Rang, le nom convivial de Microsoft.VSTS.Common.Rank, a été remplacé par Rang important dans le générateur de requêtes et la liste des résultats.
Cliquez sur Fermer pour fermer le requête. Cliquez sur Non lorsque vous êtes invité à enregistrer la requête.
Créez un élément de travail Tâche. Pour ce faire, cliquez avec le bouton droit sur le nœud Éléments de travail, pointez sur Ajouter un élément de travail, puis cliquez sur Tâche.

Cet élément de travail est créé à partir du type d'élément de travail que vous avez modifié et importé.
Remarquez que dans la zone État l'étiquette du champ renommé Rang n'a pas changé. En effet, la portée des étiquettes de champ sur les formulaires d'élément de travail se limite au projet d'équipe parent, les étiquettes sont donc indépendantes du nom de champ qui vient d'être spécifié pour l'ensemble du serveur.

Notes

Pour plus d'informations sur la modification d'étiquettes de champ sur les formulaires d'élément de travail, consultez Modification de l'étiquette d'un champ.
Cliquez sur Fermer pour fermer la nouvelle tâche. Cliquez sur Non lorsque vous êtes invité à enregistrer l'élément de travail.