Checkin, commande
Mise à jour : novembre 2007
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:reasonfile|@reason] [/recursive] [/saved] [/validate]
[itemspec]
Paramètres
Argument |
Description |
|---|---|
authorname |
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. |
Option |
Description |
|---|---|
/author |
Identifie l'auteur des modifications en attente spécifiées ou implicites 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. Si on l'associe à /noprompt, l'option /saved archive les modifications avec les commentaires, etc., éventuellement enregistrés. |
/validate |
L'option /validate vous permet de tester l'archivage sans réellement y procéder. Lorsque l'option /validate est spécifiée, checkin évalue les stratégies d'archivage, vérifie les notes d'archivage et recherche les conflits sans réellement procéder à l'archivage. Les problèmes éventuels, tels que les conflits, sont identifiés par cette option et doivent être résolus avant d'archiver l'élément. |
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 est dite en attente tant qu'elle n'a pas été transmise pour archivage. Pour plus d'informations et pour obtenir une liste complète des modifications en attente dans 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.
.gif "Remarque") Remarque : |
|---|
Étant donné que vous pouvez archiver des modifications en attente à partir de la ligne de commande, il est possible que le menu contextuel Explorateur du contrôle de code source ne soit pas toujours synchronisé avec l'état 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 Comment : 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 de contrôle de version Team Foundation 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
Comment : archiver les modifications en attente
Concepts
Envoi de modifications au serveur du contrôle de version
Référence
Syntaxe de ligne de commande (Team System)