Checkin, commande
Valide les modifications en attente dans l'espace de travail actuel vers le serveur de contrôle de version Team Foundation.
Autorisations requises
Pour utiliser la commande checkin, vous devez disposer de l'autorisation Archiver avec la valeur Autoriser. Pour utiliser l'option /author, vous devez disposer de l'autorisation Archiver les modifications des autres utilisateurs avec la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
tf checkin [/author:author name] [/comment:("comment"|@comment file)]
[/noprompt] [/notes:("Note Name"="note text"|@notefile)]
[/override:(reason|@reasonfile)] [/recursive] [/saved] [/validate] [itemspec] [/bypass] [/login:username,[password]]
tf checkin /shelveset:shelvesetname[;shelvesetowner] [/bypass] [/noprompt] [/login:username,[password]] [/collection:TeamProjectCollectionUrl][/author:author name] [/force]
Paramètres
Argument |
Description |
|---|---|
author name |
Valeur fournie par l'utilisateur pour l'option /author. |
comment |
Commentaire fourni par l'utilisateur sur l'archivage. |
@comment file |
Chemin d'accès, fourni par l'utilisateur, d'un fichier sur disque contenant le commentaire sur l'archivage. |
NoteFieldName=NoteFieldValue |
Définit la valeur du champ de la note d'archivage. Vous pouvez fournir plusieurs expressions "field=value" séparées par un point-virgule. |
Notefile |
Chemin d'accès, fourni par l'utilisateur, d'un fichier sur disque contenant les noms et les valeurs du champ de la note d'archivage, au format "field=value". Une mosaïque de notes séparées par un point-virgule peut couvrir plusieurs lignes, par exemple : field1=value1; field2=value qui couvre plusieurs lignes;. |
Reasonfile |
Description fournie par l'utilisateur de la raison pour laquelle la stratégie d'archivage est ignorée. Si une raison est spécifiée, une notification de la substitution de stratégie est transmise, avec cette explication, aux administrateurs Team Foundation par messagerie électronique. |
itemspec |
Spécifie un fichier ou un dossier à archiver. Pour plus d'informations sur la façon dont Team Foundation analyse une spécification de fichier afin de déterminer quels éléments se trouvent dans sa portée, consultez Options de ligne de commande. |
username |
Fournit une valeur pour l'option /login. Vous pouvez spécifier une valeur de nom d'utilisateur comme DOMAINE\NomUtilisateur ou NomUtilisateur. |
shelvesetname [:owner] |
Identifie le jeu de réservations que vous souhaitez archiver. L'argument owner facultatif est utilisé pour spécifier un jeu de réservations qui n'appartient pas à l'utilisateur actuel. |
TeamProjectCollectionUrl |
URL de la collection de projets d'équipe qui contient les fichiers ou les dossiers que vous souhaitez archiver (par exemple, http://myserver:8080/tfs/DefaultCollection). |
Option |
Description |
|---|---|
/author |
Identifie l'auteur des modifications en attente afin qu'un utilisateur puisse archiver des modifications au nom d'un autre utilisateur. Requiert l'autorisation CheckinOther. |
/comment |
Associe un commentaire à l'ensemble de modifications. |
/noprompt |
Supprime les invites de saisie. |
/notes |
Fournit une ou plusieurs notes d'archivage à associer à l'ensemble de modifications. |
/override |
Vous permet de substituer une défaillance de stratégie d'archivage. Cette option n'est nécessaire que lorsqu'il existe une stratégie d'archivage et que vous souhaitez néanmoins archiver. |
/recursive |
Archive tous les éléments dans le dossier de travail spécifié ou implicite et ses sous-dossiers. |
/saved |
Lorsqu'un archivage échoue ou est annulé par l'utilisateur, ou lorsqu'un utilisateur déréserve des modifications, la sélection de modifications, de commentaires, d'éléments de travail, de remarques d'enregistrement et, le cas échéant, la raison de substituer la stratégie de l'enregistrement, sont stockées sur l'ordinateur. En cas de combinaison avec /noprompt, l'option /saved archive les modifications avec le commentaire, etc. éventuellement enregistrés. |
/validate |
L'option /validate vous permet de tester l'archivage sans réellement y procéder. Les options /validate font que l'archivage évalue les stratégies d'archivage, vérifie les notes d'archivage et recherche des conflits sans réellement archiver. Tous problèmes, tels que les conflits, qui sont identifiés par cette option doivent être résolus avant d'archiver l'élément. |
/bypass |
Ignore une spécification d'archivage contrôlé. Pour plus d'informations, consultez Archiver des modifications en attente contrôlées par une build d'archivage contrôlé. |
/login |
Spécifie le nom d'utilisateur et le mot de passe pour authentifier l'utilisateur avec Visual Studio Team Foundation Server. |
/shelveset |
Spécifie le jeu de réservations par nom. |
/collection |
Spécifie la collection du projet d'équipe. |
Notes
Une modification en attente se compose d'un ajout, d'une suppression, d'un changement de nom, d'une modification, d'une création de branche, d'une annulation de suppression ou d'un filetype appliqués à un fichier ou un dossier. Certaines d'entre elles, telles que la modification ou le changement de nom, peuvent s'appliquer en même temps à un élément seul. Une modification en attente est une modification qui n'a pas été envoyée pour l'archivage. Pour plus d'informations et obtenir la liste complète des modifications en attente de Team Foundation, consultez Modifications en attente.
La commande checkin crée un ensemble de modifications sur le serveur de contrôle de version Team Foundation à partir d'un jeu défini dynamiquement de modifications en attente, d'éléments de travail, de commentaires définis par l'utilisateur et de métadonnées système. Elle rend également vos modifications accessibles à d'autres utilisateurs. D'autres utilisateurs peuvent utiliser la commande get pour récupérer vos modifications. Les commandes history et changeset affichent les informations d'ensemble de modifications relatives aux modifications que vous avez transmises.
Notes
Comme vous pouvez archiver des modifications en attente à partir de la ligne de commande, le menu contextuel Explorateur du contrôle de code source ne pourrait pas toujours refléter le statut des modifications en attente.
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.
Le processus d'archivage
L'opération d'archivage est de nature atomique, ce qui signifie qu'elle réussit totalement ou qu'elle échoue totalement. Si l'une des modifications figurant dans la liste des modifications en attente ne peut pas être soumise au serveur de contrôle de version Team Foundation, aucune d'entre elles n'est validée et aucun ensemble de modifications n'est créé. Par exemple, si la connexion réseau s'interrompt au milieu de l'opération, l'opération tout entière échoue.
La première étape du processus d'archivage consiste à évaluer la conformité des modifications en attente avec les stratégies d'archivage. Vous pouvez substituer les défaillances de la stratégie d'archivage sur la ligne de commande à l'aide de l'option /override . Vous devez fournir une raison expliquant pourquoi les défaillances de la stratégie sont substituées. Cette raison persiste sur le serveur de contrôle de version Team Foundation et devient un attribut de l'ensemble de modifications validé. L'option /override a été initialement prévue pour être utilisée dans des scripts. Pour plus d'informations, consultez Substituer une stratégie d'archivage.
Si une version de base d'un élément de la liste des modifications en attente diffère de la version la plus récente du serveur de contrôle de version Team Foundation, Team Foundation vous invite à résoudre d'abord les conflits entre votre version de contrôle de version Team Foundation et la version plus récente. Par exemple, si vous avez extrait la version 4 de stellar.cs et que la version la plus récente du serveur de contrôle de version Team Foundation est désormais la version 6, vous êtes invité à résoudre les conflits. À moins que l'option **/noprompt ** ne soit spécifiée, la boîte de dialogue Résoudre apparaît pour vous aider à étudier et à résoudre les différences entre versions. Après avoir résolu les différences et testé à nouveau votre code, vous pouvez tenter une nouvelle fois d'archiver vos modifications.
Exemples
L'exemple suivant affiche la boîte de dialogue Archiver qui contient des modifications en attente présélectionnées pour une opération d'archivage en bloc de toutes les modifications en attente dans l'espace de travail mappé à c:\projects. Si vous cliquez sur Archiver, chaque élément est soumis individuellement à un ensemble de modifications sur le serveur de contrôle de version Team Foundation, et fait l'objet d'une évaluation visant à s'assurer que la version du serveur est inchangée parce que l'élément a été extrait. Si l'archivage réussit, Team Foundation crée un ensemble de modifications et affiche son numéro pour s'y référer ultérieurement.
c:\projects>tf checkin
L'exemple suivant transmet au serveur de contrôle de version Team Foundation toutes les modifications en attente dans l'espace de travail actuel, avec le commentaire spécifié, en vue de créer un nouvel ensemble de modifications.
c:\projects>tf checkin /comment:"Re-implemented Pi calculator" /noprompt
L'exemple suivant soumet les modifications en attente apportées à 314.cs et laisse en attente toutes les autres révisions dans l'espace de travail actuel.
c:\projects>tf checkin 314.cs /noprompt
Voir aussi
Tâches
Procédure pas à pas : personnalisation des stratégies et notes d'archivage
Archiver des modifications en attente
Référence
Syntaxe de ligne de commande (Contrôle de version)