Adicionar uma consulta a um modelo de processo

  • Artigo

Você pode definir o conjunto inicial de consultas de equipe para um projeto de equipe. Consultas de itens de trabalho especificar critérios para gerar uma lista de itens de trabalho, como, por exemplo, uma lista de bugs ativos ou fechadas de tarefas. Arquivos de consulta de item de trabalho têm uma extensão de .wiq e são armazenados na subpasta da pasta de rastreamento de item de trabalho para os modelos de processo de Microsoft Solutions Framework (MSF) consultas. Por exemplo, o MSF for Agile Software Development define uma consulta de Bugs ativos é definida no arquivo ActiveBugs.wiq.

Neste tópico

  • Criando um arquivo de consulta do Item de trabalho

  • Criar uma consulta de Item de trabalho que faz referência a um caminho de iteração

  • Exemplo de uma consulta de Item de trabalho específicos de iteração

  • Especificando consultas a serem carregados

Para obter informações sobre como atribuir permissões de consulta para grupos, consulte Controlando o acesso a áreas funcionais. Para obter informações sobre como criar pastas de consulta, consulte Definir e personalizar objetos para controlar os itens de trabalho usando o plug-in de WorkItems.

Permissões necessárias

Para criar uma consulta, você deve ser um membro da leitores group, ou seu Exibir itens de trabalho nesse nó permissão deve ser definida Permitir para cada projeto de equipe na consulta. Para salvar uma consulta como uma consulta de equipe, você deve ter as permissões apropriadas definidas. Para obter mais informações, consulte Organizar e definir permissões em consultas de itens de trabalho.

Criando um arquivo de consulta do Item de trabalho

A maneira mais fácil para você criar um arquivo de consulta do item de trabalho é usar Team Explorer. Em um projeto de equipe existente, use Team Explorer para criar todas as consultas de item de trabalho que você precisa para seu processo. Em seguida, siga estas etapas para salvar cada consulta de item de trabalho como um arquivo .wiq. Para obter mais informações sobre como criar consultas de itens de trabalho, consulte Especificar critérios de filtro de consulta.

Para salvar uma consulta de item de trabalho para um arquivo de .wiq

  1. Em Team Explorer, a consulta com o botão direito e selecione A consulta de modo de exibição.

  2. Do arquivo menu, selecione Salvar < nome da consulta > [Query] As.

  3. No Salvar consulta como caixa de diálogo, selecione o arquivo opção e digite um nome de arquivo e local para o arquivo .wiq. Como alternativa, clique em Procurar, digite um nome de arquivo, navegue até o local para salvar o arquivo e clique em Salvar.

  4. Copie o arquivo para o \WorkItem Tracking\Queries pasta, que está localizada na pasta em que você baixou o seu modelo de processo.

  5. Abra o arquivo wiq em um editor de texto.

  6. Remover o <TeamFoundationServer> e <TeamProject> elementos associar a consulta um servidor específico que está executando o Visual Studio Team Foundation Server e um projeto de equipe específico, como mostra o exemplo a seguir:

    <TeamFoundationServer>ServerURL</TeamFoundationServer>
<TeamProject>ProjectName</TeamProject>
    ObservaçãoObservação

    Você deve editar o arquivo .wiq em um editor de texto e remover o <TeamFoundationServer> e <TeamProject> elementos associar a consulta um projeto de equipe e de servidor específico. Caso contrário, a consulta não funcionará corretamente se o modelo de processo é carregado em um servidor diferente. Como alternativa, use macros, onde é possível para que sua consulta não contém o nome explícito do atual projeto de equipe ou outros valores explícitos que são específicos para um determinado ambiente.

  7. Remova todos os elementos adicionais que são específicos a um usuário.

Criar uma consulta de Item de trabalho que faz referência a um caminho de iteração

Você pode definir uma consulta que faz referência a um caminho de iteração específica, incluindo a macro para o projeto de equipe, $$ PROJECTNAME$ $ e o nome de um caminho de iteração é definido no arquivo de plug-in de classificação. Por exemplo, a seguinte sintaxe de consulta Especifica para incluir somente os itens de trabalho cujo caminho de iteração está na iteração 1.

