Comando Check-in

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

Visual Studio 2019 | Visual Studio 2022

O comando checkin do TFVC verifica as alterações de arquivo e pasta pendentes no servidor.

Quase toda alteração que você fizer nos arquivos no seu computador de desenvolvimento é armazenada em seu espaço de trabalho como uma alteração pendente até que você faça check-in. Quando você fizer check-in de suas alterações, elas serão armazenadas como um conjunto de alterações no servidor. O comando checkin fornece uma interface do usuário diferente para fazer os mesmos processos documentados para o Visual Studio em Fazer check-in do seu trabalho para a base de código da equipe.

Dicas

  • Se você precisar deixar de lado as alterações ou quiser limpar seu workspace para outra tarefa, use o Comando Shelve.

  • Se conflitos bloquearem seu check-in, você poderá usar o Comando Resolver para resolvê-los.

  • Se um computador e uma conta de usuário não tiverem um workspace mapeado para a coleção de projetos que contém o check-in particular, você poderá usar as opções /shelveset e /collection para fazer check-in de um check-in particular.

Pré-requisitos

Sintaxe

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

Descrição


/author:<author name>

Identifica o autor das alterações pendentes para que um usuário possa fazer check-in de alterações em nome de outro usuário.

Requer a permissão CheckinOther. Consulte Referência de permissões e grupos.

/bypass

Ignora um requisito de check-in restrito. Para obter mais informações, consulte Fazer check-in em uma pasta controlada por um processo de build de check-in restrito.

/collection:<ProjectCollectionUrl>

Se você usar a opção shelveset, a opção /collection especificará a URL da coleção de projetos que contém o check-in particular. Por exemplo: http://myserver:8080/tfs/DefaultCollection.

Por padrão, presume-se que a coleção de projetos seja aquela que contém o workspace que mapeia o diretório atual.

/comment

Associa um comentário ao conjunto de alterações usando um dos seguintes argumentos:

  • "<comment>": Um comentário feito pelo usuário sobre o check-in.
  • @<comment file>: O caminho para um arquivo no disco que contém o comentário para o check-in.

/force

Força um check-in em itens com edições pendentes, mesmo quando não há alterações de conteúdo no arquivo.

<itemspec>

Especifica o escopo dos itens para fazer check-in do workspace do usuário. Você pode especificar mais de um argumento itemspec. Para obter sintaxe, consulte Usar comandos de controle de versão do Team Foundation.

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

Especifica a conta de usuário na qual executar o comando. Consulte Usar comandos de controle de versão do Team Foundation.

/new

O estado selecionado de cada alteração pendente, conforme mostrado na caixa de diálogo Check In. O comentário, os itens de trabalho associados, as observações de check-in e o motivo da substituição da política check-in são armazenados no computador de desenvolvimento como alterações pendentes até que você os verifique. A opção /new limpa esses metadados de check-in antes de fazer check-in. Essa opção e o comportamento modificado não têm efeito quando você usa a opção /noprompt.

/noautoresolve

Por padrão o sistema tenta automaticamente AutoResolve All os conflitos. Especifique essa opção para desabilitar esse comportamento padrão. Para obter mais informações, consulte Resolver conflitos de controle de versão do Team Foundation.

/noprompt

Suprime a exibição de janelas e caixas de diálogo, como a caixa de diálogo Check-in, e redireciona os dados de saída para o prompt de comando. Consulte Usar comandos de controle de versão do Team Foundation.

/notes

Fornece uma ou mais observações de check-in para associar ao conjunto de alterações usando um dos seguintes argumentos:

  • <NoteFieldName>=<NoteFieldValue>: Define o valor do campo Observação de check-in. Você pode fornecer várias expressões field=value separadas por ponto e vírgula.
  • @<NoteFile>: O caminho de um arquivo fornecido pelo usuário no disco que contém valores e nomes do campo Observação de check-in no formato de field=value. Um bloco de anotação separado por ponto e vírgula pode abranger várias linhas, por exemplo:

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

/override

Substitui uma política de check-in usando um dos seguintes argumentos:

  • reason: um motivo fornecido pelo usuário pelo qual a política de check-in está sendo ignorada.
  • reasonfile: o caminho para um arquivo que contém uma descrição fornecida pelo usuário do motivo pelo qual a política de check-in está sendo ignorada.

/recursive

Verifica recursivamente os itens no diretório especificado e quaisquer subdiretórios.

/saved

Ignore esse parâmetro.

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

Especifica um check-in particular para fazer check-in. O argumento opcional owner especifica um check-in particular que o usuário atual não possui.

Observação

Depois de fazer check-in no check-in particular, o sistema o exclui.

/validate

Testa se o check-in teve êxito, sem fazer check-in dos arquivos. O sistema avalia políticas de check-in, observações de check-in e listas de conflitos.

Observação

Se você não especificar a opção/noprompt, deverá selecionar o botão Check In na caixa de diálogo Check In para validar o check-in. Depois de selecionar esse botão, o sistema não faz check-in nos arquivos.

Exemplos

Os exemplos a seguir pressupõem que c:\code\SiteApp\Main é a pasta principal e mapeada para a coleção de projetos no workspace do usuário.

Verificar todas as alterações pendentes no workspace atual

O comando a seguir exibe a caixa de diálogo Check In, que exibe todas as alterações pendentes no workspace atual. Você pode usar a caixa de diálogo Check In para selecionar ou desmarcar as alterações pendentes que deseja fazer check-in, adicionar um comentário, associar itens de trabalho e realizar outras tarefas e, em seguida, escolher o botão Check In quando estiver pronto para continuar.

c:\code\SiteApp\Main>tf checkin

Verificar todas as alterações pendentes com um comentário

O exemplo a seguir verifica todas as alterações pendentes no workspace atual e fornece um comentário para ajudar seus colegas de equipe a entender a finalidade das alterações.

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

Fazer check-in de uma alteração em um único item sem usar a caixa de diálogo Check In

O exemplo a seguir verifica as alterações pendentes em program.cs. A caixa de diálogo Check In não é exibida e, se algum conflito bloquear o check-in, o sistema não exibirá a janela de conflitos.

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