Use Rótulos para Obter um Instantâneo de Seus Arquivos

Rótulos permitem obter um instantâneo de seus arquivos para que em outro dia você pode consultar novamente a aquele instantâneo.Usando seu rótulo, você pode exibir, compilar, ou até mesmo reverter um grande conjunto de arquivos do estado que eram quando você aplicar o rótulo.

Permissões exigidas

Para aplicar um rótulo, você deve ter o conjunto de permissões de Rótulo a Permitir.Para localizar, para listar, ou visualizar rótulos, você deve ter o conjunto de permissões de Ler a Permitir.Para modificar ou excluir um rótulo, você deve possuir o rótulo ou ter o conjunto de permissões de Administre rótulos a Permitir.

Em este artigo

• Usando rótulos

• Aplique um Rótulo

• Renomear um Rótulo

• Listar, localize, exibir, editar e remova rótulos

• Baixe versões rotuladas de arquivos para seu espaço de trabalho

• Usar a janela do rótulo para trabalhar com rótulos

• Revertendo arquivos a uma versão rotulado

• Trabalhar do prompt de comando

Usando rótulos

Em muitos projetos de software, quando o código alcançar um nível razoável de qualidade e estabilidade, a equipe compilará e liberará uma nova versão do produto.A equipe precisa usar a versão atual de cada arquivo para que mesmo se os arquivos continuem alterando, a equipe ainda pode obter e criar a nova versão de cada arquivo em seu projeto.

Teoricamente, você pode registrar a identificação de cada conjunto de alterações para cada arquivo manualmente; mas claramente esse tipo de processo não é prático.Controle de versão do Team Foundation faz o trabalho simples: Você aplicar um rótulo a pasta, a ramificação, ou para o projeto de equipe que contém os arquivos.Você pode nomear um título que segue qualquer convenção de nomenclatura você prefira.Alguns exemplos de nomes de rótulo incluem: “Sprint 5 ", “M1”, “Beta2”, e “release candidate 0 ".

Depois que você aplicar o rótulo, você pode usar-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.

A as vezes depois que você aplicar um rótulo você decidir que você precisa de alterar.Controle de versão do Team Foundation permite aplicar um rótulo a arquivos adicionais, remova o rótulo de certos arquivos, e para alterá-la mesmo que versão de um arquivo específico para que o rótulo se aplica.

Dica
Aplicar um rótulo fornece muitos dos mesmos benefícios que criando uma ramificação, mas normalmente com mais barato e complexidade.

Aplique 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 aplica-o.De o prompt de comando, no entanto, a operação de rótulo é aditiva.Consulte Label Command.

Aplicar um rótulo

1. Em Gerenciador do Controle do Código-Fonte, abra o menu de atalho na coleção, projeto de equipe, ramificação, a, pasta ou arquivo que você deseja aplicar um rótulo e escolha Avançado, Aplicar Rótulo.

   A Caixa de diálogo Novo Rótulo aparece.

2. Em a caixa de Nome , digite um nome para o rótulo.

3. (Opcional) digite seus comentários na caixa de Comentário .

4. Em a lista de Versão , Última Versão é selecionado por padrão.Essa opção é aquela usada mais geralmente, mas se você precisar o rótulo alvo uma versão específica, selecione:

   • Conjunto de Alterações: Especificar o número do conjunto de alterações na caixa de Conjunto de Alterações .Como alternativa, escolha**…**as reticências () para abrir a caixa de diálogo de Localizar conjuntos de alterações .Para mais informações, consulte Localizar e exibir conjuntos de alterações.

   • Data: Especificar uma data na caixa de Data ou selecione uma data no calendário no menu suspenso.

   • Rótulo: Especificar um rótulo existente para basear o novo rótulo.Digite o nome de rótulo na caixa de Rótulo , ou escolha**…**as reticências () para abrir a caixa de diálogo de Localizar Rótulo .Para obter mais informações, consulte Localize, editar, e remova rótulos.

   • Versão de espaço de trabalho: O rótulo é criado para a versão em seu espaço de trabalho.

5. Quando você estiver satisfeito com suas configurações, execute uma das seguintes etapas:

   • Para aplicar um rótulo, escolha Criar.

   • Para aplicar um rótulo e então modificá-lo depois que foi aplicada, escolha Criar e Editar.Isso aplicar o rótulo e então exibe a janela de Rótulo .Para obter mais informações sobre como usar a janela de Rótulo para editar um rótulo, consulte Usar a janela do rótulo para trabalhar com rótulos.

