Comando checkin
Actualización: noviembre 2007
Confirma los cambios pendientes del área de trabajo actual en el servidor 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:reasonfile|@reason] [/recursive] [/saved] [/validate]
[itemspec]
Parámetros
Argumento |
Descripción |
|---|---|
authorname |
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 un archivo o carpeta que se va a proteger. Para obtener más información sobre cómo Team Foundation analiza una especificación de archivo para determinar qué elementos están en su ámbito, vea Opciones de la línea de comandos. |
Opción |
Descripción |
|---|---|
/author |
Identifica al autor de los cambios pendientes especificados o implícitos 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 omisió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 guardó, si corresponde. |
/validate |
La opción /validate permite probar la protección sin efectuarla realmente. La opción /validate hace que la protección evalúe las directivas de protección, compruebe las notas de protección y busque conflictos sin que se aplique realmente la protección. Cualquier problema, como los conflictos, identificado por esta opción se debe resolver antes de proteger el elemento. |
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. Algunos cambios, como la edición y el cambio de nombre, se pueden aplicar al mismo tiempo a un mismo elemento. Un cambio pendiente es uno que no se ha enviado para su protección. Para obtener más información sobre 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.
.gif "Nota") Nota: |
|---|
Dado que puede proteger los cambios pendientes desde la línea de comandos, es posible que el menú contextual del Explorador de control de código fuente no siempre esté sincronizado con el estado de los cambios pendientes. |
Para obtener más información sobre cómo encontrar 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 secuencias de comandos. Para obtener más información, vea Cómo: Invalidar 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 de Control de versiones de Team Foundation 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: Trabajar con el control de versiones de Team Foundation desde la línea de comandos
Tutorial: Personalizar las notas y directivas de protección
Cómo: Proteger cambios pendientes
Conceptos
Enviar cambios al servidor del control de versiones
Referencia
Sintaxis de la línea de comandos (Team System)