Configurando as Diretivas de Check-in (Team Explorer Everywhere)

Você pode usar políticas de realização de check-in para reforçar as práticas de desenvolvimento na sua empresa. As diretivas de check-in são impostas quando membros da equipe fazem check-in de alterações. Se você tentar fazer o check-in das alterações pendentes que violem a diretiva, seu check-in será bloqueado. Se necessário, você pode substituir estas diretivas.

Importante

As diretivas de check-in que você define usando o Team Explorer Everywhere apenas se aplicam quando você fizer o check-in usando o Plug-in do Team Foundation Server para Eclipse ou o Cliente de linha de comando de plataforma híbrida para Team Foundation Server. Se você usar outro cliente, como Team Web Access ou Team Explorer em Visual Studio, estas diretivas não se aplicarão. Da mesma forma, as diretrizes que você define usando o Team Web Access ou o Team Explorer em Visual Studio não são aplicáveis quando você faz o check-in usando o Plug-in do Team Foundation Server para Eclipse ou o Cliente de linha de comando de plataforma híbrida para Team Foundation Server.

As diretivas de check-in podem exigir que o usuário tome certas ações quando elas fazem o check-in dos arquivos no controle de versão. Por exemplo, pode ser exigido a um usuário que ele associe um item de trabalho com um conjunto de alterações. Por padrão, os seguintes tipos de diretiva de check-in estão disponíveis:

• Compilações: Requer que a última compilação tivesse êxito antes de um check-in.

  Esta diretiva não coloca uma compilação na fila. Verifica os resultados da compilação mais recente.

• Comentários do Conjunto de Alterações: Exige que os usuários que forneçam um comentário que não seja vazio quando eles se fazem o check-in de alterações pendentes.

• Padrões Proibidos: Impede os usuários de fazer check-in de arquivos que tenham padrões de nome de arquivo proibidos no caminho de servidor da alteração. Você pode fazer isto para evitar alterações a uma seção do seu aplicativo.

• Itens de Trabalho: Requer que um ou mais itens de trabalho estejam associados com o check-in.

• Consultas de itens de trabalho Requer que cada conjunto de alterações que esteja associado com um ou mais itens de trabalho de uma consulta específicada.

Neste tópico

• Adicione Diretivas de Check-in

• Modifique as Diretivas de Check-in

• Habilite ou desabilite Políticas de Check-in

• Remova as Diretivas de Check-in

• Restrinja o Escopo de uma Diretiva de Check-in

Permissões Necessárias

Para concluir este procedimento, você deve ter a permissão Editar informações sobre o nível de projeto definido para Permitir. Para obter mais informações, consulte a seguinte página no site da Microsoft: Permissões do Team Foundation Server.

Adicione Diretivas de Check-in

1. No Gerenciador de Projeto , clique com o botão direito no projeto de equipe para o qual deseja definir as políticas de check-in clique em Políticas de check-in.

   A caixa de diálogo Políticas de Check-in aparece.

2. Clique em Adicionar.

   A caixa de diálogo Adicionar Diretriz de Check-in aparece.

3. Na lista Diretiva de Check-in, especifique o tipo de diretiva que você deseja definir e então clique em OK.

   • Especifique a Política de Compilação se você desejar requerer que uma compilação anterior tenha êxito antes que o check-in de qualquer nova alteração possa ser feito.

   • Especifique Diretriz de Comentários do Conjunto de alterações: se você deseja requerer que os usuários forneçam um comentário que não seja vazio quando eles se fizem o check-in de alterações pendentes.

   • Especifique Diretriz de Padrões Proibidos: se você deseja impedir os usuários de fazer o check-in de arquivos que tenham padrões de nome de arquivo proibidos no caminho de servidor da alteração.

   • Especifique Diretriz de Item de Trabalho se você deseja requerer que um ou mais itens de trabalhos sejam associados a cada conjunto de alterações.

   • Especifique Diretriz de Consulta de Item de Trabalho se você deseja requerer cada conjunto de alterações esteja associado com um ou mais itens de trabalhos da consulta específicada.

   Se você especificou a Política de Compilação, a caixa de diálogo Configurações da Política de Compilação aparecerá: Se você especificou a Política de Consulta de Item de Trabalho, a caixa de diálogo Escolha a sua Consulta aparecerá. Se você especificou a Política de Padrões Proibidos, a caixa de diálogo Padrões Proibidos aparecerá.

4. Se você especificou a Política de Compilação, execute as seguintes tarefas na caixa de diálogo Configurações da Política de Compilação:

   1. Na guia Geral, especifique os itens que devem ser compilados completamente antes de um check-in ser permitido.

      Você pode especificar o arquivo pendente, o projeto que contém o arquivo pendente ou o espaço de trabalho inteiro.

   2. (Opcional) Na guia Marcadores, especifique um ou mais marcadores de recurso da Eclipse que, se localizados com os atributos especificados, impedirão um check-in.

   3. Clique em OK.

5. Se você especificou a Política de Consulta de Item de Trabalho, na caixa de diálogo Escolha a sua Consulta, clique na consulta que define a lista de itens de trabalho que podem ser associadas com um conjunto de alterações e então clique em OK.

6. Se você especificou a Política de Padrões Proibidos, execute as seguintes tarefas na caixa de diálogo Padrões Proibidos :

   1. Em Nova Expressão, digite uma expressão regular que corresponde aos caminhos do servidor de alterações que você deseja desautorizar e então clique em Adicionar.

   2. (Opcional) Adicionar expressões que você deseja desaprovar.

      Observação
      Uma alteração pendente violará a diretiva de check-in se ela for correspondente a quaisquer das expressões regulares configuradas.

   3. Clique em OK para salvar o conjunto de expressões.