Observação
Quando você aplicar um rótulo usando um nome que já existe, o sistema adverte-o e pergunta-o se você deseja continuar.Se você escolher OK para continuar, todos os itens não contidos no caminho que você está aplicando um rótulo não terá esse rótulo.

Renomear um Rótulo

Quando você não pode alterar o nome de um rótulo existente, você pode facilmente aplicar um novo rótulo exatamente aos mesmos arquivos e mesmas versões que a outro rótulo se aplica.

Aplicar um rótulo baseada em um rótulo existente

1. Em o controle de O código-fonte, abra o menu de atalho para o nó da coleção de projeto (o nó raiz), e depois escolha Avançado, Aplicar Rótulo.

   A Caixa de diálogo Novo Rótulo aparece.

2. Em a caixa de Nome , digite um nome para o rótulo.

3. (Opcional) na caixa de Comentário , digite um comentário.

4. Em a lista de Versão , Rótuloselecione.

   A caixa Rótulo aparece.

5. 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, escolha o botão procurar com as reticências (…) ao lado da caixa de 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 Localize, editar, e remova rótulos.)

6. Escolha Criar.

7. (Opcional) depois de criar o novo rótulo, você pode remover o rótulo antigo.Para obter mais informações, consulte Localize, editar, e remova rótulos.

Listar, localize, exibir, editar e remova rótulos

Há duas maneiras para listar rótulos e localizar: a caixa de diálogo de Localizar Rótulo e o guia de Rótulo na janela de Histórico .Depois de localizar o rótulo que você está interessado, você pode exibir, editá-lo, remova-a, ou trabalhar-lo com os arquivos para o qual se aplica.

Localizar e trabalhar com rótulos usando a caixa de diálogo de rótulo de localização

1. Em o controle de O código-fonte, na barra de menu escolha Arquivo, Controle de Código-fonte, Localizar, Localizar Rótulo.

   A Caixa de diálogo Localizar Rótulo aparece.

2. (Opcional) Refinar sua pesquisa executando uma ou mais das seguintes etapas:

   • Em a caixa de texto de Nome , digite o nome do rótulo.

   • Em a lista de Projeto , selecione o projeto de equipe que contenha o nome que você deseja localizar.

   • Em a caixa de texto de Proprietário , digite o nome ou alias do proprietário do rótulo.

3. Escolha Localizar.

   A lista Resultados exibe rótulos que correspondem aos critérios de pesquisa que você inseriu.

4. (Opcional) Execute uma das seguintes etapas:

   • Para exibir ou editar um rótulo, selecione e escolha Editar.

     A caixa Rótulo aparece.Para obter mais informações, consulte Usar a janela do rótulo para trabalhar com rótulos.

   • Para excluir um rótulo, selecione e escolha Excluir.

   • Escolha Fechar.

A as vezes você não pode ser certeza do nome de um rótulo, mas você souber que o rótulo foi aplicada a um item específico sob controle de versão.O procedimento a seguir explica como localizar em esta situação e trabalhar com um rótulo.

Listar e trabalhar com rótulos que se aplicam a um item específico

1. Em o controle de O código-fonte, abra o menu de atalho para o item que o rótulo que você deseja localizar se aplica, e então escolha Exibir Histórico.

   a janela de Histórico aparece.

2. Escolha a guia de Rótulos para exibir a lista de rótulos que se aplicam a este item.

3. (Opcional) Execute uma das seguintes etapas:

   • Para exibir ou editar um rótulo, abra o menu de atalho e escolha Editar rótulo.

     A caixa Rótulo aparece.Para obter informações sobre como usar essa janela, consulte Usar a janela do rótulo para trabalhar com rótulos.

   • Para excluir um rótulo, abra o menu de atalho e escolha 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 o guia do rótulo na janela histórico, consulte Obter o histórico de um Item.

Baixe versões rotuladas de arquivos para seu espaço de trabalho

Rotular um conjunto de arquivos é como a tomada de um instantâneo de que existiram em algum ponto no tempo.Semanas ou meses depois que você obter este instantâneo, você pode precisar exibir ou trabalhar com os arquivos como existiam em aquele instantâneo.O seguinte procedimento explica como baixar as versões rotuladas de um conjunto de arquivos para seu espaço de trabalho.

Baixe versões rotuladas de arquivos para seu espaço de trabalho

1. Em o controle de O código-fonte, abra o menu de atalho para a coleção de projeto, projeto de equipe, ramificação, ou pasta que contém os itens que você deseja baixar e escolha Avançado, Obter Versão Específica.

   A caixa de diálogo Obter aparece.

