Utiliser des étiquettes pour prendre un instantané de vos fichiers
Les étiquettes vous permettent de prendre un instantané de vos fichiers pour que vous puissiez utiliser cet instantané par la suite. En utilisant l'étiquette, vous pouvez afficher, générer ou restaurer un grand ensemble de fichiers dans l'état dans lequel ils se trouvaient lorsque vous avez appliqué l'étiquette.
Autorisations requises
Pour appliquer une étiquette, l'autorisation Étiquette doit avoir la valeur Autoriser. Pour rechercher, répertorier ou afficher des étiquettes, l'autorisation Lire doit avoir la valeur Autoriser. Pour modifier ou supprimer une étiquette, vous devez être propriétaire de l'étiquette ou l'autorisation Administrer les étiquettes doit avoir la valeur Autoriser.
Dans cet article
Utiliser des étiquettes
Appliquer une étiquette
Renommer une étiquette
Répertorier, rechercher, afficher, modifier et supprimer des étiquettes
Télécharger des versions étiquetées des fichiers dans votre espace de travail
Utiliser la fenêtre Étiquette pour utiliser des étiquettes
Restaurer des fichiers à partir d'une version étiquetée
Utiliser des étiquettes à partir de la ligne de commande
Utiliser des étiquettes
Dans de nombreux projets de logiciels, lorsque le code a atteint un niveau raisonnable de qualité et de stabilité, l'équipe génère et diffuse une nouvelle version du produit. L'équipe doit marquer la version actuelle de chaque fichier pour pouvoir obtenir et générer la nouvelle version de chaque fichier du projet même si les fichiers sont modifiés par la suite.
En théorie, vous pourriez enregistrer manuellement l'ID de chaque ensemble de modifications pour chaque fichier ; mais ce processus n'est clairement pas pratique. Le contrôle de version Team Foundation facilite cette tâche : vous appliquez une étiquette au dossier, à la branche ou au projet d'équipe qui contient les fichiers. Vous pouvez donner à l'étiquette un nom qui suit la convention d'affectation de noms de votre choix. Exemples de noms d'étiquette : "Sprint 5", "M1", "Bêta 2" et "Version finale (RC) 0".
Après avoir appliqué l'étiquette, vous pouvez l'utiliser pour qualifier des opérations telles que la génération, la création de branche, la fusion, la comparaison et l'obtention de versions spécifiques de fichiers et dossiers.
Parfois, vous devez modifier une étiquette après l'avoir appliquée. contrôle de version Team Foundation vous permet d'appliquer une étiquette à des fichiers supplémentaires, de supprimer une étiquette de certains fichiers et même de modifier la version d'un fichier spécifique auquel l'étiquette s'applique.
Conseil
L'application d'une étiquette fournit quasiment les mêmes avantages que la création d'une branche pour un coût et une complexité généralement moins élevés.
Appliquer une étiquette
Appliquer une étiquette
Dans l'Explorateur du contrôle de code source, cliquez avec le bouton droit sur la collection, le projet d'équipe, la branche, le dossier ou le fichier auquel vous souhaitez appliquer une étiquette et cliquez sur Appliquer une étiquette.
La boîte de dialogue Nouvelle étiquette s'affiche.
Dans la zone Nom, tapez un nom pour l'étiquette.
(Facultatif) Tapez vos commentaires dans la zone Commentaire.
Dans la liste Version, l'option Dernière version est sélectionnée par défaut. Cette option est généralement la plus utilisée, mais si l'étiquette doit cibler une version spécifique, vous pouvez sélectionner l'une des options suivantes :
Si vous cliquez sur Ensemble de modifications, vous pouvez spécifier le numéro de l'ensemble de modifications dans la zone Ensemble de modifications. Vous pouvez aussi cliquer sur le bouton de sélection (...) pour ouvrir la boîte de dialogue Rechercher les ensembles de modifications. Pour plus d'informations, consultez Rechercher des informations sur un ensemble de modifications.
Si vous cliquez sur Date, vous pouvez spécifier une date dans la zone Date ou sélectionner une date dans le calendrier du menu déroulant.
Si vous cliquez sur Étiquette, vous pouvez spécifier une étiquette existante sur laquelle baser la nouvelle étiquette. Tapez le nom de l'étiquette dans la zone Étiquette ou cliquez sur le bouton de sélection (…) pour ouvrir la boîte de dialogue Rechercher une étiquette. Pour plus d'informations, consultez Répertorier, rechercher, afficher, modifier et supprimer des étiquettes.
Si vous cliquez sur Version de l'espace de travail, l'étiquette est créée pour la version comprise dans votre espace de travail.
Lorsque les paramètres vous conviennent, exécutez l'une des étapes suivantes :
Pour appliquer l'étiquette, cliquez sur Créer.
Pour appliquer l'étiquette et la modifier par la suite, cliquez sur Créer et modifier. L'étiquette est alors appliquée, puis la fenêtre Étiquette s'affiche. Pour plus d'informations sur l'utilisation de la fenêtre Étiquette pour modifier une étiquette, consultez Utiliser la fenêtre Étiquette pour utiliser des étiquettes.
Notes
Lorsque vous appliquez une étiquette dont le nom existe déjà, le système vous avertit et vous demande si vous voulez continuer. Si vous cliquez sur OK pour continuer, tous les éléments non contenus dans le chemin d'accès auquel vous appliquez l'étiquette ne seront plus associés à cette étiquette.
Renommer une étiquette
Si vous ne pouvez pas modifier le nom d'une étiquette existante, vous pouvez en revanche appliquer une nouvelle étiquette aux fichiers et aux versions auxquels une autre étiquette s'applique.
Appliquer une étiquette basée sur une étiquette existante
Dans l'Explorateur du contrôle de code source, cliquez avec le bouton droit sur le nœud de collection projet (nœud racine), puis cliquez sur Appliquer une étiquette.
La boîte de dialogue Nouvelle étiquette s'affiche.
Dans la zone Nom, tapez un nom pour l'étiquette.
(Facultatif) Dans la zone Commentaire, tapez un commentaire.
Dans la liste Version, sélectionnez Étiquette.
La zone Étiquette s'affiche.
Effectuez l'une des opérations suivantes :
Tapez le nom de l'étiquette existante.
Si vous ne connaissez pas le nom de l'étiquette existante, cliquez sur le bouton de sélection (...) en regard de la zone Étiquette.
La boîte de dialogue Rechercher une étiquette s'affiche.
Utilisez les options de la boîte de dialogue Rechercher une étiquette pour filtrer la liste d'étiquettes et rechercher l'étiquette existante à laquelle vous souhaitez appliquer la nouvelle étiquette. (Pour plus d'informations, consultez Répertorier, rechercher, afficher, modifier et supprimer des étiquettes.)
Cliquez sur Créer.
(Facultatif) Après avoir créé l'étiquette, vous pouvez supprimer l'ancienne étiquette. Pour plus d'informations, consultez Répertorier, rechercher, afficher, modifier et supprimer des étiquettes.
Répertorier, rechercher, afficher, modifier et supprimer des étiquettes
Il existe deux façons de répertorier et de rechercher des étiquettes : la boîte de dialogue Rechercher une étiquette et l'onglet Étiquette de la fenêtre Historique. Une fois que vous avez trouvé l'étiquette qui vous intéresse, vous pouvez la consulter, la modifier, la supprimer ou utiliser les fichiers auxquels elle s'applique.
Rechercher et utiliser des étiquettes à l'aide de la boîte de dialogue Rechercher une étiquette
Dans l'Explorateur du contrôle de code source, dans le menu Fichier, pointez sur Contrôle de code source, Étiquette, puis cliquez sur Rechercher une étiquette.
La boîte de dialogue Rechercher une étiquette s'affiche.
(Facultatif) Affinez votre recherche en exécutant une ou plusieurs des étapes suivantes :
Dans la zone de texte Nom, entrez le nom de l'étiquette.
Dans la liste Projet, sélectionnez le projet d'équipe qui contient l'étiquette que vous souhaitez rechercher.
Dans la zone de texte Propriétaire, tapez le nom ou l'alias du propriétaire de l'étiquette.
Cliquez sur Rechercher.
La liste Résultats affiche des étiquettes qui correspondent aux critères de recherche que vous avez entrés.
(Facultatif) Effectuez l'une des étapes suivantes :
Pour afficher ou modifier une étiquette, sélectionnez-la et cliquez sur Modifier.
La fenêtre Étiquette s'affiche. Pour plus d'informations, consultez Utiliser la fenêtre Étiquette pour utiliser des étiquettes.
Pour supprimer une étiquette, sélectionnez-la et cliquez sur Supprimer.
Cliquez sur Fermer.
Il peut arriver que vous ne soyez pas certain du nom d'une étiquette, mais que vous sachiez que l'étiquette a été appliquée à un élément particulier sous contrôle de version. La procédure suivante explique comment rechercher, puis utiliser une étiquette dans ce type de situation.
Répertorier et utiliser des étiquettes qui s'appliquent à un élément spécifique
Dans l'Explorateur du contrôle de code source, cliquez avec le bouton droit sur l'élément auquel l'étiquette que vous souhaitez rechercher s'applique, puis cliquez sur Afficher l'historique.
La fenêtre Historique s'affiche.
Cliquez sur l'onglet Étiquettes pour afficher la liste des étiquettes qui s'appliquent à cet élément.
(Facultatif) Effectuez l'une des étapes suivantes :
Pour afficher ou modifier une étiquette, cliquez dessus avec le bouton droit et sélectionnez Modifier l'étiquette.
La fenêtre Étiquette s'affiche. Pour plus d'informations sur l'utilisation de cette fenêtre, consultez Utiliser la fenêtre Étiquette pour utiliser des étiquettes.
Pour supprimer une étiquette, cliquez dessus avec le bouton droit et sélectionnez Supprimer l'étiquette.
Cliquez avec le bouton droit sur l'étiquette et sélectionnez d'autres actions, par exemple Obtenir cette version et Comparer.
Pour plus d'informations sur l'utilisation de l'onglet Étiquette de la fenêtre Historique, consultez Afficher des données historiques.
Télécharger des versions étiquetées des fichiers dans votre espace de travail
L'étiquetage d'un jeu de fichiers revient à prendre un instantané de ces fichiers à un point précis dans le temps. Des semaines ou des mois après avoir pris cet instantané, vous aurez peut-être besoin d'afficher ou d'utiliser les versions des fichiers datant de la prise de cet instantané. La procédure suivante explique comment télécharger les versions étiquetées d'un jeu de fichiers dans votre espace de travail.
Télécharger des versions étiquetées des fichiers dans votre espace de travail
Dans l'Explorateur du contrôle de code source, cliquez avec le bouton droit sur la collection de projets, le projet d'équipe, la branche ou le dossier qui contient les éléments que vous souhaitez télécharger, puis cliquez sur Obtenir une version spécifique.
La boîte de dialogue Obtenir s'affiche.
Dans la liste Type, sélectionnez Étiquette, puis tapez le nom de l'étiquette dans la zone Étiquette ou cliquez sur les points de suspension (...) pour ouvrir la boîte de dialogue Rechercher une étiquette. Pour plus d'informations sur l'utilisation de cette boîte de dialogue, consultez Répertorier, rechercher, afficher, modifier et supprimer des étiquettes.
Passez en revue et sélectionnez les options supplémentaires appropriées dans la boîte de dialogue Obtenir.
Cliquez sur Obtenir.
Utiliser la fenêtre Étiquette pour utiliser des étiquettes
Maintenant que vous avez ouvert la fenêtre Étiquette en suivant l'une des procédures précédentes, vous pouvez commencer à utiliser l'étiquette. Dans la partie supérieure de la fenêtre, une zone affiche un commentaire, que vous pouvez modifier.
Vous pouvez utiliser la fenêtre Étiquette pour effectuer les tâches suivantes :
Ajouter un élément à l'étiquette
Supprimer un élément de l'étiquette
Modifier la version d'un fichier
Exécuter d'autres actions sur un élément
Ajouter un élément à l'étiquette
Dans la fenêtre Étiquette, cliquez sur Ajouter un élément.
La boîte de dialogue Choisir la version de l'élément s'affiche.
Dans la boîte de dialogue Choisir la version de l'élément, accédez à l'élément que vous souhaitez ajouter, puis sélectionnez-le.
Conseil
Vous pouvez maintenir enfoncée la touche CONTRÔLE ou la touche MAJ pour sélectionner plusieurs éléments.
(Facultatif) Si l'étiquette doit cibler une version spécifique, vous pouvez sélectionner l'une des options suivantes dans la liste Version :
Si vous cliquez sur Dernière version, l'étiquette sera appliquée à la version la plus récente du contrôle de version.
Si vous cliquez sur Ensemble de modifications, vous pouvez spécifier le numéro de l'ensemble de modifications dans la zone Ensemble de modifications. Vous pouvez aussi cliquer sur le bouton de sélection (...) pour ouvrir la boîte de dialogue Rechercher les ensembles de modifications. Pour plus d'informations, consultez Rechercher des informations sur un ensemble de modifications.
Si vous cliquez sur Date, vous pouvez spécifier une date dans la zone Date ou sélectionner une date dans le calendrier du menu déroulant.
Si vous cliquez sur Étiquette, vous pouvez spécifier une étiquette existante sur laquelle baser la nouvelle étiquette. Tapez le nom de l'étiquette dans la zone Étiquette ou cliquez sur le bouton de sélection (…) pour ouvrir la boîte de dialogue Rechercher une étiquette. Pour plus d'informations, consultez Répertorier, rechercher, afficher, modifier et supprimer des étiquettes.
Si vous cliquez sur Version de l'espace de travail, l'étiquette est créée pour la version comprise dans votre espace de travail.
Cliquez sur OK.
Cliquez sur le menu Fichier, puis sur Enregistrer.
Supprimer un élément de l'étiquette
Dans la fenêtre Étiquette, localisez la collection, le projet d'équipe, la branche, le dossier ou le fichier que vous souhaitez supprimer de cette étiquette.
Cliquez avec le bouton droit sur l'élément et sélectionnez Supprimer de l'étiquette.
L'étiquette est supprimée de l'élément. Si l'élément est une collection de projets, un projet d'équipe, une branche ou un dossier, l'étiquette est également supprimée de tous les éléments que cet élément contient.
Cliquez sur le menu Fichier, puis sur Enregistrer.
Modifier la version d'un fichier
Dans la fenêtre Étiquette, localisez le fichier que vous souhaitez modifier.
Cliquez avec le bouton droit sur le fichier et sélectionnez Modifier la version de l'élément.
La boîte de dialogue Choisir la version de l'élément s'affiche.
Effectuez l'une des opérations suivantes :
Cliquez sur Dernière version pour appliquer l'étiquette à la version la plus récente du contrôle de version.
Cliquez sur Ensemble de modifications, puis spécifiez le numéro de l'ensemble de modifications dans la zone Ensemble de modifications. Vous pouvez aussi cliquer sur le bouton de sélection (...) pour ouvrir la boîte de dialogue Rechercher les ensembles de modifications. Pour plus d'informations, consultez Rechercher des informations sur un ensemble de modifications.
Cliquez sur Date, puis spécifiez une date dans la zone Date ou sélectionnez une date dans le calendrier du menu déroulant.
Cliquez sur Étiquette, puis spécifiez une étiquette existante sur laquelle baser la nouvelle étiquette. Tapez le nom de l'étiquette dans la zone Étiquette ou cliquez sur le bouton de sélection (…) pour ouvrir la boîte de dialogue Rechercher une étiquette. Pour plus d'informations, consultez Répertorier, rechercher, afficher, modifier et supprimer des étiquettes.
Cliquez sur Version de l'espace de travail, l'étiquette est créée pour la version comprise dans votre espace de travail.
Cliquez sur le menu Fichier, puis sur Enregistrer.
Exécuter d'autres actions sur un élément étiqueté
Lorsque vous cliquez avec le bouton droit sur un élément dans la fenêtre Étiquette, vous pouvez également sélectionner l'une des commandes suivantes :
Affichage (fichiers uniquement)
Afficher l'historique
Comparer (fichiers uniquement)
Annoter (fichiers uniquement)
Obtenir cette version
Restaurer des fichiers à partir d'une version étiquetée
Vous pouvez utiliser la commande tf rollback pour rétablir un jeu de fichiers à partir de versions marquées par une étiquette. Pour plus d'informations, consultez Rollback, commande (contrôle de version Team Foundation).
Utiliser des étiquettes à partir de la ligne de commande
Cette section présente quelques utilisations classiques des étiquettes à partir de la ligne de commande.
Répertorier des étiquettes à partir de la ligne de commande
Répertorier des étiquettes à partir de la ligne de commande
Cliquez sur Démarrer, puis sur Tous les programmes, pointez sur Microsoft Visual Studio 2010, sur Visual Studio Tools, puis cliquez sur Invite de commandes de Visual Studio (2010).
Tapez cd chemin d'accès, où chemin d'accès représente le répertoire qui contient l'espace de travail approprié.
Tapez tf labels.
Appliquer et modifier des étiquettes à partir de la ligne de commande
L'application d'une étiquette à partir de la ligne de commande n'a pas les mêmes conséquences que l'application d'une étiquette à l'aide de Visual Studio ALM (comme décrit précédemment dans cette rubrique). Lorsque vous utilisez Visual Studio ALM pour appliquer une étiquette qui existe déjà, l'opération supprime cette étiquette de toutes les versions de fichier, puis applique la nouvelle étiquette.
À partir de la ligne de commande, toutefois, cette opération est incrémentielle. Par exemple, supposons que vous appliquiez l'étiquette mylabel à $/DinnerNow/Features/FeatureTeamA. Si vous appliquez par la suite l'étiquette mylabel à $/DinnerNow/Features/FeatureTeamB, alors l'étiquette mylabel s'appliquera aux deux dossiers.
Pour appliquer une étiquette à partir de la ligne de commande
Cliquez sur Démarrer, puis sur Tous les programmes, pointez sur Microsoft Visual Studio 2010, sur Visual Studio Tools, puis cliquez sur Invite de commandes de Visual Studio (2010).
Tapez cd CheminAccès, où CheminAccès représente le chemin d'accès que vous souhaitez étiqueter.
Tapez tf label mylabel . /recursive.
Le système applique l'étiquette mylabel à la version de l'espace de travail du dossier "CheminAccès" et à tous les fichiers et dossiers que cet espace contient.
Supprimer une étiquette à partir de la ligne de commande
Pour supprimer des étiquettes à partir de la ligne de commande
Cliquez sur Démarrer, puis sur Tous les programmes, pointez sur Microsoft Visual Studio 2010, sur Visual Studio Tools, puis cliquez sur Invite de commandes de Visual Studio (2010).
Tapez cd chemin d'accès, où chemin d'accès représente le répertoire qui contient l'espace de travail approprié.
Tapez tf label /deleteNomEtiquette, où NomEtiquette représente le nom de l'étiquette que vous souhaitez supprimer.
Voir aussi
Référence
Label, commande (contrôle de version Team Foundation)
Concepts
Utilisation d'ensembles de modifications
Créer un espace de travail pour utiliser le projet de votre équipe
Autorisations de Team Foundation Server
Utilisation de l'Explorateur du contrôle de code source