AND  [Source].[System.IterationPath] UNDER '$$PROJECTNAME$$\Iteration 1'

Quando o projeto de equipe é criado, a macro é substituída com o nome do projeto da equipe.

Usando essa macro, você pode definir as pastas de trabalho que fazem referência a caminhos de iteração específica. O modelo de processo de desenvolvimento de software ágil da MSF contém uma consulta específica de iteração, Iteration1Backlog.wiq, que oferece suporte para a pasta de trabalho específicos de iteração, Backlog.xlsm de iteração.

Quando você fizer o upload de consultas específicas de iteração, certifique-se de que a tarefa para processar o arquivo Classification.xml vem antes da tarefa para processar os arquivos de consulta. Para obter mais informações, consulte Definindo as áreas de iniciais e iterações usando o arquivo de plug-in do Classification.xml e Definindo as tarefas de raiz usando o arquivo de plug-in do modelo de processo.

Exemplo de uma consulta de Item de trabalho específicos de iteração

O exemplo a seguir mostra a consulta de item de trabalho de Iteration1Backlog é definida para oferecer suporte a pasta de trabalho da lista de pendências de iteração.

<?xml version="1.0" encoding="utf-8"?>
<WorkItemQuery Version="1">
  <Wiql>
    SELECT [System.Id],
           [System.WorkItemType],
           [System.Title],
           [System.State],
           [System.AssignedTo],
           [Microsoft.VSTS.Scheduling.RemainingWork],
           [Microsoft.VSTS.Scheduling.CompletedWork],
           [Microsoft.VSTS.Scheduling.StoryPoints],
           [Microsoft.VSTS.Common.StackRank],
           [Microsoft.VSTS.Common.Priority],
           [Microsoft.VSTS.Common.Activity],
           [System.IterationPath],
           [System.AreaPath]
      FROM WorkItemLinks
     WHERE (Source.[System.TeamProject] = @project 
       AND  [Source].[System.AreaPath] UNDER @project
       AND  [Source].[System.IterationPath] UNDER '$$PROJECTNAME$$\Iteration 1'
       AND (
               Source.[System.WorkItemType] = 'User Story' 
            OR Source.[System.WorkItemType] = 'Task'
           )
           )
       AND [System.Links.LinkType] = 'System.LinkTypes.Hierarchy-Forward'
       AND [Target].[System.WorkItemType] = 'Task'
       ORDER BY [Microsoft.VSTS.Common.StackRank], [Microsoft.VSTS.Common.Priority]
       mode(Recursive)
  </Wiql>
</WorkItemQuery>

Especificando consultas a serem carregados

Para incluir as consultas de item de trabalho no modelo de processo, crie uma ou mais tarefas no arquivo do arquivo WorkItems. XML, você pode encontrar no o rastreamento de \WorkItem a pasta, localizada na pasta em que você baixou o seu modelo de processo. Usar <Query> elemento para especificar o arquivo de consulta do item de trabalho correto.

<Query name="Active Bugs" fileName="WorkItem Tracking\Queries\filename.wiq" />

O exemplo a seguir mostra como especificar uma tarefa que cria a consulta de item de trabalho de todas as histórias de usuários no MSF for agile software development. Esta tarefa não pode ser executado até que todos os tipos de item de trabalho são criados.

<task
   id="Queries"
   name="Stored Query Definitions"
   plugin="Microsoft.ProjectCreationWizard.WorkItemTracking"
   completionMessage=" Work item queries uploaded"
   <dependencies>
      <dependency taskId="WITs" />
   </dependencies>
   <taskXml>
      <QUERIES>
         <Query name="All User Stories" fileName="WorkItem Tracking\Queries\AllUserStories.wiq" />
         ...
      </QUERIES>
   </taskXml>
</task>

Para obter mais informações, consulte Definir e personalizar objetos para controlar os itens de trabalho usando o plug-in de WorkItems.

Consulte também

Tarefas

Verificar alterações de definição de tipo de Item de trabalho

Conceitos

Processo de personalização passo a passo

Trabalhando com arquivos de modelo de processo

Outros recursos

Personalizando modelos de processo

Definir e personalizar objetos para controlar os itens de trabalho usando o plug-in de WorkItems