2. Em a lista de Tipo , Rótuloselecione, e então digite o nome de rótulo na caixa de Rótulo , ou clique nas reticências (…) para abrir a caixa de diálogo de Localizar Rótulo .Para obter mais informações sobre como usar esta caixa de diálogo, consulte Localize, editar, e remova rótulos.

3. A revisão e, se apropriado, selecione as opções adicionais na caixa de diálogo de Obter .

4. Escolha Obter.

Usar a janela do rótulo para trabalhar com rótulos

Depois que você abrir a janela do rótulo usando um dos procedimentos anteriores, você está pronto para começar a trabalhar com o rótulo.Em a parte superior da janela é uma caixa que exibe o comentário, que é editável.

Você pode usar a janela do 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

1. Em a janela de Rótulo , escolha Adicionar Item.

   a caixa de diálogo de Escolher Versão do Item aparece.

2. Em a caixa de diálogo, navegue até Escolher Versão do Item e selecione o item que você deseja adicionar.

   Dica
   Você pode pressionar e manter o CONTROLE ou as teclas SHIFT e selecionar vários itens.

3. (Opcional) se você precisar o rótulo alvo uma versão específica, da lista de, selecione Versão :

   • Última Versão: O rótulo será aplicada para a versão mais recente que está em controle de versão.

   • Conjunto de Alterações: Especificar o número do conjunto de alterações na caixa de Conjunto de Alterações .Como alternativa, escolha**…**as reticências () para abrir a caixa de diálogo de Localizar conjuntos de alterações .Para mais informações, consulte Localizar e exibir conjuntos de alterações.

   • Data: Especificar uma data na caixa de Data ou selecione uma data no calendário no menu suspenso.

   • Rótulo: Especificar um rótulo existente para basear o novo rótulo.Digite o nome de rótulo na caixa de Rótulo , ou escolha**…**as reticências () para abrir a caixa de diálogo de Localizar Rótulo .Para obter mais informações, consulte Localize, editar, e remova rótulos.

   • Versão de espaço de trabalho: O rótulo é criado para a versão em seu espaço de trabalho.

4. Escolha OK.

5. Escolha Arquivo, Salvar.

Remover um item do rótulo

1. Em a janela de Rótulo , localize a coleção, projeto de equipe, ramificação, a, pasta ou arquivo que você deseja remover de este rótulo.

2. Abra o menu de atalho para o item e escolha Remova de rótulo.

   O rótulo é removido do item.Se o item é uma coleção de projeto, projeto de equipe, ramificação, pasta ou, então o rótulo também será removido de todos os itens que ele contém.

3. Escolha Arquivo, Salvar.

Alterar a versão de um arquivo

1. Em a janela de Rótulo , localize o arquivo que você deseja alterar.

2. Abra o menu de atalho para o arquivo e escolha Alterar Versão Rotulada.

3. a caixa de diálogo de Alterar Versão Rotulada aparece.

4. Select:

   • Última Versão: Aplicar o rótulo para a versão mais recente que está em controle de versão.

   • Conjunto de Alterações: Especificar o número do conjunto de alterações na caixa de Conjunto de Alterações .Como alternativa, escolha**…**as reticências () para abrir a caixa de diálogo de Localizar conjuntos de alterações .Para mais informações, consulte Localizar e exibir conjuntos de alterações.

   • Data: Especificar uma data na caixa de Data ou selecione uma data no calendário no menu suspenso.

   • Rótulo: Especificar um rótulo existente para basear o novo rótulo.Digite o nome de rótulo na caixa de Rótulo , ou escolha**…**as reticências () para abrir a caixa de diálogo de Localizar Rótulo .Para obter mais informações, consulte Localize, editar, e remova rótulos.

   • Versão de espaço de trabalho: O rótulo é criado para a versão em seu espaço de trabalho.

5. Escolha Arquivo, Salvar.

Executar outras ações em um item rotulado

Quando você abre o menu de atalho para um item na janela de rótulo, você também pode optar um dos seguintes comandos:

• Modo de Visualização (arquivos somente)

• Exibir Histórico

• compare (arquivos somente)

• Anotar (arquivos somente)

• Obter esta versão

Trabalhar do prompt de comando

• Label Command aplica ou remove um rótulo.

  Dica
  Quando você usa esse comando para aplicar um rótulo, você pode especificar um escopo diferente do projeto de equipe.

• Rótulos da lista deLabels Command .

Consulte também

Conceitos

Localizar e exibir conjuntos de alterações

Gerenciar seus espaços de trabalho

Team Foundation Permissões do servidor

Usar o Gerenciador do Controle do Código-Fonte para gerenciar arquivos em controle de versão

Outros recursos

Isolar o risco usando ramificações