Utiliser des étiquettes pour prendre un instantané de vos fichiers (Team Explorer Everywhere)

Les étiquettes vous permettent de prendre un instantané de vos fichiers pour que vous puissiez utiliser cet instantané par la suite. En utilisant une é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.

Lorsque vous générez votre application à l'aide de Team Foundation Build, les fichiers dans votre application sont, par défaut, étiquetés automatiquement avec le numéro de build dans le cadre du processus de génération.

Dans cette rubrique

• Utilisations des étiquettes

• Appliquer une étiquette

• Renommer une étiquette

• Répertorier, rechercher, afficher, modifier et supprimer des étiquettes

• Récupérer des versions étiquetées des fichiers dans votre espace de travail

• Modifier une définition d'é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. Pour plus d'informations, consultez la rubrique suivante sur le site Web Microsoft : Autorisations Team Foundation Server.

Utilisations des étiquettes

Dans de nombreux projets de logiciels, l'équipe génère et diffuse une nouvelle version du produit lorsque le code a atteint un niveau raisonnable de qualité et de stabilité. L'équipe doit marquer la version actuelle de chaque fichier pour pouvoir obtenir et générer la version finale 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 genre de processus n'est clairement pas pratique. Vous pouvez utiliser le contrôle de version Team Foundation pour simplifier 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. Les chaînes suivantes sont quelques exemples de noms d'étiquettes : « 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.

Après avoir appliqué une étiquette, vous pouvez décider de modifier les fichiers auxquels elle s'applique. Le 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.

Appliquer une étiquette

Lorsque vous utilisez le Plug-in Team Foundation Server pour Eclipse 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. Toutefois, l'opération d'étiquette est additive lorsque vous utilisez le Client de ligne de commande interplateforme pour Team Foundation Server. Par exemple, vous pouvez appliquer l'étiquette MyLabel à $/DinnerNow/Features/FeatureTeamA. Si vous appliquez par la suite cette étiquette à $/DinnerNow/Features/FeatureTeamB, alors l'étiquette MyLabel s'appliquera aux deux dossiers.

Pour appliquer une étiquette à partir de l'Explorateur du contrôle de code source

1. Ouvrez l'Explorateur du contrôle de code source.

   Pour plus d'informations, consultez Ouvrir l'Explorateur du contrôle de code source.

2. Dans l'Explorateur du contrôle de code source, cliquez avec le bouton droit sur la collection de projets d'équipe, le projet d'équipe, la branche, le dossier ou le fichier auquel vous souhaitez appliquer une étiquette et cliquez sur Appliquer l'étiquette.

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

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

4. (Facultatif) Dans la zone Commentaire, tapez vos commentaires.

   Dans la liste Version, la valeur par défaut est Dernière version, qui est la plus fréquemment utilisée.

