Obter o histórico de um item

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Uma vantagem de um sistema de controle de versão é que você pode olhar para trás no tempo 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 cada versão de cada arquivo que já foi submetido a check-in.

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

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

  • Que item de trabalho foi concluído por esta alteração ao ficheiro?

  • Quem verificou esta alteração? O que disseram sobre a mudança? O que mudaram?

  • Se ocorreram alterações inesperadas neste ficheiro, causando um bug numa área do produto que a equipa considerou estável, quem fez essa alteração e porquê?

  • Se uma alteração nessa ramificação corrigir 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 do Visual Studio para obter dados históricos detalhados sobre um projeto, ramificação, pasta ou arquivo.

Pré-requisitos

Tem de ser um dos Colaboradores do seu projeto. Para saber mais, consulte 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 Exibir Histórico.

Gorjeta

Pode personalizar a posição da janela clicando com o botão direito do rato no título e, em seguida, escolhendo Float, Dock ou set Tab Layout.

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:

  • A guia Conjuntos de alterações lista todas as alterações feitas no item, incluindo edições, renomeações e mesclagens.

  • A guia Rótulos lista todos os rótulos que foram aplicados ao item.

Guia Conjuntos de alterações

A 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 check-in no conjunto de alterações.

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

  • Comentário: O comentário inserido pelo usuário que fez check-in no 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. Exemplos de valores que podem aparecer nesta coluna incluem adicionar, editar, renomear e mesclar.

  • Caminho: O caminho para o arquivo.

Nota

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

Gorjeta

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

Tarefas comuns

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

Tarefa

Conteúdo de suporte

  • Exiba o item como ele existia quando o conjunto de alterações foi verificado: clique duas vezes ou clique com o botão direito do mouse no conjunto de alterações e selecione Exibir. Este comando só estará disponível se o item for um arquivo.

Nenhuma

  • Obtenha mais detalhes sobre um conjunto de alterações: clique com o botão direito do rato num conjunto de alterações e, em seguida, selecione 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.

  • Todas as notas de check-in deixadas para os revisores.

  • Comparar uma versão anterior com a versão atual: clique com o botão direito do rato num conjunto de alterações e, em seguida, selecione Comparar.

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

  • Obter uma versão anterior do item: clique com o botão direito do rato num conjunto de alterações e, em seguida, selecione Obter esta versão para transferir a versão anterior do item para a sua área de trabalho.
  • 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 selecione Anotar. Este comando só estará disponível se o item for um arquivo.
  • Obter mais detalhes sobre uma mesclagem: se o conjunto de alterações resultar de uma mesclagem, você poderá expandir este item para exibir os conjuntos de alterações que foram mesclados nesse item de outra ramificação. Este comando só estará disponível se o item for um arquivo.

Nenhuma

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

Nenhuma

  • Exibir outras ramificações para as quais esse conjunto de alterações foi mesclado: clique com o botão direito do mouse no conjunto de alterações e selecione Controlar conjunto de alterações.
  • Reverter alterações de um conjunto de alterações: selecione um único conjunto de alterações e escolha Reverter conjunto de alterações inteiro.
  • Reverter alterações de dois ou mais conjuntos de alterações consecutivos: selecione um conjunto de conjuntos de alterações consecutivos e escolha Reversão.
  • Exibir histórico não recursivo de uma pasta: você pode obter esses dados somente no prompt de comando.

Separador Etiquetas

Todos os rótulos que foram 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.

  • Changeset: 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.

Nota

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.

Gorjeta

Às vezes, você precisa compartilhar esse tipo de dados com outra pessoa. Pode selecionar uma ou mais linhas da tabela no separador Etiquetas , clicar com o botão direito do rato nas mesmas, selecionar Copiar para copiar os dados para a área de transferência e, em seguida, colar os dados numa mensagem de correio eletrónico, documento ou folha de cálculo.

Tarefas comuns

Tarefa

Conteúdo de suporte

  • Exiba o item como ele existia quando o conjunto de alterações rotulado foi feito check-in: clique com o botão direito do mouse em um rótulo e selecione Exibir. Este comando só estará disponível se o item for um arquivo.

Nenhuma

  • Editar a etiqueta: clique com o botão direito do rato na etiqueta e selecione Editar etiqueta.
  • Eliminar a etiqueta: clique com o botão direito do rato na etiqueta e selecione Eliminar Etiqueta.
  • Comparar uma versão anterior do item com a versão atual: clique com o botão direito do mouse em um rótulo e selecione Comparar para comparar uma versão anterior do item com a versão atual.
  • Obter uma versão anterior do item: clique com o botão direito do rato numa etiqueta e, em seguida, selecione Obter esta versão para transferir a versão anterior do item para a área de trabalho.
  • 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 selecione Controlar conjunto de alterações. Este comando só estará disponível se o item for um arquivo.
  • Exibir quais usuários fizeram alterações específicas na versão rotulada de um arquivo: clique com o botão direito do mouse em um conjunto de alterações e selecione Anotar. Este comando só estará disponível se o item for um arquivo.