Utiliser des étiquettes pour prendre un instantané de vos fichiers

  • Article

Les étiquettes vous permettent de prendre un instantané de vos fichiers pour qu'à une date ultérieure vous puissiez faire référence à cet instantané. 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

  • Travailler depuis l'invite de commandes

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 build, 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

Conseil

Lorsque vous utilisez Visual Studio 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.Consultez Label Command.

Appliquer une étiquette

  1. Dans l'Explorateur du contrôle de code source, ouvrez le menu contextuel de la collection, du projet d'équipe, de la branche, du dossier ou du fichier auquel vous souhaitez appliquer une étiquette et choisissez Avancé, Appliquer une étiquette.

    La boîte de dialogue Nouvelle étiquette s'affiche.

  2. Dans la zone Nom, tapez un nom pour l'étiquette.

  3. (Facultatif) Tapez vos commentaires dans la zone Commentaire.

  4. 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 vous avez besoin que l'étiquette cible une version spécifique, sélectionnez :

    • Ensemble de modifications : 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 et afficher des ensembles de modifications.

    • Date : spécifiez une date dans la zone Date ou sélectionnez une date dans le calendrier du menu déroulant.

    • Étiquette : 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.

    • Version de l'espace de travail : cette étiquette est créée pour la version de votre espace de travail.

  5. Lorsque les paramètres vous conviennent, exécutez l'une des étapes suivantes :

    • Pour appliquer l'étiquette, choisissez Créer.

    • Pour appliquer l'étiquette et la modifier après qu'elle a été appliquée, 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

  1. Dans l'Explorateur du contrôle de code source, ouvrez le menu contextuel du nœud de collection de projets (nœud racine), puis choisissez Avancé, Appliquer une étiquette.

    La boîte de dialogue Nouvelle étiquette s'affiche.

  2. Dans la zone Nom, tapez un nom pour l'étiquette.

  3. (Facultatif) Dans la zone Commentaire, tapez un commentaire.

  4. Dans la liste Version, sélectionnez Étiquette.

    La zone Étiquette s'affiche.

  5. 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.)

  6. Choisissez Créer.

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

  1. Dans l'Explorateur du contrôle de code source, dans la barre de menus, choisissez Fichier, Contrôle de code source, Rechercher, Rechercher une étiquette.

    La boîte de dialogue Rechercher une étiquette s'affiche.

  2. (Facultatif) Affinez votre recherche en exécutant une ou plusieurs des étapes suivantes :

    • Dans la zone de texte Nom, tapez 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.

  3. Choisissez Rechercher.

    La liste Résultats affiche des étiquettes qui correspondent aux critères de recherche que vous avez entrés.

  4. (Facultatif) Effectuez l'une des étapes suivantes :

    • Pour afficher ou modifier une étiquette, sélectionnez-la et choisissez 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 choisissez Supprimer.

    • Sélectionnez 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

  1. Dans l'Explorateur de contrôle de source, ouvrez le menu contextuel de l'élément auquel vous souhaitez appliquer l'étiquette que vous cherchez, puis choisissez Afficher l'historique.

    La fenêtre Historique s'affiche.

  2. Choisissez l'onglet Étiquettes pour afficher la liste des étiquettes qui s'appliquent à cet élément.

  3. (Facultatif) Effectuez l'une des étapes suivantes :

    • Pour afficher ou modifier une étiquette, ouvrez le menu contextuel et choisissez Modifier une é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, ouvrez son menu contextuel et choisissez Supprimer l'étiquette.

    • Ouvrez le menu contextuel de l'étiquette et choisissez d'autres actions telles que Obtenir cette version et Comparer.

Pour plus d'informations sur l'utilisation de l'onglet Étiquette de la fenêtre Historique, consultez Obtenir l'historique d'un élément.

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

  1. Dans l'Explorateur de contrôle du code source, ouvrez le menu contextuel de la collection de projets, du projet d'équipe, de la branche ou du dossier qui contient les éléments que vous souhaitez télécharger, puis choisissez Avancé, Obtenir une version spécifique.

    La boîte de dialogue Obtenir apparaît.

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

  3. Passez en revue et sélectionnez les options supplémentaires appropriées dans la boîte de dialogue Obtenir.

  4. Choisissez 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

  1. Dans la fenêtre Étiquette, choisissez Ajouter un élément.

    La boîte de dialogue Choisir la version de l'élément s'affiche.

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

  3. (Facultatif) Si l'étiquette doit cibler une version spécifique, dans la liste Version, sélectionnez :

    • Dernière version : l'étiquette sera appliquée à la version la plus récente du contrôle de version.

    • Ensemble de modifications : 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 et afficher des ensembles de modifications.

    • Date : spécifiez une date dans la zone Date ou sélectionnez une date dans le calendrier du menu déroulant.

    • Étiquette : 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.

    • Version de l'espace de travail : cette étiquette est créée pour la version de votre espace de travail.

  4. Cliquez sur OK.

  5. Choisissez Fichier, Enregistrer.

Supprimer un élément de l'étiquette

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

  2. Ouvrez le menu contextuel de l'élément, et choisissez 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.

  3. Choisissez Fichier, Enregistrer.

Modifier la version d'un fichier

  1. Dans la fenêtre Étiquette, localisez le fichier que vous souhaitez modifier.

  2. Ouvrez le menu contextuel du fichier et choisissez Modifier la version étiquetée.

  3. La boîte de dialogue Modifier la version étiquetée s'affiche.

  4. Sélectionnez :

    • Dernière version : appliquez l'étiquette à la version la plus récente du contrôle de version.

    • Ensemble de modifications : 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 et afficher des ensembles de modifications.

    • Date : spécifiez une date dans la zone Date ou sélectionnez une date dans le calendrier du menu déroulant.

    • Étiquette : 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.

    • Version de l'espace de travail : cette étiquette est créée pour la version de votre espace de travail.

  5. Choisissez Fichier, Enregistrer.

Exécuter d'autres actions sur un élément étiqueté

Lorsque vous ouvrez le menu contextuel d'un élément dans la fenêtre Étiquette, vous pouvez également sélectionner l'une des commandes suivantes :

Travailler depuis l'invite de commandes

  • Label Command Appliquer ou supprimer une étiquette.

    Conseil

    Lorsque vous utilisez cette commande pour appliquer une étiquette, vous pouvez spécifier une portée différente du projet d'équipe.

  • Labels Command Répertoriez les étiquettes.

Voir aussi

Concepts

Rechercher et afficher des ensembles de modifications

Créer et utiliser des espaces de travail

Référence des autorisations pour Team Foundation Server

Utiliser l'Explorateur du contrôle de code source pour gérer les fichiers sous contrôle de version

Autres ressources

Utiliser les branches pour isoler le risque dans le contrôle de version Team Foundation