Definir uma consulta de Item de trabalho para adicionar a um modelo de processo

  • Artigo

Você pode criar uma de itemde trabalhoconsulta (.wiq) de arquivos mais facilmente em Team Explorer. Em um existente team projeto, você pode usar Team Explorer para criar todas as consultas de item que você deseja adicionar ao seumodelo de processoe, em seguida, siga as etapas deste tópico para salvar cada consulta como um arquivo de .wiq de trabalhar. Para obter mais informações sobre como criar consultas de item de trabalho, consulte Especificar critérios de filtro de consulta.

Neste tópico

  • Salvar uma consulta de Item de trabalho como um.Arquivo Wiq

  • 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ífica de iteração

  • Referência de elemento de WorkItemQuery

Permissões Necessárias

Para criar uma consulta, você deve ser membro da leitores degrupo, ou o seu Exibir itens de trabalho nesse nó permissão deve ser definido como Permitir para cada equipe de projeto na consulta. Para salvar uma consulta como uma consultade equipe, você deve ter as permissões apropriadas.Para mais informações, consulte Organize e Defina Permissões em Consultas de Item de Trabalho.

Salvar uma consulta de Item de trabalho como um.Arquivo Wiq

Para salvar umaconsulta de itemde trabalho para um arquivo de .wiq

  1. Na Team Explorer, a consultacom o botão direito e, em seguida, clique em A consulta de modo de exibição.

  2. Sobre o arquivo menu, clique em Salvar < nome da consulta> [Query] As.

  3. No Salvar consulta como caixa de diálogo, clique em arquivoe especifique um local e nome de arquivo do arquivo .wiq. Como alternativa, clique em Procurar, especifique um nome de arquivo, navegue até o local para salvar o arquivo e, em seguida, clique em Salvar.

  4. Copie o arquivo para o \WorkItem Tracking\Queries pasta, que está na pasta à qual você baixou o seumodelode processo.

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

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

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

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

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

De volta ao topo

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 específico de iteração , incluindo a macro para o projetode equipe, $$ PROJECTNAME$ $ e o nome de um caminho de iteração é definido no arquivo de plug-in de classificação.Por exemplo, a sintaxe a seguir especifica uma consulta que inclui somente os itens de trabalho cujo caminho de iteração está na iteração 1.

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

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

Ao usar essa macro, você pode definir as pastas de trabalho que fazem referência a caminhos específicos de iteração .Omodelo de processopara odesenvolvimento de software Agile do MSFcontém uma iteração-específico consulta, Iteration1Backlog.wiq, que oferece suporte a iteração-pasta de trabalho específica, Backlog.xlsm de iteração.

Ao carregar iteração-consultas específicas, a tarefa ao processo o arquivo Classification.xml devem concluir antes da tarefa de processo , os arquivos de consulta .Para obter mais informações, consulte Definir as áreas iniciais e as iterações no plug-in de classificação e Definir as tarefas raiz usando o arquivo de plug-in de modelo de processo.

De volta ao topo

Aa721742.collapse_all(pt-br,VS.110).gifExemplo de uma consulta de Item de trabalho específica de iteração

O exemplo a seguir mostra a Iteration1Backlog trabalho item consulta, que oferece suporte para 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>

De volta ao topo

Referência de elemento de WorkItemQuery

A sintaxe a seguir mostra a estrutura da WorkItemQuery elemento e seus elementos filho .

<WorkItemQuery Version="1">
   <TeamFoundationServer>collectionURL </TeamFoundatonServer>
   <TeamProject>TeamProjectName </TeamProject>
   <Wiql>
      WorkItemQueryLanguage
   </Wiql>
</WorkItemQuery>

Elemento

Sintaxe

Descrição

TeamFoundationServer

 
<TeamFoundationServer>collectionURL
</TeamFoundatonServer>

Elemento opcional filho de WorkItemQuery.

Observação importanteImportante
Em geral, você deve remover esse elemento das consultas que você adiciona aos modelos de processo .

Especifica o URI da equipe projeto coleção no seguinte formato:

http://Nome_do_servidor: port/VirtualDirectoryName/NomeDaColeta

Não se for usado nenhum diretório virtual, use o seguinte formato para o URI:

http://Nome_do_servidor: port / NomeDaColeta

O tipo de atributo é ServerNameType com um comprimento máximo de 2047.

TeamProject

 
<TeamProject>TeamProjectName</TeamProject>

Elemento opcional filho de WorkItemQuery.

Observação importanteImportante
Em geral, você deve remover esse elemento das consultas que você adiciona aos modelos de processo .

Especifica o projeto de equipe em relação à qual executar a consulta.

O tipo de atributo é ProjectNameType com um comprimento máximo de 255 caracteres.

Wiql

 
<Wiql>WorkItemQueryLanguage</Wiql>

Elemento obrigatório filho do WorkItemQuery.

Especifica uma sequência de comandos de linguagem SQL (SQL) que atuam como critérios de filtro para localizar um conjunto de itens de trabalho em um projeto de equipe e retornar os valores que são atribuídos a um número definido de campos.

Os modelos deprocesso do MSFfornecem vários exemplos dos comandos SQL a Wiql elemento dá suporte. Esses arquivos estão localizados na pasta consultas da pasta rastreamento de item de trabalho.Para obter mais informações sobre como definir as consultas, consulte Localizar bugs, tarefas e outros itens de trabalho.

De volta ao topo

Consulte também

Conceitos

Localizar bugs, tarefas e outros itens de trabalho

Definir e personalizar objetos para acompanhar itens de trabalho usando o plug-in de acompanhamento de item de trabalho