Obter o histórico de um item

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

Visual Studio 2019 | Visual Studio 2022

Uma vantagem do sistema de controle de versão é que você pode verificar dados de um momento anterior para obter informações detalhadas sobre quais alterações foram feitas em seus arquivos. O Controle de versão do Team Foundation (TFVC) mantém dados históricos relacionados a toda versão de todos os arquivos cujo check-in tenha sido feito alguma vez.

Geralmente, quando você examina o histórico de um arquivo, pasta ou ramificação, você estará tentando resolver um problema ou responder a uma pergunta. Usando a janela Histórico no Visual Studio, você pode resolver mais facilmente as seguintes perguntas e situações:

  • Que alterações foram feitas nas últimas semanas ou meses?

  • Qual item de trabalho foi concluído por esta alteração no arquivo?

  • Quem fez o check-in nesta alteração? O que disseram sobre a alteração? O que eles alteraram?

  • Se ocorreram alterações inesperadas neste arquivo, causando um bug em uma área do produto que a equipe achava estável, quem fez essa alteração e por quê?

  • Se uma alteração nessa ramificação corrige um bug que também precisa ser corrigido em outras ramificações, como você pode garantir que a alteração seja mesclada a essas ramificações?

Use a janela Histórico no Visual Studio para obter dados históricos detalhados sobre um projeto de equipe, uma ramificação, uma pasta ou um arquivo.

Pré-requisitos

Você deve ser um dos Colaboradores de seu projeto. Para saber mais, confira Permissões padrão do TFVC.

Abrir a janela Histórico

Para abrir a janela Histórico do Visual Studio, clique com o botão direito do mouse em um item no Gerenciador de Controle do Código-Fonte e escolha Histórico de Exibição.

Dica

Você pode personalizar a posição da janela clicando com o botão direito do mouse no título e escolhendo Flutuar, Encaixarou Encaixar como Documento com Guias.

Você também pode usar o comando Histórico da linha de comando para abrir a janela no Visual Studio.

A janela Histórico exibe os dados históricos sobre o item em duas guias:

Guia Conjuntos de Alterações

O guia Conjuntos de Alterações exibe dados detalhados sobre cada alteração feita em um item. Todos os conjuntos de alterações que modificaram o item são listados em uma tabela que inclui as seguintes colunas:

  • Conjunto de Alterações: a ID do conjunto de alterações.

  • Usuário: o nome do usuário que fez o check-in do conjunto de alterações.

  • Data:aA data e a hora em que o conjunto de alterações passou por check-in.

  • Comentário: o comentário inserido pelo usuário que faz check-in do conjunto de alterações.

Os arquivos também exibem dados nas seguintes colunas:

  • Alteração: os tipos de alterações que foram feitas no arquivo com o conjunto de alterações. Os exemplos de valores que podem aparecer nessa coluna incluem adição, edição, renomeação e mesclagem.

  • Caminho: o caminho para o arquivo.

Observação

Se você abrir a janelaHistórico usando o comando tf history e exibir dados sobre um projeto, ramificação ou pasta, o histórico de itens filho, como arquivos contidos em uma pasta, será exibido somente se você usar a opção /recursive.

Dica

Às vezes, você precisa compartilhar esse tipo de dados com outra pessoa. Você pode selecionar uma ou mais linhas da tabela na guia Conjunto de Alterações, clicar com o botão direito do mouse, clicar em Copiar a fim de copiar os dados para a área de transferência e colar os dados em uma mensagem de e-mail, em um documento ou em uma planilha.

Tarefas comuns

Usando a guia Conjuntos de Alterações, você pode executar as seguintes tarefas:

Tarefa

Conteúdo de suporte

  • Exibir o item como ele era quando o conjunto de alterações passou por check-in: clique duas vezes no conjunto de alterações ou clique nele com o botão direito do mouse e clique em Exibir. Esse comando estará disponível apenas se o item for um arquivo.

