Usar rótulos para obter um instantâneo dos arquivos
Publicado: abril de 2016
Rótulos permitem que você obtenha um instantâneo de seus arquivos para consultar posteriormente. Usando seu rótulo, você pode exibir, compilar ou até mesmo reverter um conjunto grande de arquivos para o estado em que estavam quando o rótulo foi aplicado.
Permissões obrigatórias
Para aplicar um rótulo, você deve ter a permissão Rótulo definida para Permitir. Para localizar, listar ou exibir rótulos, você deve ter a permissão Ler definida para Permitir. Para modificar ou excluir um rótulo, você deve possuí-lo ou ter as permissões Administrar Rótulos definidas para Permitir.
Neste artigo
Usando rótulos
Aplicar um rótulo
Renomear um rótulo
Listar, localizar, exibir, editar e remover rótulos
Baixar versões rotuladas de arquivos para seu espaço de trabalho
Usar a janela Rótulo para trabalhar com rótulos
Trabalhar no prompt de comando
Usando rótulos
Em muitos projetos de software, quando o código atinge um nível razoável de qualidade e estabilidade, a equipe compilará e liberará uma nova versão do produto. A equipe precisa marcar a versão atual de cada arquivo para que, mesmo que os arquivos continuarem a ser alterados, a equipe ainda possa obter e compilar a nova versão de todos os arquivos no projeto.
Teoricamente, você pode registrar manualmente a ID de cada conjunto de alterações em cada arquivo, mas esse tipo de processo não é prático. O Controle de versão do Team Foundation facilita o trabalho: você aplica um rótulo para a pasta, a ramificação ou o projeto de equipe que contém os arquivos. Você pode nomear um rótulo seguindo qualquer convenção de nomenclatura que preferir. Alguns exemplos de nomes de rótulo incluem: “Sprint 5 ", “M1”, “Beta2” e "Release Candidate 0".
Depois de aplicar o rótulo, você pode usá-lo para qualificar operações como compilação, ramificação, mesclagem, comparação e a aquisição de versões específicas de arquivos e pastas.
Às vezes, depois que você aplica um rótulo, você decide alterá-lo. O Controle de versão do Team Foundation permite que você aplique um rótulo a arquivos adicionais, remova um rótulo de determinados arquivos e até mesmo modifique a qual versão de um arquivo específico o rótulo se aplica.
Dica
Aplicar um rótulo oferece muitos dos mesmos benefícios da criação de uma ramificação, porém com custos e complexidade mais baixos.
Aplicar um rótulo
Dica
Quando você usa o Visual Studio para aplicar um rótulo que já existe, a operação remove o rótulo de todas as versões de arquivo e então o aplica.No prompt de comando, no entanto, a operação de rotulação é aditiva.Consulte Label Command (Team Foundation Version Control).
Aplicar um rótulo
No Gerenciador do Controle do Código-Fonte, abra o menu de atalho da coleção, projeto de equipe, ramificação, pasta ou arquivo ao qual você deseja aplicar um rótulo e escolha Avançado, Aplicar Rótulo.
A caixa de diálogo Novo Rótulo aparece.
Na caixa Nome, digite um nome para o rótulo.
(Opcional) Digite seus comentários na caixa Comentário.
Na lista Versão, Última Versão é selecionado por padrão. Essa opção é a mais usada normalmente, mas se você precisar que o rótulo direcione uma versão específica, selecione:
Conjunto de Alterações: especifica o número do conjunto de alterações na caixa Conjunto de Alterações. Como alternativa, selecione as reticências (...) para abrir a caixa de diálogo Localizar Conjuntos de Alterações. Para obter mais informações, consulte Localizar e exibir conjuntos de alterações.
Data: especifique uma data na caixa Data ou selecione uma data do calendário no menu suspenso.
Rótulo: especifique um rótulo existente em que será baseado o novo rótulo. Digite o nome do rótulo na caixa Rótulo, ou selecione as reticências (...) para abrir a caixa de diálogo Localizar Rótulo. Para obter mais informações, consulte Localizar, editar e remover rótulos.
Versão do Espaço de Trabalho: o rótulo será criado para a versão do seu espaço de trabalho.
Quando estiver satisfeito com suas configurações, execute uma das seguintes etapas:
Para aplicar o rótulo, selecione Criar.
Para aplicar o rótulo e então modificá-lo depois de ser aplicado, selecione Criar e editar. Isso aplica o rótulo e então exibe a janela Rótulo. Para obter mais informações sobre como usar a janela Rótulo para editar um rótulo, consulte Usar a janela Rótulo para trabalhar com rótulos.
Dica
Quando você aplicar um rótulo usando um nome que já existe, o sistema avisará e perguntará se deseja continuar.Se você selecionar OK para continuar, qualquer item que não é contido no caminho que você está aplicando o rótulo não terá mais aquele rótulo.
Renomear um rótulo
Embora não seja possível modificar o nome de um rótulo existente, você pode facilmente aplicar um novo rótulo aos mesmos arquivos e mesmas versões às quais está aplicado outro rótulo.
Aplicar um rótulo baseado em um rótulo existente
No Gerenciador do Controle do Código-Fonte, abra o menu de atalho para o nó de coleção de projetos (o nó raiz) e escolha Avançado, Aplicar Rótulo.
A caixa de diálogo Novo Rótulo aparece.
Na caixa Nome, digite um nome para o rótulo.
(Opcional) Na caixa Comentário, digite um comentário.
Na lista Versão, selecione Rótulo.
A caixa Rótulo aparece.
Execute uma das seguintes etapas:
Digite o nome do rótulo existente.
Se você não tiver certeza do nome de um rótulo existente, selecione o botão Procurar com as reticências (...) próximo à caixa Rótulo.
A caixa de diálogo Localizar Rótulo aparece.
Use as opções na caixa de diálogo Localizar Rótulo para filtrar a lista de rótulos e localizar o rótulo existente que você deseja aplicar o novo rótulo. (Para obter mais informações, consulte Localizar, editar e remover rótulos.)
Escolha Criar.
(Opcional) Depois de criar o novo rótulo, você pode remover o rótulo antigo. Para obter mais informações, consulte Localizar, editar e remover rótulos.
Listar, localizar, exibir, editar e remover rótulos
Há duas maneiras para listar e localizar rótulos: a caixa de diálogo Localizar Rótulo e a guia Rótulo na janela Histórico. Depois de localizar o rótulo no qual está interessado, você pode exibi-lo, editá-lo, removê-lo ou trabalhar com os arquivos aos quais ele se aplica.
Localizar e trabalhar com rótulos usando a caixa de diálogo Localizar Rótulo
No Gerenciador do Controle do Código-Fonte, na barra de menus, escolha Arquivo, Controle do Código-Fonte, Localizar, Localizar Rótulo.
A caixa de diálogo Localizar Rótulo aparece.
(Opcional) Refine sua pesquisa executando uma ou mais das seguintes etapas:
Na caixa de texto Nome, digite o nome do rótulo.
Na lista Projeto, selecione o projeto de equipe que contém o nome que você deseja localizar.
Na caixa de texto Proprietário, digite o nome ou alias do proprietário do rótulo.
Escolha Localizar.
A lista Resultados exibe rótulos que correspondem aos critérios de pesquisa que você inseriu.
(Opcional) Execute uma das seguintes etapas:
Para exibir ou editar um rótulo, selecione-o e clique em Editar.
A janela Rótulo aparece. Para obter mais informações, consulte Usar a janela Rótulo para trabalhar com rótulos.
Para excluir um rótulo, selecione-o e clique em Excluir.
Escolha Fechar.
Às vezes você não tem certeza do nome de um rótulo, mas você sabe que o rótulo foi aplicado a um item específico sob controle de versão. O procedimento a seguir explica como localizar e, em seguida, trabalhar com um rótulo nesta situação.
Listar e trabalhar com rótulos que se aplicam a um item específico
No Gerenciador do Controle do Código-Fonte, abra o menu de atalho do item ao qual o rótulo que você deseja localizar se aplica e escolha Exibir Histórico.
A janela Histórico aparece.
Escolha a guia Rótulos para exibir a lista de rótulos que se aplicam a este item.
(Opcional) Execute uma das seguintes etapas:
Para exibir ou editar rótulo, abra o menu de atalho e selecione Editar Rótulo.
A janela Rótulo aparece. Para obter informações sobre como usar essa janela, consulte Usar a janela Rótulo para trabalhar com rótulos.
Para excluir um rótulo, abra o menu de atalho e selecione Excluir Rótulo.
Abra o menu de atalho para o rótulo e escolha outras ações como Obter Esta Versão e Comparar.
Para obter mais informações sobre como usar a guia Rótulo na janela Histórico, consulte Obter o histórico de um item.
Baixar versões rotuladas de arquivos para seu espaço de trabalho
Rotular um conjunto de arquivos é como tirar um instantâneo de como eles existiam em um determinado momento. Semanas ou meses depois de obter esse instantâneo, você pode precisar exibir ou trabalhar com os arquivos como eles existiam nesse instantâneo. O seguinte procedimento explica como baixar as versões rotuladas de um conjunto de arquivos para seu espaço de trabalho.
Baixar versões rotuladas de arquivos para seu espaço de trabalho
No Gerenciador do Controle do Código-Fonte, abra o menu de atalho para a coleção de projetos, projeto de equipe, ramificação ou pasta que contenha os itens que você deseja baixar e então escolha Avançado, Obter Versão Específica.
A caixa de diálogo Obter aparece.
Na lista Tipo, selecione Rótulo e digite o nome de rótulo na caixa Rótulo ou selecione as reticências (...) para abrir a caixa de diálogo Localizar Rótulo. Para obter mais informações sobre como usar essa caixa de diálogo, consulte Localizar, editar e remover rótulos.
Revise e, se apropriado, selecione quaisquer das opções adicionais na caixa de diálogo Obter.
Escolha Obter.
Usar a janela Rótulo para trabalhar com rótulos
Depois de abrir a janela Rótulo usando um dos procedimentos acima, você está pronto para começar a trabalhar com o rótulo. Na parte superior da janela, uma caixa exibe o comentário que pode ser editado se desejar.
Você pode usar a janela Rótulo para executar as seguintes tarefas:
Adicionar um item ao rótulo
Remover um item do rótulo
Alterar a versão de um arquivo
Executar outras ações em um item
Adicionar um item ao rótulo
Na janela Rótulo, escolha Adicionar Item.
A caixa de diálogo Escolher Versão do Item aparece.
Na caixa de diálogo Escolher Versão do Item, navegue até o item que você deseja adicionar e então o selecione.
Dica
Você pode pressionar e segurar as teclas CONTROL ou SHIFT e selecionar vários itens.
(Opcional) Se você precisar do rótulo para direcionar uma versão especifica, na lista Versão, selecione:
Última Versão: o rótulo será aplicado à versão mais recente que estiver no controle de versão.
Conjunto de Alterações: especifica o número do conjunto de alterações na caixa Conjunto de Alterações. Como alternativa, selecione as reticências (...) para abrir a caixa de diálogo Localizar Conjuntos de Alterações. Para obter mais informações, consulte Localizar e exibir conjuntos de alterações.
Data: especifique uma data na caixa Data ou selecione uma data do calendário no menu suspenso.
Rótulo: especifique um rótulo existente em que será baseado o novo rótulo. Digite o nome do rótulo na caixa Rótulo, ou selecione as reticências (...) para abrir a caixa de diálogo Localizar Rótulo. Para obter mais informações, consulte Localizar, editar e remover rótulos.
Versão do Espaço de Trabalho: o rótulo será criado para a versão do seu espaço de trabalho.
Escolha OK.
Escolha Arquivo, Salvar.
Remover um item do rótulo
Na janela Rótulo, localize a coleção, projeto de equipe, ramificação, pasta ou arquivo que você deseja remover deste rótulo.
Abra o menu de atalho do item e escolha Remover do Rótulo.
O rótulo é removido do item. Se o item for uma coleção de projeto, um projeto de equipe, uma ramificação ou uma pasta, então o rótulo também será removido de todos os itens que o item contém.
Escolha Arquivo, Salvar.
Alterar a versão de um arquivo
Na janela Rótulo, localize o arquivo que você deseja modificar.
Abra o menu de atalho para o arquivo e escolha Alterar Versão Rotulada.
A caixa de diálogo Alterar Versão Rotulada aparece.
Selecione:
Última Versão: aplique o rótulo à versão mais recente que estiver no controle de versão.
Conjunto de Alterações: especifica o número do conjunto de alterações na caixa Conjunto de Alterações. Como alternativa, selecione as reticências (...) para abrir a caixa de diálogo Localizar Conjuntos de Alterações. Para obter mais informações, consulte Localizar e exibir conjuntos de alterações.
Data: especifique uma data na caixa Data ou selecione uma data do calendário no menu suspenso.
Rótulo: especifique um rótulo existente em que será baseado o novo rótulo. Digite o nome do rótulo na caixa Rótulo, ou selecione as reticências (...) para abrir a caixa de diálogo Localizar Rótulo. Para obter mais informações, consulte Localizar, editar e remover rótulos.
Versão do Espaço de Trabalho: o rótulo será criado para a versão do seu espaço de trabalho.
Escolha Arquivo, Salvar.
Executar outras ações em um item rotulado
Quando você abre o menu de atalho para um item na janela Rótulo, você também pode escolher um dos seguintes comandos:
Trabalhar no prompt de comando
Label Command (Team Foundation Version Control) Aplique ou remova um rótulo.
Dica
Ao usar este comando para aplicar um rótulo, você pode especificar um escopo diferente do projeto de equipe.
Rótulos da lista de Labels Command.
Consulte também
Localizar e exibir conjuntos de alterações
Criar e trabalhar com espaços de trabalho
Referência de permissões para o Team Foundation Server
Usar ramificações para isolar riscos no Controle de versão do Team Foundation
Usar o Gerenciador de Controle do Código-Fonte para gerenciar arquivos sob controle de versão