Checkin (Comando)
Confirma los cambios pendientes del área de trabajo actual en el servidor de control de versiones de Team Foundation.
Permisos necesarios
Para utilizar el comando checkin, el permiso Proteger debe estar establecido en Permitir. Para utilizar opción /author, el permiso Proteger los cambios de otros usuarios debe estar establecido en Permitir. Para obtener más información, vea Permisos 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]
Parámetros
Argumento |
Descripción |
|---|---|
author name |
Valor proporcionado por el usuario para la opción /author. |
comment |
Comentario proporcionado por el usuario sobre la protección. |
@comment file |
Ruta de acceso proporcionada por el usuario de un archivo en disco que contiene el comentario para la protección. |
NoteFieldName=NoteFieldValue |
Establece el valor del campo de nota de protección. Puede proporcionar varias expresiones "campo=valor" separadas por punto y coma. |
Notefile |
Ruta de acceso que ha proporcionado el usuario para un archivo del disco que contiene los nombres y los valores de los campos de las notas de protección, con el formato "campo=valor". Un mosaico de notas separadas por punto y coma puede ocupar varias líneas, por ejemplo: campo1=valor1; campo2=valor que ocupa varias líneas;. |
Reasonfile |
Descripción proporcionada por el usuario de la razón por la que se omite la directiva de protección. Si se especifica una razón, se envía una notificación de la omisión de la directiva y su explicación a los administradores de Team Foundation por correo electrónico. |
itemspec |
Especifica el archivo o la carpeta que se va a proteger. Para obtener más información acerca de cómo Team Foundation analiza una especificación de archivo para determinar qué elementos se encuentran en su ámbito, vea Opciones de la línea de comandos. |
username |
Proporciona un valor para la opción /login. Puede especificar un valor de nombre de usuario como DOMINIO\NombreDeUsuario o NombreDeUsuario. |
shelvesetname [:owner] |
Identifica el conjunto de cambios aplazados que desea proteger. El argumento opcional owner se utiliza para especificar un conjunto de cambios aplazados que no pertenece al usuario actual. |
TeamProjectCollectionUrl |
La dirección URL de la colección de proyectos de equipo que contiene los archivos o carpetas que desea proteger (por ejemplo, http://myserver:8080/tfs/DefaultCollection). |
Opción |
Descripción |
|---|---|
/author |
Identifica al autor de los cambios pendientes para que un usuario pueda proteger los cambios en nombre de otro usuario. Requiere el permiso CheckinOther. |
/comment |
Asocia un comentario al conjunto de cambios. |
/noprompt |
Suprime todos los mensajes de solicitud de datos. |
/notes |
Proporciona una o varias notas de protección para asociar al conjunto de cambios. |
/override |
Permite pasar por alto un error de la directiva de protección. Esta opción sólo se necesita cuando hay una directiva de protección y se desea proteger de todos modos. |
/recursive |
Protege todos los elementos de las carpetas y subcarpetas de trabajo especificadas o implícitas. |
/saved |
Cuando la protección es cancelada por el usuario o produce un error, o cuando el usuario retoma los cambios aplazados, los cambios seleccionados, comentarios, elementos de trabajo, notas de protección y razones de la invalidación de la directiva de protección, si existe alguna, se almacenan en el equipo. Cuando se combina con /noprompt, la opción /saved protege los cambios con el comentario, etc. que se guardaron, si hay alguno. |
/validate |
La opción /validate permite probar la protección sin efectuarla realmente. Las opciones /validate hacen que la protección evalúe las directivas de protección, compruebe las notas de protección y busque conflictos sin realizar la protección realmente. Todos los problemas, como los conflictos, que esta opción identifica se debe resolver antes de proteger el elemento. |
/bypass |
Omite un requisito de entrada validada. Para obtener más información, vea Proteger los cambios pendientes controlados por una compilación de protección controlada. |
/login |
Especifica el nombre de usuario y la contraseña para autenticar al usuario con Visual Studio Team Foundation Server. |
/shelveset |
Especifica el conjunto de cambios aplazados por su nombre. |
/collection |
Especifica la colección del proyecto de equipo. |
Comentarios
Un cambio pendiente está compuesto de una adición, eliminación, cambio de nombre, edición, bifurcación, recuperación o tipo de archivo o carpeta. Puede aplicar algunos cambios, como la edición y el cambio de nombre, a un mismo elemento al mismo tiempo. Un cambio pendiente es aquel que no se ha enviado para protección. Para obtener más información y una lista completa de los cambios pendientes en Team Foundation, vea Cambios pendientes.
El comando checkin crea un conjunto de cambios en el servidor control de versiones de Team Foundation desde un conjunto definido dinámicamente de cambios pendientes, elementos de trabajo, comentarios definidos por el usuario y metadatos del sistema, y hace que los cambios estén disponibles para otros usuarios. Otros usuarios pueden utilizar el comando get para recuperar sus cambios. Los comandos history y changeset presentan la información de conjunto de cambios correspondiente a los cambios enviados.
Nota
Dado que puede proteger cambios pendientes de la línea de comandos, el menú contextual Explorador de control de código fuente puede que no siempre refleje el estado de los cambios pendientes.
Para obtener más información sobre cómo buscar la utilidad de la línea de comandos tf, vea Comandos de la utilidad Tf de la línea de comandos.
El proceso de protección
La operación de protección se realiza atómicamente, lo que significa que la operación tiene éxito por completo o produce un error. Si cualquiera de los cambios de la lista de cambios pendientes no se puede enviar al servidor control de versiones de Team Foundation, no se confirma ningún cambio y no se crea un conjunto de cambios. Por ejemplo, si se pierde la conectividad de red en medio de la operación, la operación completa produce un error.
El primer paso en el proceso de protección es evaluar que los cambios pendientes cumplan las directivas de protección. Puede pasar por alto los errores de la directiva de protección mediante la opción /override en la línea de comandos. Debe proporcionar una razón por la que se pasan por alto los errores de la directiva. Esta razón se conserva en el servidor control de versiones de Team Foundation y se convierte en un atributo del conjunto de cambios confirmado. La opción /override está diseñada principalmente para el uso en scripts. Para obtener más información, vea Reemplazar una directiva de protección.
Si una versión de un elemento en la lista de cambios pendientes es diferente de la última versión en el servidor de control de versiones de Team Foundation, Team Foundation solicita que se resuelvan en primer lugar los conflictos entre su versión y última versión del servidor de control de versiones de Team Foundation. Por ejemplo, si desprotegió la versión 4 de stellar.cs y la última versión en el servidor control de versiones de Team Foundation es ahora la versión 6, se le solicita que resuelva los conflictos. A menos que se especifique la opción **/noprompt **, aparece el cuadro de diálogo Resolver, que le ayuda a investigar y resolver las diferencias de versión. Después de resolver las diferencias y volver a probar el código, puede intentar proteger de nuevo sus cambios.
Ejemplos
El ejemplo siguiente muestra el cuadro de diálogo Proteger, que tiene cambios pendientes preseleccionados para una operación de protección masiva de todos los cambios pendientes en el área de trabajo asignada a c:\projects. Si hace clic en Proteger, cada elemento se envía individualmente a un conjunto de cambios en el servidor de control de versiones de Team Foundation y se evalúa para comprobar que la versión del servidor permanece sin cambios porque el elemento se ha desprotegido. Si la protección tiene éxito, Team Foundation crea un conjunto de cambios y muestra su número para referencia posterior.
c:\projects>tf checkin
El ejemplo siguiente envía todos los cambios pendientes del área de trabajo actual al servidor control de versiones de Team Foundation, junto con el comentario especificado, para crear un nuevo conjunto de cambios.
c:\projects>tf checkin /comment:"Re-implemented Pi calculator" /noprompt
El ejemplo siguiente envía los cambios pendientes a 314.cs y deja todas las demás revisiones en el área de trabajo actual como pendientes.
c:\projects>tf checkin 314.cs /noprompt
Vea también
Tareas
Tutorial: Personalizar las notas y directivas de protección
Proteger los cambios pendientes
Referencia
Sintaxis de la línea de comandos (Control de versiones)