Partager via

Procédure pas à pas : administration des champs dans un type d'élément de travail

  • Article

Mise à jour : novembre 2007

Dans cette procédure pas à pas, vous allez afficher, renommer et supprimer des champs utilisés par des types d'éléments de travail sur un serveur Team Foundation Server. Les champs peuvent couvrir de nombreux types d'éléments de travail sur plusieurs projets d'équipe.

Cette section traite des procédures suivantes :

  • Afficher des champs   Dans cette procédure, vous générez puis affichez les champs d'un type d'élément de travail.

  • Renommer des champs   Dans cette procédure, vous modifiez le nom d'un champ et observez où la modification apparaît sur le formulaire.

  • Supprimer des champs   Dans cette procédure, vous supprimez un champ que vous aviez ajouté au formulaire d'élément de travail dans une procédure antérieure.

Composants requis

Effectuez les étapes de la Procédure pas à pas : apporter des personnalisations de base à un type d'élément de travail et de la Procédure pas à pas : apporter des personnalisations avancées à un type d'élément de travail.

Si vous pouvez établir une connexion à un serveur Team Foundation Server et que vous disposez des autorisations appropriées, vous pouvez administrer les champs d'un type d'élément de travail à partir d'une invite de commandes, d'un fichier batch ou d'un fichier de script. Pour cela, vous devez utiliser l'utilitaire Invite de commandes de Visual Studio 2008 ou définir plusieurs variables d'environnement dans votre invite de commandes actuelle en utilisant vsvars32 comme décrit dans l'exemple suivant. Pour plus d'informations sur la façon de rejoindre un projet d'équipe, consultez Procédure pas à pas : rejoindre d'un projet d'équipe.

Pour activer des commandes Team Foundation à une invite de commandes

  • Cliquez sur Démarrer, Tous les programmes, pointez sur Microsoft Visual Studio 2008, Visual Studio Tools, puis cliquez sur Invite de commandes de Visual Studio 2008.

Vous pouvez aussi lancer vsvars32 à partir du chemin d'accès d'installation de Visual Studio, généralement LettreLecteur:\Program Files\Microsoft Visual Studio 9.0\Common7\Tools.

Autorisations requises

Pour exécuter cette procédure, vous devez être membre du groupe Team Foundation Administrators ou du groupe Project Administrators pour le projet. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Afficher des champs

Pour afficher des champs

  1. Ouvrez une invite de commandes Visual Studio.

  2. Envoyez tous les champs définis sur le serveur Team Foundation Server vers un fichier texte en tapant ce qui suit à l'invite de commandes, puis en appuyant sur ENTRÉE.

  3. witfields view /s:"NomServeurTeamFoundation"

    La liste des champs s'affiche avec les informations suivantes :

    Champ :

    Le nom de référence du champ.

    Nom :

    Le nom convivial du champ.

    Type :

    Le type de données du champ.

    Signalable en tant que :

    Les paramètres de rapport du champ.

    Utilisation :

    Les projets d'équipe qui utilisent ce champ et les types d'éléments de travail dans lequel le champ apparaît.

Renommer des champs

Pour renommer des champs

  1. À l'invite de commandes de Visual Studio, tapez ce qui suit et appuyez sur ENTRÉE :

    witfields rename /s:"NomServeurTeamFoundation" Microsoft.VSTS.Common.Rank Importance

    Cette commande remplace le champ Rang par Importance.

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

    Field renamed.

  3. Dans la fenêtre Team Explorer de Visual Studio, cliquez sur Actualiser pour télécharger les mises à jour les plus récentes à partir du serveur.

    Attendez quelques secondes que tous les nœuds soient chargés. Les nœuds encore en cours de chargement affichent le mot en cours.

  4. Cliquez avec le bouton droit sur le nœud Éléments de travail, puis sélectionnez Ajouter une requête pour créer une nouvelle requête.

  5. Cliquez sur la zone étiquetée Cliquez ici pour ajouter une clause pour ajouter une nouvelle ligne. Puis, sélectionnez la cellule Champ vide. Tapez Rang dans la cellule. 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>>.

  6. Supprimez la valeur Rang de la cellule Champ et entrez Importance dans la cellule.

  7. Sélectionnez <> dans la cellule Opérateur, puis tapez 1 dans la cellule Valeur.

  8. Dans le menu Équipe, cliquez sur Exécuter la requête.

  9. Cliquez avec le bouton droit sur une ligne quelconque dans les résultats et sélectionnez Options de colonne. Faites défiler la liste Colonnesdisponibles. Notez que le champ Rang a été remplacé par le champ Importance.

  10. Sélectionnez Importance 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 Importance dans le générateur de requêtes et la liste des résultats.

  11. Cliquez sur Fermer pour fermer le requête. Cliquez sur Non lorsque vous êtes invité à enregistrer la requête.

  12. Créez un nouvel élément de travail Tâche spéciale. 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 spéciale.

    Cet élément de travail est créé à partir du type d'élément de travail que vous avez modifié et importé.

  13. 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.

    Remarque :

    Consultez la procédure « Personnaliser une étiquette de champ » de la Procédure pas à pas : apporter des personnalisations avancées à un type d'élément de travail pour plus d'informations sur la modification des étiquettes de champ sur les formulaires d'élément de travail.

  14. Cliquez sur Fermer pour fermer la nouvelle tâche spéciale. Cliquez sur Non lorsque vous êtes invité à enregistrer l'élément de travail.

Supprimer des champs

Condition préalable : avoir terminé la procédure « Ajouter un champ » de la Procédure pas à pas : apporter des personnalisations de base à un type d'élément de travail.

