Label, commande (contrôle de version Team Foundation)
Mise à jour : novembre 2007
Joint une étiquette à une version d'un fichier ou dossier, ou la supprime, sur le serveur du contrôle de version Team Foundation.
Autorisations requises
Pour utiliser la commande label, vous devez disposer du jeu d'autorisations Étiqueter avec la valeur Autoriser. Pour modifier ou supprimer des étiquettes créées par d'autres utilisateurs, vous devez disposer du jeu d'autorisations Administrer les étiquettes avec la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
tf label [/server:servername] labelname[@scope] [/owner:ownername]
itemspec [/version:versionspec] [/comment:("comment"|@commentfile)]
[/child:(replace|merge)] [/recursive]
tf label [/server:servername] /delete labelname[@scope]
[/owner:ownername] itemspec [/version:versionspec]
Paramètres
Argument |
Description |
|---|---|
servername |
Valeur fournie par l'utilisateur pour l'option /server. Exemple : teamfoundation2. |
labelname |
Identifie le nom de l'étiquette à joindre aux éléments spécifiés, ou encore à modifier ou à supprimer. |
@scope |
Spécifie un répertoire de serveur de contrôle de version Team Foundation dans lequel le nom d'étiquette est unique. Ce paramètre vous permet de créer, gérer, récupérer et supprimer indépendamment une étiquette ou un jeu d'éléments étiquetés lorsque deux étiquettes du même nom se trouvent dans des parties différentes du serveur de contrôle de version Team Foundation. |
ownername |
Fournit à l'option /owner une valeur, telle que DOMAIN\JuanGo ou simplement juango. |
itemspec |
Identifie le fichier ou le dossier à partir duquel étiqueter, ré-étiqueter ou modifier. Pour plus d'informations sur la façon dont Team Foundation analyse les spécifications d'éléments afin de déterminer quels éléments se trouvent dans la portée, consultez Syntaxe de ligne de commande (Team System). |
versionspec |
Fournit une valeur, telle que c2, pour l'option /version. Pour plus d'informations sur la façon dont Team Foundation analyse une spécification de version afin de déterminer quels éléments se trouvent dans sa portée, consultez Syntaxe de ligne de commande (Team System). |
comment |
Commentaire fourni par l'utilisateur sur l'étiquette. |
@commentfile |
Chemin d'accès fourni par l'utilisateur d'un fichier sur disque contenant le commentaire à utiliser pour l'archivage. |
Option |
Description |
|---|---|
/server |
Identifie le serveur Team Foundation Server. Cette option est requise si la commande est appelée à partir d'un répertoire qui n'est pas mappé à un espace de travail. |
/owner |
Spécifie le nom de l'utilisateur propriétaire de l'étiquette. |
/version |
(Facultatif) Spécifie la version du fichier ou du dossier auquel l'étiquette doit être jointe, dans lequel elle doit être modifiée, ou duquel elle doit être supprimée. Ce sont des valeurs d'ensemble de modifications, par exemple C93. Par défaut, Team Foundation utilise la version d'espace de travail de base si aucune versionspec n'est fournie. |
/comment |
Ajoute ou modifie une description ou un commentaire pour l'étiquette. |
/child |
Indique comment traiter les éléments ayant des étiquettes préexistantes et identiques à l'étiquette que vous avez spécifiée. Utilisez Replace pour mettre à jour la version de l'élément correspondant à l'étiquette existante. Utilisez Merge pour laisser inchangés les éléments ayant l'étiquette existante. |
/recursive |
Étiquette tous les éléments du répertoire correspondant à vos arguments itemspec et versionspec. Ne peut pas être utilisé avec l'option /delete. |
/delete |
Supprime l'étiquette. |
Notes
Une étiquette est un marqueur que vous pouvez joindre à un jeu de fichiers et dossiers non liés dans le serveur du contrôle de version Team Foundation. Utilisez-la pour simplifier leur récupération dans un espace de travail à des fins de développement ou de génération. Une étiquette est donc semblable à un ensemble de modifications ou à un ensemble date/heure auquel vous pouvez ajouter ou duquel vous pouvez supprimer arbitrairement des fichiers et des dossiers, ou dont vous pouvez modifier les versions des éléments qu'ils contiennent. Une étiquette est une spécification de version qui peut être passée aux commandes Team Foundation suivantes :
Les types courants d'étiquettes sont des étiquettes de jalons telles que « J1 », « Bêta2 » ou « Version finale candidate (RC) 0 ».
Les étiquettes sont spécifiques à la version, ce qui signifie que vous ne pouvez les joindre qu'à une seule version d'un fichier ou d'un dossier. Chaque version d'un élément peut prendre en charge plusieurs étiquettes.
Une étiquette n'étant pas un objet soumis à versions, l'historique des étiquettes de fichiers n'est pas suivi. En outre, une opération d'étiquetage ne crée pas de modification en attente dans votre espace de travail. Lorsque vous émettez la commande label , la mise à jour est immédiatement reflétée dans le serveur du contrôle de version Team Foundation.
Pour plus d'informations sur la localisation de l'utilitaire en ligne de commande tf, consultez Commandes de l'utilitaire en ligne de commande Tf.
Retrait et suppression d'étiquettes
Vous pouvez utiliser la Unlabel, commande pour supprimer une étiquette d'un fichier ou d'un dossier. Vous pouvez également supprimer une étiquette du système à l'aide de la commande tf label /delete.
Pour plus d'informations sur une étiquette existante, avec une liste des éléments auxquels elle a été jointe, son commentaire, sa portée et son propriétaire, consultez Labels, commande.
Gestion d'étiquettes surchargées
Les noms d'étiquettes doivent être uniques dans toute une portée spécifiée. Lorsque vous ajoutez une étiquette, vous réservez l'utilisation de son nom à ou au sein de la portée spécifiée ou implicite. La valeur par défaut pour le paramètre @scope est le projet d'équipe, par exemple, $/TeamProject1.
Si une autre équipe ou un autre utilisateur ajoute une étiquette commune, par exemple "J3", à un jeu de fichiers sous contrôle de version dans une partie différente du serveur de contrôle de version Team Foundation, vous pouvez appliquer l'étiquette J3 aux fichiers sous contrôle de version de votre projet à condition que les dossiers racine des projets se trouvent dans des répertoires différents. Par exemple, si des fichiers du répertoire $/math sont étiquetés « J3 », vous pouvez appliquer « J3 » aux fichiers de votre propre répertoire $/projets.
Pour obtenir, supprimer une étiquette, ou de façon générale gérer vos éléments étiquetés J3, vous devez spécifier le paramètre de portée @scope pour indiquer à Team Foundation l'étiquette J3 que vous souhaitez utiliser.
Vous pouvez empêcher d'autres utilisateurs de "surcharger" une étiquette telle que "J3" dans différentes parties du serveur de contrôle de version Team Foundation en créant votre étiquette à la racine ($/) du serveur de contrôle de version Team Foundation ou en ajustant les autorisations d'étiquetage pour certains dossiers.
Utilisation de l'option /child pour éviter les problèmes d'étiquetage
Si vous émettez une commande label avec un nom d'étiquette préexistant et une itemspec qui comprend des fichiers portant déjà la même étiquette, la valeur de l'option /child détermine si les fichiers marqués seront mis à jour avec les nouvelles informations de révision. Autrement dit, les fichiers sont étiquetés avec le même nom, mais ont une portée différente.
Supposez, par exemple, que vous ayez un dossier nommé c:\projects contenant deux fichiers, 314.cs et 271.cs. Supposez également que la version C70 de 314.cs soit étiquetée "prêt". La version la plus récente de 314.cs est la version C93. Si vous appliquez une étiquette "prêt" à la version la plus récente du dossier et aux fichiers qu'il contient à l'aide de la commande suivante, l'étiquette "prêt" est déplacée de 314.cs;C70 vers 314.cs;C93 :
tf label ready c:\projects /recursive /version:T /child:Replace
En revanche, si vous ne souhaitez pas déplacer l'étiquette "prêt" existante de la version C70 vers la version C93 de 314.cs, vous utiliserez la syntaxe suivante :
tf label ready c:\projects /recursive /version:T /child:Merge
Lorsque vous spécifiez Merge comme valeur de l'option /child, les instances préexistantes de l'étiquette émise restent inchangées.
.gif "Remarque") Remarque : |
|---|
T, qui désigne « Tip », est utilisé pour obtenir la version la plus récente de versionspec dans les deux exemples précités. |
Exemples
L'exemple suivant joint l'étiquette "goodbuild" à la version d'espace de travail du dossier "documents" et aux fichiers et dossiers qu'il contient.
c:\projects>tf label goodbuild docs /recursive
L'exemple suivant joint l'étiquette "goodbuild" au dossier "documents", mais pas aux fichiers et dossiers que celui-ci contient.
c:\projects>tf label goodbuild docs
L'exemple suivant joint l'étiquette "goodbuild" à la version 3 de 314.cs sur le serveur de contrôle de version Team Foundation.
c:\projects>tf label goodbuild /version:3 $/src/314.cs
L'exemple suivant supprime l'étiquette "badbuild" de tous les éléments du serveur de contrôle de version Team Foundation.
c:\projects>tf label /delete badbuild
L'exemple suivant utilise l'option de portée pour appliquer une étiquette à 314.cs.
c:\projects>tf label goodbuild@$/TeamProject1 314.cs
Voir aussi
Tâches
Procédure pas à pas : fonctionnalités avancées du contrôle de version
Comment : appliquer des étiquettes
Concepts
Référence
Syntaxe de ligne de commande (Team System)