5. (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 Ensemble de modifications, vous pouvez spécifier le numéro de l'ensemble de modifications dans la zone Ensemble de modifications. Vous pouvez également cliquer sur le bouton de sélection (...) pour ouvrir la boîte de dialogue Rechercher les ensembles de modifications.

     Pour plus d'informations, consultez Search for a Changeset.

   • Si vous cliquez sur Date, vous pouvez spécifier une date dans la zone Date ou spécifier une date du calendrier dans le 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 l'é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.

6. 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 spécifiez Continuer la modification. L'étiquette est alors appliquée, puis la fenêtre Nouvelle étiquette s'affiche. Cette fenêtre exécute les mêmes fonctions que la fenêtre Modifier une étiquette. Pour plus d'informations sur l'utilisation de la fenêtre Modifier une étiquette pour modifier une étiquette, consultez Modifier une définition d'étiquette.

Pour appliquer une étiquette à partir d'une invite de commandes

• À l'invite de commandes, tapez tf label Label ItemSpec, puis appuyez sur Entrée. Remplacez Label par le nom que vous souhaitez utiliser pour étiqueter les fichiers. Remplacez ItemSpec par le fichier que vous souhaitez étiqueter. Si vous souhaitez étiqueter tout le contenu d'un dossier, tapez tf label Label . -recursive.

  Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : Label, commande (contrôle de version Team Foundation) (page éventuellement en anglais).

Renommer une étiquette

Vous ne pouvez pas modifier le nom d'une étiquette existante, mais vous pouvez en revanche appliquer une étiquette différente aux fichiers et aux versions auxquels une autre étiquette s'applique.

Pour appliquer une étiquette basée sur une étiquette existante dans l'Explorateur du contrôle de code source

1. Ouvrez l'Explorateur du contrôle de code source.

   Pour plus d'informations, consultez Ouvrir l'Explorateur du contrôle de code source.

2. 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 l'étiquette.

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

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

4. (Facultatif) Dans la zone Commentaire, tapez vos commentaires.

5. Dans la liste Version, cliquez sur Étiquette.

   La zone Étiquette s'affiche.

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

7. Cliquez sur Créer.

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

Dans le Plug-in Team Foundation Server pour Eclipse, vous devez utiliser la boîte de dialogue Rechercher l'étiquette pour répertorier et rechercher une étiquette. Une fois que vous avez trouvé l'étiquette voulue, vous pouvez la consulter, la modifier, la supprimer ou utiliser les fichiers auxquels elle s'applique.

Pour répertorier des étiquettes à l'aide de la boîte de dialogue Rechercher l'étiquette

1. Ouvrez l'Explorateur du contrôle de code source.

   Pour plus d'informations, consultez Ouvrir l'Explorateur du contrôle de code source.

2. Dans l'Explorateur du contrôle de code source, cliquez avec le bouton droit sur un nœud, puis cliquez sur Rechercher l'étiquette.

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

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

   • Dans la zone 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 Propriétaire, tapez le nom ou l'alias du propriétaire de l'étiquette.

4. Cliquez sur Rechercher.

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

5. (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 Modifier une définition d'étiquette.

   • Pour supprimer une étiquette, sélectionnez-la et cliquez sur Supprimer.

   • Cliquez sur Fermer.

Pour répertorier des étiquettes à partir d'une invite de commandes

1. À l'invite de commandes, accédez au répertoire du dossier qui correspond à l'espace de travail Team Foundation Server pour lequel vous souhaitez consulter des étiquettes.

2. Tapez tf labels, puis appuyez sur Entrée.

   Une liste des étiquettes dans l'espace de travail Team Foundation Server actuel s'affiche. Vous pouvez spécifier l'option -format:detailed pour afficher plus d'informations sur les étiquettes. Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : Labels, commande (contrôle de version Team Foundation) (page éventuellement en anglais).

Pour supprimer une étiquette à partir d'une invite de commandes

1. À l'invite de commandes, accédez au répertoire du dossier qui correspond à l'espace de travail Team Foundation Server dans lequel vous souhaitez supprimer une étiquette.

2. Tapez tf label –delete Label, puis appuyez sur Entrée.

   Remplacez Label par le nom de l'étiquette que vous souhaitez supprimer. Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : Label, commande (contrôle de version Team Foundation) (page éventuellement en anglais).

Récupérer des versions étiquetées des fichiers dans votre espace de travail

Si vous étiquetez un ensemble de fichiers, vous créez un instantané des fichiers à un moment donné. Des semaines ou des mois après avoir pris cet instantané, vous voudrez peut-être afficher ou 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.

Pour récupérer des versions étiquetées des fichiers

1. Ouvrez l'Explorateur du contrôle de code source.

   Pour plus d'informations, consultez Ouvrir l'Explorateur du contrôle de code source.

2. Dans l'Explorateur du contrôle de code source, cliquez avec le bouton droit sur la collection, 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.

3. Dans la liste Type, sélectionnez Étiquette, puis 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 l'étiquette.

   Pour plus d'informations sur l'utilisation de cette boîte de dialogue, consultez Répertorier, rechercher, afficher, modifier et supprimer des étiquettes.

4. Passez en revue et, le cas échéant, sélectionnez les options supplémentaires appropriées dans la boîte de dialogue Obtenir.

5. Cliquez sur Obtenir.

Pour récupérer des versions étiquetées des fichiers à partir d'une invite de commandes

1. À l'invite de commandes, accédez au répertoire du dossier qui correspond à l'espace de travail Team Foundation Server pour lequel vous souhaitez récupérer des fichiers.

2. Tapez tf get /version:LLabel ItemSpec, puis appuyez sur Entrée. Remplacez Label par le nom de l'étiquette que vous souhaitez récupérer. Remplacez ItemSpec par le nom du dossier ou fichier que vous souhaitez récupérer. Vous pouvez omettre ItemSpec pour récupérer tous les éléments qui ont l'étiquette que vous avez spécifiée.

   Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : Get, commande (contrôle de version Team Foundation) (page éventuellement en anglais).

Modifier une définition d'étiquette

Après avoir ouvert la fenêtre Modifier une é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 :

• Appliquer un élément à l'étiquette.

• Supprimer l'étiquette d'un élément.

Pour modifier la version d'un fichier étiqueté, vous devez supprimer l'étiquette de ce fichier et la réappliquer à la version que vous souhaitez utiliser.

Pour appliquer l'étiquette à un élément

1. Dans la fenêtre Modifier une étiquette, cliquez sur Ajouter.

2. Dans la boîte de dialogue Sélectionner l'élément à étiqueter, recherchez et sélectionnez l'élément auquel vous souhaitez appliquer l'étiquette.

3. (Facultatif) Dans la liste Version, vous pouvez sélectionner l'une des options suivantes si vous souhaitez appliquer l'étiquette à une version spécifique :

   • 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 également 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 un ensemble de modifications.

   • Si vous cliquez sur Date, vous pouvez spécifier une date dans la zone Date ou spécifier une date du calendrier dans le 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 l'é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 Team Foundation Server.

4. Cliquez sur OK à deux reprises pour accepter les modifications de l'étiquette.

Pour supprimer une étiquette d'un élément.

1. Dans la fenêtre Modifier une étiquette, cliquez sur la collection, le projet d'équipe, la branche, le dossier ou le fichier dans lequel vous souhaitez supprimer cette étiquette.

2. Cliquez sur Supprimer.

   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. Cliquez sur OK pour accepter les modifications de l'étiquette.

Voir aussi

Autres ressources

Utilisation du contrôle de version (Team Explorer Everywhere)

Utilisation d'ensembles de modifications (Team Explorer Everywhere)

Utilisation d'espaces de travail Team Foundation Server (Team Explorer Everywhere)