Checkin, commande

  • Article

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

La commande TFVC checkin vérifie les modifications apportées au fichier et au dossier en attente sur le serveur.

Presque toutes les modifications apportées aux fichiers sur votre ordinateur de développement sont stockées dans votre espace de travail en tant que modifications en attente jusqu’à leur archivage. Lorsque vous archivez vos modifications, celles-ci sont stockées sur le serveur en tant qu'ensemble de modifications. La commande checkin fournit une interface utilisateur différente pour effectuer les mêmes processus documentés de Visual Studio dans Archiver votre travail dans le codebase de l’équipe.

Conseils

  • Pour mettre de côté les modifications ou nettoyer votre espace de travail en vue d’une autre tâche, utilisez la commande Réserver.

  • Si des conflits bloquent votre case activée-in, vous pouvez utiliser la commande Résoudre pour les résoudre.

  • Si un ordinateur et un compte d’utilisateur n’ont aucun espace de travail mappé vers la collection de projets contenant l’ensemble d’étagères, vous pouvez utiliser les options /shelveset et /collection pour archiver un ensemble d’étagères.

Prérequis

Syntaxe

tf checkin [/author:author name] [/comment:("comment"|@comment file)] 
[/noprompt] [/notes:("Note Name"="note text"|@notefile)] 
[/override:(reason|@reasonfile)] [/recursive] [/saved] [/validate] [itemspec] [/bypass] [/force] [/noautoresolve] [/login:username,[password]] [/new]

tf checkin /shelveset:shelvesetname[;shelvesetowner] [/bypass] [/noprompt] [/login:username,[password]] [/collection:TeamProjectCollectionUrl][/author:author name] [/force]

Paramètres

Paramètre

Description

/author:<author name>

Identifie l’auteur des modifications en attente afin qu’un utilisateur puisse enregistrer des modifications au nom d’un autre utilisateur.

Nécessite l’autorisation CheckinOther. Consultez Référence sur les autorisations et les groupes.

/bypass

Contourne une exigence d’archivage contrôlé. Pour plus d’informations, consultez Archiver dans un dossier contrôlé par un processus de création d’archivage contrôlé.

/collection:<ProjectCollectionUrl>

Lorsque vous utilisez shelveset, l’option /collection spécifie l'URL de la collection du projet contenant le jeu de réservations. Par exemple : http://myserver:8080/tfs/DefaultCollection.

Par défaut, la collection de projets d'équipe est présumée être celle contenant l'espace de travail qui mappe le répertoire actif.

/comment

Associe un commentaire à l’ensemble de modifications à l’aide de l’un des arguments suivants :

  • "<comment>": commentaire fourni par l’utilisateur concernant l’archivage.
  • @<comment file>: chemin d’accès à un fichier sur le disque contenant le commentaire pour l’archivage.

/force

Force un archivage des éléments avec des modifications en attente, et ce bien qu’il n’y ait aucune modification de contenu dans le fichier.

<itemspec>

Spécifie l’étendue des éléments à archiver à partir de l’espace de travail de l’utilisateur. Vous pouvez spécifier plusieurs arguments itemspec. Pour obtenir la syntaxe, consultez Utiliser les commandes de contrôle de version Équipe Foundation.

/login:<username>[,<password>]

Spécifie le compte d'utilisateur pour exécuter la commande. Consultez Utiliser les commandes de contrôle de version Équipe Foundation.

/new

État sélectionné de chaque modification en attente, comme indiqué dans la boîte de dialogue Archiver. Le commentaire, les éléments de travail associés, les notes de d’archivage et le motif de remplacement de la stratégie d’archivage sont stockés sur votre machine de développement en tant que modifications en attente jusqu’à leur archivage. L’option /new désactive ces métadonnées d’archivage avant d’archiver. Cette option et le comportement qu’elle modifie n’ont aucun effet lorsque vous utilisez l’option /noprompt.

/noautoresolve

Par défaut, le système tente automatiquement de résoudre les conflits AutoResolve All. Spécifiez cette option pour désactiver ce comportement par défaut. Pour plus d’informations, consultez Résoudre les conflits Team Foundation Version Control.

/noprompt

Supprime l'affichage des fenêtres et des boîtes de dialogue, telles que la boîte de dialogue Archiver, et redirige les données de sortie vers l'invite de commandes. Consultez Utiliser les commandes de contrôle de version Équipe Foundation.

/notes

Fournit une ou plusieurs notes d’archivage à associer à l’ensemble de modifications, ceci à l’aide de l’un des arguments suivants :

  • <NoteFieldName>=<NoteFieldValue>: définit la valeur du champ de note d’archivage. Vous pouvez fournir plusieurs expressions séparées par des points-virgules field=value.
  • @<NoteFile>: le chemin d’accès fourni par l’utilisateur d’un fichier sur disque contenant les noms et valeurs des champs des notes d’archivage au format field=value. Une vignette de note séparée par un point-virgule peut s’étendre sur plusieurs lignes, par exemple :

    <Field1>=<Value1>;
    <Field2>=<First line of Value2>;
    <Second line of Value2>;
    <Field3>=<Value3>;

/override

Remplace une stratégie d’archivage à l’aide de l’un des arguments suivants :

  • reason: raison fournie par l’utilisateur pour laquelle la stratégie d’archivage est ignorée.
  • reasonfile: chemin d’accès vers un fichier contenant une description fournie par l’utilisateur de la raison pour laquelle la stratégie d’archivage est ignorée.

/recursive

Ajoute de manière récursive tous les éléments dans le répertoire spécifié et ses sous-répertoires.

/saved

Ignorez ce paramètre.

/shelveset:<shelvesetname>[;<owner>]

Spécifie un ensemble d’étagères pour l’archivage. L’argument facultatif owner spécifie un ensemble d’étagères que l’utilisateur actuel ne possède pas.

Notes

Une fois archivé dans le jeu de réservations, le système le supprime.

/validate

Teste si l’archivage a réussi, sans vérifier les fichiers. Le système évalue les stratégies d’archivage, les note et répertorie les conflits.

Notes

Si vous ne spécifiez pas l’option/noprompt, vous devez sélectionner le bouton Archiver dans la boîte de dialogue Archiver pour valider l’archivage. Une fois sélectionné ce bouton, le système n’archive pas les fichiers.

Exemples

Les exemples suivants supposent que c:\code\SiteApp\Main est le dossier principal mappé vers la collection de projets dans l’espace de travail de l’utilisateur.

Archivez toutes les modifications en attente dans l’espace de travail actuel

La commande suivante affiche la boîte de dialogue Archiver, présentant toutes les modifications en attente dans l’espace de travail actuel. Vous pouvez utiliser la boîte de dialogue Archiver pour sélectionner ou effacer les modifications en attente ceci, pour les archiver, y ajouter un commentaire, associer des éléments de travail et effectuer d’autres tâches, puis choisir le bouton PointArchiver une fois prêt à continuer.

c:\code\SiteApp\Main>tf checkin

Archivez toutes les modifications en attente avec un commentaire

L’exemple suivant vérifie toutes les modifications en attente dans l’espace de travail actuel et fournit un commentaire pour aider vos collègues à comprendre l’objectif de vos modifications.

c:\code\SiteApp\Main>tf checkin /comment:"Re-implemented Pi calculator"

Archivez une modification d’un élément unique sans utiliser la boîte de dialogue Archiver

L’exemple suivant vérifie les modifications en attente de program.cs. La boîte de dialogue Archiver ne s’affiche pas et si des conflits bloquent l’archivage, le système n’affiche pas la fenêtre des conflits.

c:\code\SiteApp\Main>tf checkin program.cs /noprompt