Use Rótulos para Obter um Instantâneo de Seus Arquivos (Team Explorer Everywhere)
Usando rótulos, você pode obter um instantâneo de seus arquivos para consultar posteriormente. Usando um rótulo, você pode exibir, compilar ou até mesmo reverter um conjunto grande de arquivos para o estado que eram quando o rótulo foi aplicado.
Quando você compilar seu aplicativo usando o Team Foundation Build, os arquivos em seu aplicativo serão, por padrão, rotulados automaticamente com o número de compilação como parte do processo de compilação.
Neste tópico
Uses for Labels
Apply a Label
Rename a Label
List, Find, View, Edit, and Remove Labels
Retrieve Labeled Versions of Files to your Workspace
Modify a Label Definition by Using the Label Window
Permissões Necessárias
Para aplicar um rótulo, sua permissão Rótulo deve ser definida para Permitir. Para localizar, listar ou exibir rótulos, sua permissão Ler deve ser definida para Permitir. Para modificar ou excluir um rótulo, você deve possuí-lo ou as permissões no Administras Rótulos deve ser definidas para Permitir. Para obter mais informações, consulte o seguinte tópico no site da Microsoft: Permissões do Team Foundation Server.
Usos para os rótulos
Em muitos projetos de software, a equipe compilará e liberará uma nova versão do produto quando o código alcançar um nível razoável de qualidade e estabilidade. A equipe deve marcar a versão atual de cada arquivo de forma que, até mesmo se os arquivos continuem alterando, a equipe ainda pode obter e compilar a versão de lançamento de todo arquivo no projeto.
Teoricamente, você pode registrar manualmente a ID de cada conjunto de alterações para cada arquivo, mas este tipo de processo não é claramente prático. Você pode usar o Controle de versão do Team Foundation para simplificar esta tarefa. Você aplica um rótulo para a pasta, ramificação ou projeto de equipe que contém os arquivos. Você pode nomear um título que segue qualquer convenção de nomenclatura você prefira. Os seguintes sequências de caracteres são alguns exemplos de nomes de rótulo: "Sprint 5", "M1", "Beta2", and "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.
Depois que você aplicar um rótulo, você pode decidir alterar os arquivos aos quais ele se aplica. Você pode usar o Controle de versão do Team Foundation para aplicar um rótulo aos arquivos adicionais, remover um rótulo de determinados arquivos e até mesmo modificar qual a versão de um arquivo específico à qual o rótulo se aplica.
.gif "Observação") Observação |
|---|
Aplicando um rótulo, você ganha muitos dos mesmos benefícios dos da criação de uma ramificação, mas normalmente você reduz o custo e complexidade do processo. |
Aplique um Rótulo
Quando você usar o Plug-in do Team Foundation Server para Eclipse 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. Porém, a operação de rotulação é aditiva quando você usar o Cliente de linha de comando de plataforma híbrida para Team Foundation Server. Por exemplo, você pode aplicar o rótulo MyLabel para $/DinnerNow/Features/FeatureTeamA. Se você se aplicar isto posteriormente ao $/DinnerNow/Features/FeatureTeamB, o rótulo se aplicará a ambas as pastas.
Para aplicar um rótulo do Gerenciador do Controle do Código-Fonte
Abrir o Gerenciador do Controle de Código-Fonte.
Para obter mais informações, consulte Open Source Control Explorer.
Em Gerenciador de Controle do Código-Fonte, clique com o botão direito na coleção de projeto de equipe, projeto de equipe, ramificação, pasta ou arquivo que você deseja aplicar um rótulo e então clique em Aplicar Rótulo.
A Caixa de diálogo Novo Rótulo aparece.
Em Nome, digite um nome para o rótulo.
(Opcional) Em Comentário, digite seus comentários.
Na lista Versão, o valor padrão é Última Versãoque é normalmente o mais usado.
(Opcional) Se você deseja que o rótulo seja destinado à uma versão específica, você pode clicar em um das seguintes opções da lista Versão:
Se você clicar em Conjunto de Alterações, poderá especificar o número do conjunto de alterações na caixa Conjunto de Alterações. Como alternativa, você também pode clicar nas reticências (...) para abrir a caixa de diálogo Localizar Conjuntos de alterações.
Para obter mais informações, consulte Search for a Changeset.
Se você clicar em Data, você pode especificar uma data na caixa Data ou pode especificar uma data do calendário no menu suspenso.
Se você clicar em Rótulo, você pode especificar um rótulo existente para basear o novo rótulo. Digite o nome do rótulo na caixa Rótulo , ou clique nas reticências (...) para abrir a caixa de diálogo Localizar Rótulo.
Para obter mais informações, consulte List, Find, View, Edit, and Remove Labels.
Se você clicar em Versão de Espaço de Trabalho, o rótulo será criado para a versão no seu espaço de trabalho.
Quando você estiver satisfeito com suas configurações, execute uma das seguintes etapas:
Para aplicar o rótulo, clique em Criar.
Para aplicar o rótulo e então modificá-lo depois de ser aplicado, clique em Criar, e especifique o Continuar Editando. Esta ação aplica o rótulo e então exibe a janela Novo Rótulo. Esta janela executa as mesmas funções da janela Editar Rótulo. Para obter mais informações sobre como usar a janela Editar Rótulo para alterar um rótlo, consulte Modify a Label Definition by Using the Label Window.
| Observação |
|---|
Se você usar o Plug-in do Team Foundation Server para Eclipse para aplicar um rótulo que já exista, você será receberá um aviso perguntando se deseja continuar. Se você clicar em 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. |
Para aplicar um rótulo a um prompt de comando
A um prompt de comando, digite tf label Label ItemSpec e pressione ENTER. Substitua Label pelo nome que você deseja usar para rotular os arquivos. Substitua ItemSpec pelo arquivo ou pasta que você deseja rotular. Se você desejar rotular todos os conteúdo de uma pasta, digite tf label Label . -recursive.
Para obter mais informações, consulte a seguinte página no site da Microsoft: Comando Rotular (Controle de Versão da Team Foundation).
Renomear um Rótulo
Você não pode modificar o nome de um rótulo existente, mas você pode facilmente aplicar um rótulo diferente aos mesmos arquivos e mesmas versões às quais está aplicado outro rótulo.
Para aplicar um rótulo baseado em um rótulo existente no Gerenciador do Controle do Código-Fonte
Abrir o Gerenciador do Controle de Código-Fonte.
Para obter mais informações, consulte Open Source Control Explorer.
Em Gerenciador de Controle do Código-Fonte, clique com o botão direito na coleção de projeto (o nó raiz) e então clique em Aplicar Rótulo.
A Caixa de diálogo Novo Rótulo aparece.
Em Nome, digite um nome para o rótulo.
(Opcional) Na caixa de Comentário, digite seus comentários.
Na lista Versão, clique em 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, clique no 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 List, Find, View, Edit, and Remove Labels.
Clique em Create.
(Opcional) Depois que você criar o rótulo, pode remover o rótulo antigo.
Para obter mais informações, consulte List, Find, View, Edit, and Remove Labels.
Liste, Localize, Exiba, Edite e Remova Rótulos
No Plug-in do Team Foundation Server para Eclipse, você deve usar a caixa de diálogo Localizar Rótulo para listar e localizar um rótulo. Depois de localizar o rótulo que você deseja, você pode exibir, editar, remover ou trabalhar com os arquivos aos quais ele se aplica.
Para listar nomes usando a caixa de diálogo Localizar Rótulo
Abrir o Gerenciador do Controle de Código-Fonte.
Para obter mais informações, consulte Open Source Control Explorer.
Em Gerenciador de Controle do Código-Fonte, clique com o botão direito em qualquer nó e então clique em Localizar Rótulo.
A Caixa de diálogo Localizar Rótulo aparece.
(Opcional) Refinar sua pesquisa executando uma ou mais das seguintes etapas:
Em Nome, digite o nome do rótulo.
Na lista Projeto, clique no projeto de equipe que contenha o nome que você deseja localizar.
Em Proprietário, digite o nome ou alias do proprietário do rótulo.
Clique em 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 alterar um rótulo, clique nele e então clique em Editar.
A caixa Rótulo aparece. Para obter mais informações, consulte Modify a Label Definition by Using the Label Window.
Para excluir um rótulo, clique-o e então clique em Excluir.
Clique em Close.
Para listar rótulos em um prompt de comando
Do prompt de comando, altere diretórios à pasta que corresponde ao espaço de trabalho Team Foundation Server para o qual você deseja visualizar rótulos.
Digite tf labels e então pressione ENTER.
Aparece uma lista de rótulos no espaço de trabalho Team Foundation Server atual. Você pode especificar a opção de -format:detailed para exibir mais informações sobre os rótulos. Para obter mais informações, consulte a seguinte página no site da Microsoft: Comando Rótulos (Controle de Versão da Team Foundation).
Para remover um rótulo em um prompt de comando
Do prompt de comando, altere diretórios à pasta que corresponde ao espaço de trabalho Team Foundation Server do qual você deseja remover um rótulo.
Digite tf label –delete Label e pressione ENTER.
Substitua Label pelo nome do rótulo que você deseja remover. Para obter mais informações, consulte a seguinte página no site da Microsoft: Comando Rotular (Controle de Versão da Team Foundation).
Recupere Versões Rotuladas de Arquivos a seu Espaço de Trabalho
Se você rotular um conjunto de arquivos, você estará criando um instantâneo deles em um momento determinado. Semanas ou meses depois que você obter este instantâneo, você pode exibir ou trabalhar com os arquivos como eles existiam naquele instantâneo. O seguinte procedimento explica como baixar as versões rotuladas de um conjunto de arquivos para seu espaço de trabalho.
Para recuperar versões rotuladas de arquivos
Abrir o Gerenciador do Controle de Código-Fonte.
Para obter mais informações, consulte Open Source Control Explorer.
Em Gerenciador de Controle do Código-Fonte, clique com o botão direito na coleção, projeto de equipe, ramificação ou pasta que contenha os itens que você deseja baixar e então clique em Obter Versão Específica.
A caixa de diálogo Obter aparece.
Na lista Tipo, clique em Rótulo, e então digitar qualquer tipo de nome de rótulo na caixa Rótulo ou clicar nas reticências (...) para abrir a caixa de diálogo Localizar Rótulo.
Para obter mais informações sobre como usar esta caixa de diálogo, consulte List, Find, View, Edit, and Remove Labels.
Revise e, se apropriado, especifique quaisquer das opções adicionais na caixa de diálogo Obter.
Clique em Obter.
Para recuperar versões rotuladas de arquivos em um prompt de comando
Do prompt de comando, altere diretórios à pasta que corresponde ao espaço de trabalho Team Foundation Server para o qual você deseja recuperar arquivos.
Digite tf get /version:LLabel ItemSpec e pressione ENTER. Substitua Label pelo nome do rótulo que você deseja recuperar. Substitua ItemSpec pelo nome da pasta ou arquivo que você deseja recuperar. Você pode omitir o ItemSpec para recuperar todos os itens que têm o título que você especificou.
Para obter mais informações, consulte a seguinte página no site da Microsoft: Comando Obter (Controle de Versão da Team Foundation).
Modifique uma Definição de Rótulo
Depois de abrir a janela Editar 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 exibirá o comentário, que é editável.
Na janela de Rótulo, você pode executar as seguintes tarefas:
Aplique um item ao rótulo.
Remova o rótulo de um item.
| Observação |
|---|
Antes de iniciar estes procedimentos, voce deve estar com a janela Editar Rótulo aberta. Para obter mais informações, consulte List, Find, View, Edit, and Remove Labels ou Apply a Label. |
Para alterar a versão de um arquivo que é rotulado, você deve remover o rótulo daquele arquivo e reaplicá-lo à versão que você deseja usar.
Para aplicar um rótulo ao item
Na janela Editar Rótulo , clique em Adicionar.
Na caixa de diálogo Selecionar Item para Rotular, localize e então clique no item que você deseja aplicar o rótulo.
(Opcional) Na lista Versão , você pode clicar em uma das seguintes opções caso deseje aplicar rótulo a uma versão específica:
Se você clicar em Última Versão, o rótulo será aplicado à versão mais recente no controle de versão.
Se você clicar em Conjunto de Alterações, poderá especificar o número do conjunto de alterações na caixa Conjunto de Alterações. Como alternativa, você também pode clicar nas reticências (...) para abrir a caixa de diálogo Localizar Conjuntos de alterações.
Para obter mais informações, consulte Search for a Changeset.
Se você clicar em Data, você pode especificar uma data na caixa Data ou pode especificar uma data no calendário no menu suspenso.
Se você clicar em Rótulo, você pode especificar um rótulo existente para basear o novo rótulo. Digite o nome do rótulo na caixa Rótulo , ou clique nas reticências (...) para abrir a caixa de diálogo Localizar Rótulo
Para obter mais informações, consulte List, Find, View, Edit, and Remove Labels.
Se você clicar em Versão de Espaço de Trabalho, o rótulo será criado para a versão no seu espaço de trabalho Team Foundation Server .
Clique em OKe então clique em OK para aceitas as alterações no rótulo.
Para remover o rótulo de um item
Na janela Editar Rótulo, clique na coleção, projeto de equipe, ramificação, pasta ou arquivo que você deseja remover este rótulo.
Clique em Remove.
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, o rótulo também será removido de todos os itens que o item contém.
Clique em OK para aceitar as alterações no rótulo.
Consulte também
Outros recursos
Usando o Controle de Versão (Team Explorer Everywhere)
Trabalhando com Conjuntos de alterações (Team Explorer Everywhere)
Trabalhando com Espaços de Trabalho Team Foundation Server (Team Explorer Everywhere)