Checkin (Comando)

  • Artículo

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

Visual Studio 2019 | Visual Studio 2022

El comando TFVC checkin comprueba los cambios de archivo y carpeta pendientes en el servidor.

Casi todos los cambios que realice en los archivos del equipo de desarrollo se almacenarán en el área de trabajo como cambio pendiente hasta que los proteja. Al insertar en el repositorio los cambios, se almacenan como un conjunto de cambios en el servidor. El comando checkin proporciona una interfaz de usuario diferente para realizar los mismos procesos documentados para Visual Studio en Inserción en el repositorio del trabajo en el código base del equipo.

Sugerencias

  • Para reservar cambios o limpiar el área de trabajo para otra tarea, use el comando Preparar para confirmar.

  • Si los conflictos bloquean la protección, puede usar el comando Resolver para resolverlos.

  • Si un equipo y una cuenta de usuario no tienen un área de trabajo asignada a la colección de proyectos que contiene el conjunto de cambios agregados pendientes de confirmación, puede usar las opciones de /shelveset y /collection para insertar en el repositorio un conjunto de cambios agregados pendientes de confirmación.

Requisitos previos

Sintaxis

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]

Parámetros

Parámetro

Descripción

/author:<author name>

Identifica al autor de los cambios pendientes para que un usuario pueda insertar en el repositorio los cambios en nombre de otro usuario.

Requiere el permiso CheckinOther. Consulte Referencia de permisos y grupos.

/bypass

Omite un requisito de protección controlada. Para obtener más información, vea Inserción en el repositorio en una carpeta controlada por un proceso de compilación de inserción en el repositorio validada.

/collection:<ProjectCollectionUrl>

Si usa la opción shelveset, la opción /collection especifica la dirección URL de la colección de proyectos que contiene el conjunto de cambios agregados pendientes de confirmación. Por ejemplo: http://myserver:8080/tfs/DefaultCollection.

De forma predeterminada, se supone que la colección de proyectos es la que contiene el área de trabajo que asigna el directorio actual.

/comment

Asocia un comentario al conjunto de cambios mediante uno de los argumentos siguientes:

  • "<comment>": comentario proporcionado por el usuario sobre la protección.
  • @<comment file>: ruta de acceso a un archivo en disco que contiene el comentario sobre la protección.

/force

Exige una protección en los elementos con ediciones pendientes, incluso cuando no hay cambios de contenido en el archivo.

<itemspec>

Especifica el ámbito de los elementos que hay que insertar en el repositorio en el área de trabajo del usuario. Puede especificar más de un argumento itemspec. Para obtener la sintaxis, vea Uso de comandos del control de versiones de Team Foundation.

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

Especifica la cuenta de usuario que ejecuta el comando. Vea Uso de comandos del control de versiones de Team Foundation.

/new

Estado seleccionado de cada cambio pendiente, tal como se muestra en el cuadro de diálogo Insertar en el repositorio. El comentario, los elementos de trabajo asociados, las notas de protección y la razón de reemplazo de la directiva de protección se almacenan en el equipo de desarrollo como cambios pendientes hasta que los proteja. La opción /new elimina los metadatos de la inserción en el repositorio antes de insertar en el repositorio. Esta opción y el comportamiento que modifica no tienen ningún efecto cuando se usa la opción /noprompt.

/noautoresolve

De forma predeterminada, el sistema intenta automáticamente AutoResolve All conflictos. Especifique esta opción para deshabilitar este comportamiento predeterminado. Para obtener más información, consulte Resolución de conflictos de Control de versiones de Team Foundation.

/noprompt

Suprime la presentación de ventanas y cuadros de diálogo, por ejemplo, el cuadro de diálogo Insertar en el repositorio, y redirige los datos de salida al símbolo del sistema. Vea Uso de comandos del control de versiones de Team Foundation.

/notes

Proporciona una o más notas de protección para asociarlas al conjunto de cambios mediante uno de los argumentos siguientes:

  • <NoteFieldName>=<NoteFieldValue>: establece el valor del campo de nota de protección. Puede proporcionar varias expresiones field=value separadas por punto y coma.
  • @<NoteFile>: la ruta de acceso proporcionada por el usuario a un archivo en disco que contiene los nombres y valores del campo de la nota de protección en el formato field=value. Un mosaico separado por punto y coma de la nota puede abarcar varias líneas, por ejemplo:

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

/override

Reemplaza una directiva de protección mediante uno de los argumentos siguientes:

  • reason: un motivo proporcionado por el usuario para omitir la directiva de protección.
  • reasonfile: ruta de acceso a un archivo que contiene la descripción proporcionada por el usuario acerca del motivo por el que se omite la directiva de protección.

/recursive

Protege repetidamente los elementos del directorio especificado y de cualquier subdirectorio.

/saved

Omita este parámetro.

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

Especifica un conjunto de cambios aplazados para protegerlo. El argumento opcional owner especifica un conjunto de cambios agregados pendientes de confirmación que el usuario actual no posee.

Nota:

Después de proteger el conjunto de cambios aplazados, el sistema lo elimina.

/validate

Comprueba si la inserción en el repositorio tendría éxito sin insertar en el repositorio los archivos. El sistema evalúa las directivas de protección, las notas de protección y enumera los conflictos.

Nota:

Si no especifica la opción /noprompt, debe seleccionar el botón Insertar en el repositorio del cuadro de diálogo Insertar en el repositorio para validar la inserción en el repositorio. Después de seleccionar este botón, el sistema no inserta en el repositorio los archivos.

Ejemplos

En los ejemplos siguientes se supone que c:\code\SiteApp\Main es la carpeta principal asignada a la colección de proyectos en el área de trabajo del usuario.

Proteger todos los cambios pendientes en el área de trabajo actual

El comando siguiente muestra el cuadro de diálogo Insertar en el repositorio, que muestra todos los cambios pendientes en el área de trabajo actual. Puede usar el cuadro de diálogo Insertar en el repositorio para seleccionar o desactivar los cambios pendientes que quiere insertar, agregar un comentario, asociar elementos de trabajo y realizar otras tareas y, después, elegir el botón Insertar en el repositorio cuando esté a punto para continuar.

c:\code\SiteApp\Main>tf checkin

Proteger todos los cambios pendientes con un comentario

En el ejemplo siguiente se comprueban todos los cambios pendientes en el área de trabajo actual y se proporciona un comentario para ayudar a los compañeros de equipo a comprender el propósito de los cambios.

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

Proteger un cambio de un solo elemento sin utilizar el cuadro de diálogo Proteger

En el ejemplo siguiente se comprueban los cambios pendientes en program.cs. No se muestra el cuadro de diálogo Insertar en el repositorio y, si hay conflictos, el sistema no muestra la ventana de conflictos.

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