7. Se você deseja adicionar outra diretiva de check-in, repita as etapas de 2 a 5.

8. Clique OK para salvar suas alterações.

   Todas as diretivas que você adicionou serão impostas.

Modifique as Diretivas de Check-in

Se você definiu a compilação ou as diretivas de consultas de check-in de itens de trabalho, você pode modificar os detalhes dessas diretivas de check-in. Comentários de conjunto de alterações e diretivas de itens de trabalho não têm detalhes a serem configurados. Você pode remover essas políticas, mas você não pode modificá-las. Para obter mais informações, consulte Remove Check-in Policies.

1. No Gerenciador de Projeto , clique com o botão direito no projeto de equipe para o qual deseja definir as políticas de check-in clique em Políticas de check-in.

   A caixa de diálogo Políticas de Check-in aparece.

2. Na lista, clique na diretiva de check-in que você deseja modificar.

3. Clique em Edit.

4. Se você deseja modificar uma Política de Compilação, execute as seguintes tarefas na caixa de diálogo Configurações da Política de Compilação:

   1. Na guia Geral, especifique os itens que devem ser compilados completamente antes de um check-in ser permitido.

      Você pode especificar o arquivo pendente, o projeto que contém o arquivo pendente ou o espaço de trabalho inteiro.

   2. (Opcional) Na guia Marcadores, especifique um ou mais marcadores de recurso da Eclipse que, se localizados com os atributos especificados, impedirão um check-in.

   3. Clique em OK.

5. Se você deseja modificar uma Política de Consulta de Item de Trabalho, na caixa de diálogo Escolha a sua Consulta, clique na consulta que define a lista de itens de trabalho que podem ser associadas com um conjunto de alterações e então clique em OK.

6. Clique OK para salvar suas alterações.

Habilite ou desabilite Políticas de Check-in

Se você desejar remover temporariamente uma diretiva de check-in, mas retê-la para uso futuro, você pode desabilitá-la. Por exemplo, você pode fazer isto se você configurou uma política de compilação complexa e não quer ter que recriá-la posteriormente.

1. No Gerenciador de Projeto , clique com o botão direito no projeto de equipe para o qual deseja definir as políticas de check-in clique em Políticas de check-in.

   A caixa de diálogo Políticas de Check-in aparece.

2. Na coluna Habilitado da lista, execute uma ou mais das seguintes tarefas:

   • Marque a caixa de seleção que corresponde a uma diretiva de check-in que você deseja habilitar.

   • Desmarque a caixa de seleção que corresponda a uma diretiva de check-in que você deseja desabilitar.

3. Clique OK para salvar suas alterações.

Remova as Diretivas de Check-in

Se você desejar remover uma diretiva de check-in de compilação ou de consulta de check-in de um item de trabalho, você deve desabilitar esta diretiva em vez de removê-la. Desabilitando a diretiva, você retém os detalhes da diretiva e pode reabilitar esta diretiva posteriormente.

1. No Gerenciador de Projeto , clique com o botão direito no projeto de equipe para o qual deseja definir as políticas de check-in clique em Políticas de check-in.

   A caixa de diálogo Políticas de Check-in aparece.

2. Na lista, clique na diretiva de check-in que você deseja remover.

3. Clique em Remove.

4. Clique OK para salvar suas alterações.

Restrinja o Escopo de uma Diretiva de Check-in

Em Team Explorer Everywhere, você pode restringir o escopo de uma diretiva de check-in para controlar a quais arquivos a diretiva se aplica. Você pode especificar uma ou mais expressões regulares para limitar uma política de realização de check-in de forma que ela só é aplicada a itens que correspondam a quaisquer das expressões configuradas. Se nenhuma expressão for especificada, a diretiva de check-in será se aplicada a todos os itens do projeto de equipe.

Expressões de Exemplo

Se você deseja definir uma diretiva que se aplique ao seguinte:	Especifique esta expressão:
Todos os arquivos que terminam com .java	.*\.java$
Todos os itens em um projeto de nome Inventory	^\$/Inventory/.*
Todos os itens em uma pasta de nome Framework	.*/Framework/.*

Você pode testar o escopo de suas expressões antes de salvá-las.

1. No Gerenciador de Projeto , clique com o botão direito no projeto de equipe para o qual deseja definir as políticas de check-in clique em Políticas de check-in.

   A caixa de diálogo Políticas de Check-in aparece.

2. Na lista, clique na diretiva de check-in que você deseja especificar um escopo.

3. Clique em Escopo.

   A caixa de diálogo Expressões de Escopo aparece.

4. Execute uma ou mais das seguintes tarefas:

   • Para adicionar uma expressão, em Nova expressão, digite uma expressão regular e então clique em Adicionar.

     A expressão é acrescentada à lista de expressões na lista Expressões Configuradas.

   • Para remover uma expressão da lista Expressões Configuradas , clique na expressão e então clique em Excluir.

   • Para testar o conjunto de expressões, em Digite um caminho completo do servidor para verificar se as diretrizes serão avaliadas por ele, digite o caminho completo de um item no servidor.

     Por Exemplo, você pode digitar $/AdventureWorks/main/billing-service/src/main/java/com/contoso/billingservice/ClassC.java. Em Resultado, uma mensagem aparece e indica se as diretivas para o caminho especificado serão avaliadas. A mensagem também indica qual expressão regular corresponde ao caminho.

5. Clique OK para salvar suas alterações.

Consulte também

Outros recursos

Definindo e Impondo Portões de Qualidade (Team Explorer Everywhere)