Nenhum

  • Obter mais detalhes sobre um conjunto de alterações: clique com o botão direito do mouse em um conjunto de alterações e clique em Detalhes do Conjunto de Alterações para obter informações como:

  • Outros arquivos de origem que fazem parte do conjunto de alterações.

  • Itens de trabalho associados ao conjunto de alterações.

  • Observações de check-in deixadas para os revisores.

  • Comparar uma versão passada com a versão atual: clique com o botão direito do mouse em um conjunto de alterações e clique em Comparar.

  • Compare uma versão anterior com outra versão anterior: selecione dois conjuntos de alterações usando Ctrl+Select e clique com o botão direito do mouse em um dos conjuntos de alterações e selecione Comparar.

  • Obter uma versão passada do item: clique com o botão direito do mouse em um conjunto de alterações e Clique em Obter Esta Versão para baixar a versão passada do item em seu workspace.
  • Exibir quais usuários fizeram alterações específicas em um arquivo:clique com o botão direito do mouse em um conjunto de alterações e clique em Anotar. Esse comando estará disponível apenas se o item for um arquivo.
  • Obtenha mais detalhes sobre uma mesclagem: se o conjunto de alterações resultou de uma mesclagem, você poderá expandir esse item para exibir os conjuntos de alterações que foram mesclados neste item de outra ramificação. Esse comando estará disponível apenas se o item for um arquivo.

Nenhum

  • Obtenha mais detalhes sobre as alterações que foram feitas antes de uma alteração de renomeação: Se o conjunto de alterações incluir uma renomeação, você poderá expandir esse item para exibir os conjuntos de alterações que ocorreram antes da alteração de renomeação ser feita.

Nenhum

  • Exibir outras ramificações nas quais esse conjunto de alterações foi mesclado: clique com o botão direito do mouse no conjunto de alterações e clique em Acompanhar Conjunto de Alterações.
  • Reverter alterações de um conjunto de alterações: selecione um único conjunto de alterações e escolha Reverter o Conjunto de Alterações Inteiro.
  • Reverter alterações de dois ou mais conjuntos de alterações consecutivos: selecione uma série de conjuntos de alterações consecutivos e escolha Reverter.
  • Exibir o histórico não recursivo de uma pasta: Você pode obter esses dados somente no prompt de comando.

Guia Rótulos

Todos os rótulos aplicados ao item são listados em uma tabela que inclui as seguintes colunas:

  • Nome: o nome do rótulo.

  • Usuário: o usuário que aplicou o rótulo.

  • Data: a data e a hora em que o rótulo foi aplicado.

  • Conjunto de Alterações: o conjunto de alterações ao qual o rótulo se aplica.

  • Comentário: o comentário feito pelo usuário que aplicou o rótulo.

Observação

Quando você exibe dados históricos sobre um projeto, ramificação ou pasta, os dados sobre rótulos aplicados a itens filho, como os arquivos em uma pasta, não são mostrados.

Dica

Às vezes, você precisa compartilhar esse tipo de dados com outra pessoa. Você pode selecionar uma ou mais linhas da tabela na guia Rótulos, clicar com o botão direito do mouse, clicar em Copiar para copiar os dados para a área de transferência e colar os dados em uma mensagem de e-mail, em um documento ou em uma planilha.

Tarefas comuns

Tarefa

Conteúdo de suporte

  • Exibir o item como ele era quando o conjunto de alterações rotulado passou por check-in: clique com o botão direito do mouse no rótulo e clique em Exibir. Esse comando estará disponível apenas se o item for um arquivo.

Nenhum

  • Editar o rótulo: clique com o botão direito do mouse no rótulo e clique em Editar Rótulo.
  • Excluir o rótulo:Clique com o botão direito do mouse no rótulo e clique em Excluir Rótulo.
  • Comparar uma versão passada do item com a versão atual: clique com o botão direito do mouse em um rótulo e clique em Comparar para comparar uma versão passada do item com a versão atual.
  • Obter uma versão passada do item: clique com o botão direito do mouse em um rótulo e clique em Obter Esta Versão para baixar a versão passada do item em seu workspace.
  • Exibir outras ramificações nas quais o conjunto de alterações rotulado foi mesclado: clique com o botão direito do mouse no rótulo e clique em Acompanhar Conjunto de Alterações. Esse comando estará disponível apenas se o item for um arquivo.
  • Exibir quais usuários fizeram alterações específicas em uma versão rotulada de um arquivo: clique com o botão direito do mouse em um conjunto de alterações e clique em Anotar. Esse comando estará disponível apenas se o item for um arquivo.