Pour supprimer des champs

  1. Essayez de supprimer le champ Category qui a été ajouté lors de la procédure d'ajout d'un champ. Pour cela, à l'invite de commandes de Visual Studio, tapez ce qui suit et appuyez sur ENTRÉE.

    witfields delete /s:"NomServeurTeamFoundation" MyCompany.MyProcess.Category

    Le message d'erreur retourné indique que le champ ne peut pas être supprimé car il est utilisé par un projet d'équipe.

  2. Tapez la commande suivante, puis appuyez sur ENTRÉE.

    witexport /f "Chemin d'accès au fichier\specialtask.xml" /t "nom Team Foundation Server" /p WITLab /n "Special Task"

    Cette commande réexporte vers un fichier XML la définition du type d'élément de travail Tâche spéciale à partir de Team Foundation Server, y compris la nouvelle définition du champ Microsoft.VSTS.Common.Rank qui utilise son nouveau nom convivial après qu'il a été renommé lors de la procédure Renommer des champs.

    Remarque :

    Si vous exécutez Windows Vista, vous ne disposez peut-être pas des droits d'accès à certains dossiers. Si vous tentez d'exporter le type d'élément de travail vers un emplacement où vous n'avez pas de droits d'accès, la technologie de virtualisation du Registre redirige automatiquement le fichier exporté et l'enregistre dans le magasin virtuel. Pour plus d'informations, consultez https://go.microsoft.com/fwlink/?LinkId=92325 et https://go.microsoft.com/fwlink/?LinkId=92323. Pour éviter cette redirection, vous pouvez exporter le fichier vers un emplacement où vous avez des droits d'accès.

    Le message suivant s'affiche lorsque l'opération d'exportation est terminée :

    Work item type export complete.

  3. DansVisual Studio, cliquez sur Fichier, pointez sur Ouvrir, puis cliquez sur Fichier.

    La boîte de dialogue Ouvrir un fichier s'affiche.

    Remarque :

    Si le fichier SpecialTask.xml est ouvert, un message peut s'afficher pour vous demander si vous souhaitez recharger le fichier dans Visual Studio. Cliquez Oui pour le recharger.

  4. Sous Regarder dans, accédez à l'emplacement où vous avez exporté le fichier.

  5. Cliquez sur le fichier specialtask.xml, puis sur Ouvrir.

  6. Cliquez sur Non si vous êtes invité à modifier les fins de ligne.

  7. Recherchez et supprimez la définition du champ Category affichée dans le code XML suivant :

    <FIELD name="Category" refname="MyCompany.MyProcess.Category" type="String" reportable="dimension"><HELPTEXT>Describes the category to which this special task belongs.</HELPTEXT>  <WHEN field="Microsoft.VSTS.Common.Discipline" value="Business Analyst">    <ALLOWEDVALUES>      <LISTITEM value="Planning" />      <LISTITEM value="Review" />    </ALLOWEDVALUES>  </WHEN>  <WHENNOT field="Microsoft.VSTS.Common.Discipline" value="Business Analyst">    <ALLOWEDVALUES>      <LISTITEM value="Process Management" />      <LISTITEM value="Planning" />      <LISTITEM value="Execution" />      <LISTITEM value="Review" />    </ALLOWEDVALUES>  </WHENNOT></FIELD>

  8. Dans la section <Layout>, recherchez le code XML suivant et supprimez les sections en surbrillance pour supprimer le champ :

    <Group Label="Classification">
  <Column PercentWidth="50">    <Group>
      <Column PercentWidth="100">
        <Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area" LabelPosition="Left" />
        <Control Type="WorkItemClassificationControl" FieldName="System.IterationPath" Label="Iteration" LabelPosition="Left" />
      </Column>
    </Group>  </Column>  <Column PercentWidth="50">    <Group>      <Column PercentWidth="100">        <Control Type="FieldControl" FieldName="MyCompany.MyProcess.Category" Label="Category" LabelPosition="Left" />      </Column>    </Group>  </Column>
</Group>

  9. Cliquez sur Enregistrer pour enregistrer les modifications apportées à un fichier XML.

  10. Importez le type d'élément de travail Tâche Spéciale modifié dans Team Foundation Server. Pour ce faire, à l'invite de commandes de Visual Studio, tapez ce qui suit et appuyez sur ENTRÉE :

    witimport /f "Chemin d'accès au fichier\specialtask.xml" /t "nom Team Foundation Server" /p WITLab

    Le type d'élément de travail specialtask est ainsi importé dans Team Foundation Server. Le message suivant s'affiche lorsque l'opération d'importation est terminée :

    Work item type import complete.

  11. Vérifiez que le champ Category n'est plus utilisé par aucun type d'élément de travail en tapant ce qui suit à l'invite de commandes, puis en appuyant sur ENTRÉE.

    witfields view /s:"NomServeurTeamFoundation" MyCompany.MyProcess.Category

    L'outil witfields indique que le champ Category est « Non utilisé ».

    Field: MyCompany.MyProcess.Category

    Name: Category

    Type: String

    Reportable As: dimension

    Use: Not In Use

  12. Maintenant que le champ Category n'est plus utilisé par aucun type d'élément de travail, supprimez-le définitivement de Team Foundation Server en tapant le texte suivant à l'invite de commandes, puis en appuyant sur ENTRÉE. Entrez y à l'invite de confirmation pour terminer cette étape.

    witfields delete /s:"NomServeurTeamFoundation" MyCompany.MyProcess.Category

Voir aussi

Tâches

Procédure pas à pas : apporter des personnalisations de base à un type d'élément de travail

Procédure pas à pas : apporter des personnalisations avancées à un type d'élément de travail

Autres ressources

Personnalisation des types d'éléments de travail