Usar rótulos para tirar um instantâneo dos seus arquivos
Rótulos permitem que você faça um instantâneo dos seus arquivos, para que posteriormente você pode consultar desse snapshot. Usando o seu rótulo, exibir, criar ou até mesmo reverter um conjunto grande de arquivos para o estado em que estavam quando você aplicou o rótulo.
Permissões necessárias
Para aplicar um rótulo, você deve ter o rótulo permissão definida Permitir. Para localizar, lista, ou exibir rótulos, você deve ter o leitura permissão definida Permitir. Para modificar ou excluir um rótulo, você deve possuir o rótulo ou ter o Administrar rótulos permissão definida Permitir.
Neste artigo
O uso de rótulos
Aplicar um rótulo
Renomear um rótulo
Listar, localizar, exibir, editar e remover rótulos
Baixar rotuladas versões dos arquivos ao seu espaço de trabalho.
Use a janela de rótulo para o trabalho com rótulos
Reverter arquivos para uma versão rotulada
Trabalhar com os rótulos da linha de comando
O uso de rótulos
Em muitos projetos de software, quando o código tiver alcançado um nível razoável de qualidade e estabilidade, a equipe irá criar e lançar uma nova versão do produto. A equipe precisa marcar a versão atual de cada arquivo, para que, mesmo que os arquivos de continuarem a alterar, a equipe ainda pode obter e criar a nova versão de cada arquivo em seu projeto.
Teoricamente, você poderia gravar 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 Foundationsimplifica o trabalho: Você pode aplicar um rótulo para a pasta, uma ramificação ou um projeto de equipe que contém os arquivos. Você pode nomear o rótulo que segue a convenção de nomenclatura que você preferir. Alguns exemplos de nomes com rótulo: "Sprint 5", "m1", "beta2" e "Release Candidate 0".
Após aplicar o rótulo, você pode usá-lo para qualificar as operações como, por exemplo, criação, ramificação, mesclagem, comparando e obtenção de versões específicas de arquivos e pastas.
Às vezes, depois de aplicar um rótulo que você decidir que você precise alterá-lo. Controle de versão do Team Foundationpermite que você aplicar um rótulo para arquivos adicionais, para remover um rótulo de determinados arquivos e até mesmo modificar qual versão de um arquivo específico ao qual se aplica o rótulo.
Dica
A aplicação de um rótulo fornece muitas das mesmas vantagens como a criação de uma ramificação, mas geralmente com menor custo e complexidade.
Aplicar um rótulo
Aplicar um rótulo
Em Gerenciador de controle de código-fonte, clique com o botão direito na coleção, projeto de equipe, ramificação, pasta ou arquivo ao qual você deseja aplicar um rótulo e clique em Rótulo Aplicar.
O Nova etiqueta caixa de diálogo aparece.
No nome , digite um nome para o rótulo.
(Opcional) Digite seus comentários no comentário caixa.
No versão lista, Versão mais recente é selecionada por padrão. Essa opção é geralmente usada, mas se você precisar que o rótulo de uma versão específica de destino, selecione uma das seguintes outras opções:
Se você clicar em Changeset, você pode especificar o número de conjunto de alterações no Changeset caixa. Como alternativa, clique em reticências (…) para abrir o Localizar conjuntos de alterações caixa de diálogo. Para obter mais informações, consulte Para obter informações sobre um Changeset.
Se você clicar em Data, você pode especificar uma data de Data caixa ou selecionar uma data no calendário no menu drop-down.
Se você clicar em rótulo, você pode especificar uma etiqueta existente nos quais basear o novo rótulo. Digite o nome do rótulo de rótulo caixa ou clique em reticências (…) para abrir o O rótulo de localizar caixa de diálogo. Para obter mais informações, consulte encontrar, editar e remover rótulos.
Se você clicar em Workspace versão, o rótulo é criado para a versão do espaço de trabalho.
Quando estiver satisfeito com suas configurações, execute uma das seguintes etapas:
Para aplicar a etiqueta, clique em criar.
Para aplicar a etiqueta e modifique-o após ter sido aplicada, clique em criar e editar. Isso se aplica a etiqueta e exibe o rótulo janela. Para obter mais informações sobre como usar o rótulo janela para editar um rótulo, consulte usar a janela de rótulo para trabalhar com etiquetas.
.gif "Observação") Observação |
|---|
Quando você aplica um rótulo usando um nome que já existe, o sistema avisa e pergunta se você deseja continuar. Se você clicar em OK para continuar, todos os itens não contidos no caminho para o qual você está aplicando o rótulo não terão mais esse rótulo. |
Renomear um rótulo
Enquanto você não pode modificar o nome de uma etiqueta existente, você pode aplicar facilmente um novo rótulo para exatamente os mesmos arquivos e as mesmas versões ao qual se aplica a outra etiqueta.
Aplicar um rótulo com base em uma etiqueta existente
No Gerenciador de controle de origem, clique com o botão direito no nó do projeto coleção (o nó raiz) e clique em Rótulo Aplicar.
O Nova etiqueta caixa de diálogo aparece.
No nome , digite um nome para o rótulo.
(Opcional) No comentário , digite um comentário.
Em versão lista, selecione rótulo.
O rótulo caixa é exibida.
Execute uma das seguintes etapas:
Digite o nome da etiqueta existente.
Se você não tiver certeza do nome da etiqueta existente, clique no botão Procurar com reticências (…) ao lado do rótulo caixa.
O O rótulo de localizar caixa de diálogo aparece.
Use as opções no O rótulo de localizar caixa de diálogo para filtrar a lista de rótulos e localizar o rótulo existente à qual deseja aplicar o novo rótulo. (Para obter mais informações, consulte encontrar, editar e remover rótulos.)
Clique em Create.
(Opcional) Após ter criado o novo rótulo, você pode remover o rótulo antigo. Para obter mais informações, consulte encontrar, editar e remover rótulos.
Listar, localizar, exibir, editar e remover rótulos
Há duas maneiras para listar e localizar os rótulos: o Rótulo localizar caixa de diálogo e o rótulo guia de histórico janela. Após localizar o rótulo que você está interessado, você pode, em seguida, visualizá-lo, editá-lo, removê-lo ou trabalhar com os arquivos aos quais se aplica.
Localizar e trabalhar com rótulos usando a caixa de diálogo Localizar etiqueta
No Gerenciador de controle de origem, no arquivo , aponte para O controle de origem, aponte para rótuloe, em seguida, clique em Localizar rótulo.
O O rótulo de localizar caixa de diálogo aparece.
(Opcional) Refine sua pesquisa, realizando uma ou mais das seguintes etapas:
No nome texto, digite o nome da etiqueta.
No projeto , selecione o projeto de equipe que contém o rótulo que você deseja localizar.
No proprietário texto, digite o nome ou alias do proprietário do rótulo.
Clique em Localizar.
O resultados lista exibe rótulos que correspondam 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.
O rótulo janela é exibida. Para obter mais informações, consulte usar a janela de rótulo para trabalhar com etiquetas.
Para excluir um rótulo, selecione-o e clique em Excluir.
Clique em Close.
Às vezes, você pode não ter certeza do nome de um rótulo, mas você sabe que o rótulo foi aplicado a um determinado item sob controle de versão. O procedimento a seguir explica como localizar e trabalhar com um rótulo nessa situação.
Listar e trabalhar com etiquetas que se aplicam a um item específico
Em Gerenciador de controle de código-fonte, clique com o botão direito no item ao qual o rótulo que você deseja localizar aplica e, em seguida, clique em Exibir histórico de.
O histórico janela é exibida.
Clique o rótulos guia para exibir a lista de etiquetas que se aplicam a este item.
(Opcional) Execute uma das seguintes etapas:
Para exibir ou editar um rótulo, clique sobre ela e selecione Editar rótulo.
A janela do rótulo é exibida. Para obter informações sobre como usar essa janela, consulte usar a janela de rótulo para trabalhar com etiquetas.
Para excluir um rótulo, clique sobre ela e selecione Excluir rótulo.
O rótulo com o botão direito e selecione outras ações, como Obter esta versão, e Compare.
Para obter mais informações sobre como usar a guia de rótulo na janela de histórico, consulte Modo de exibição de dados históricos.
Baixar rotuladas versões dos arquivos ao seu espaço de trabalho.
Rotular um conjunto de arquivos é como tirar um instantâneo de como eram em determinado ponto no tempo. Semanas ou meses depois de executar esse snapshot, você talvez precise exibir ou trabalhar com os arquivos conforme ela existiu em que o instantâneo. O procedimento a seguir explica como baixar as versões rotuladas de um conjunto de arquivos para o seu espaço de trabalho.
Download rotulada versões dos arquivos para o seu espaço de trabalho
Em Gerenciador de controle de código-fonte, clique com o botão direito na coleção do projeto, projeto de equipe, branch ou pasta que contém os itens que deseja fazer o download e, em seguida, clique em Obter a versão específica.
O obter caixa de diálogo aparece.
Do tipo de lista, selecione rótulo, e digite o nome de rótulo na rótulo caixa ou clique em reticências (…) para abrir o O rótulo de localizar caixa de diálogo. Para obter mais informações sobre como usar a caixa de diálogo, consulte encontrar, editar e remover rótulos.
Examine e, se apropriado, selecione qualquer uma das opções adicionais de obter caixa de diálogo.
Clique em obter.
Use a janela de rótulo para o trabalho com rótulos
Após abrir a janela de etiqueta usando um dos procedimentos anteriores, você estará pronto para começar a trabalhar com o rótulo. Na parte superior da janela é uma caixa que exibe o comentário, você pode editar se desejar.
Você pode usar a janela de rótulo para realizar as seguintes tarefas:
Adicionar um item para o rótulo.
Remover um item da etiqueta
Alterar a versão de um arquivo.
Realizar outras ações em um item
Adicionar um item para o rótulo.
No rótulo janela, clique em Add Item.
O Escolha a versão do Item caixa de diálogo aparece.
No Escolha a versão do Item caixa de diálogo caixa, navegue até e selecione o item que você deseja adicionar.
Dica
Pressione e mantenha o controle ou as teclas SHIFT e, em seguida, selecionar vários itens.
(Opcional) Se você precisar que o rótulo de uma versão específica de destino, você pode selecionar uma das opções a seguir a partir de versão lista:
Se você clicar em Versão mais recente, o rótulo será aplicado a última versão que está no controle de versão.
Se você clicar em Changeset, você pode especificar o número de conjunto de alterações no Changeset caixa. Como alternativa, clique em reticências (…) para abrir o Localizar conjuntos de alterações caixa de diálogo. Para obter mais informações, consulte Para obter informações sobre um Changeset.
Se você clicar em Data, você pode especificar uma data de Data caixa ou selecionar uma data no calendário no menu drop-down.
Se você clicar em rótulo, você pode especificar uma etiqueta existente nos quais basear o novo rótulo. Digite o nome do rótulo de rótulo caixa ou clique em reticências (…) para abrir o O rótulo de localizar caixa de diálogo. Para obter mais informações, consulte encontrar, editar e remover rótulos.
Se você clicar em Workspace versão, o rótulo é criado para a versão do espaço de trabalho.
Clique em OK.
Clique o arquivo menu e clique Salvar.
Remover um item da etiqueta
No rótulo janela, localize a coleção, o projeto de equipe, a ramificação, a pasta ou arquivo que você deseja remover este rótulo.
Clique com o botão direito no item e selecione Remover o rótulo de.
O rótulo é removido do item. Se o item é uma coleção de projetos, projeto de equipe, filial ou pasta, o rótulo também será removido de todos os itens que ele contém.
Clique o arquivo menu e clique Salvar.
Alterar a versão de um arquivo.
No rótulo janela, localize o arquivo que você deseja modificar.
O arquivo com o botão direito e selecione Versão do Item de alteração.
O Escolha a versão do Item caixa de diálogo aparece.
Execute uma das seguintes etapas:
Clique em Versão mais recente para aplicar a etiqueta para a última versão que está no controle de versão.
Clique em Changesete em seguida, especifique o número de conjunto de alterações no Changeset caixa. Como alternativa, clique em reticências (…) para abrir o Localizar conjuntos de alterações caixa de diálogo. Para obter mais informações, consulte Para obter informações sobre um Changeset.
Clique em Data dee especifique uma data no Data caixa ou selecionar uma data no calendário no menu drop-down.
Clique em rótuloe especifique um rótulo existente nos quais basear o novo rótulo. Digite o nome do rótulo de rótulo caixa ou clique em reticências (…) para abrir o O rótulo de localizar caixa de diálogo. Para obter mais informações, consulte encontrar, editar e remover rótulos.
Clique em Workspace versão, o rótulo é criado para a versão do espaço de trabalho.
Clique o arquivo menu e clique Salvar.
Executar outras ações em um item rotulado
Quando você clica um item na janela do rótulo, você também pode selecionar um dos seguintes comandos:
Modo de exibição (arquivos somente)
Exibir histórico
Comparar (arquivos somente)
Anotar (arquivos somente)
Obter essa versão.
Reverter arquivos para uma versão rotulada
Você pode usar o tf rollback comando Reverter um conjunto de arquivos para o estado em que existia nas versões marcadas por um rótulo. Para obter mais informações, consulte Comando Rollback (Team Foundation Version Control).
Trabalhar com os rótulos da linha de comando
Esta seção fornece algumas das maneiras comuns para trabalhar com os rótulos da linha de comando.
Lista de rótulos da linha de comando
Lista de rótulos de linha de comando
Clique em Iniciar, clique em Todos os programas, aponte para 2010 do Microsoft Visual Studio, aponte para Visual Studio Toolse, em seguida, clique em Visual Studio Prompt de comando (2010).
Tipo de cd caminho, onde caminho é o diretório que contém o espaço de trabalho aplicável.
Type tf labels.
Aplicar e editar os rótulos da linha de comando
A aplicação de um rótulo da linha de comando tem um efeito diferente de aplicar um rótulo usando Visual Studio ALM (conforme descrito anteriormente neste tópico). Quando você usa Visual Studio ALM para aplicar um rótulo que já existe, a operação remove o rótulo de todas as versões de arquivo e, em seguida, aplica o rótulo.
Na linha de comando, no entanto, a operação do rótulo é aditivas. Por exemplo, suponha que você aplicar o rótulo mylabel para $/ DinnerNow/recursos/FeatureTeamA. Se você aplicar posteriormente o rótulo mylabel $/ DinnerNow/recursos/FeatureTeamB, mylabel aplicará para ambas as pastas.
Para aplicar um rótulo da linha de comando
Clique em Iniciar, clique em Todos os programas, aponte para 2010 do Microsoft Visual Studio, aponte para Visual Studio Toolse, em seguida, clique em Visual Studio Prompt de comando (2010).
Tipo de cd caminho, onde caminho é o caminho para a pasta que deseja rotular.
Type tf label mylabel . /recursive.
O sistema aplicará o rótulo mylabel à versão do espaço de trabalho de "caminho" pasta e todos os arquivos e pastas que ele contém.
Remover um rótulo da linha de comando
Para remover rótulos de linha de comando
Clique em Iniciar, clique em Todos os programas, aponte para 2010 do Microsoft Visual Studio, aponte para Visual Studio Toolse, em seguida, clique em Visual Studio Prompt de comando (2010).
Tipo de cd caminho, onde caminho é o diretório que contém o espaço de trabalho aplicável.
Tipo de tf label /delete nome de rótulo, onde nome de rótulo é o nome da etiqueta que você deseja excluir.
Consulte também
Referência
Comando Label (Team Foundation Version Control)
Conceitos
Trabalhando com conjuntos de alterações
Configurar a sua máquina de desenvolvimento para trabalhar com projeto do sua equipe
Permissões de Team Foundation Server
Usando o Gerenciador de controle de código-fonte