Share via


Adicionar consultas de item de trabalho a um modelo de processo

Adicionando consultas de item de trabalho para seu modelo de processo, você pode definir o conjunto inicial de consultas compartilhadas e estrutura de pasta de consulta para um projeto de equipe. Todos os membros da equipe usam consultas para encontrar bugs, tarefas e outros itens de trabalho em que eles precisam agir.

Consultas de item de trabalho especificar critérios para gerar uma lista de itens de trabalho, como uma lista de bugs ativos ou tarefas fechadas. Arquivos de consultas de item de trabalho têm uma extensão de .wiq e armazenados na subpasta consultas da pasta controle de item de trabalho para modelos de processo de Microsoft Solutions Framework (MSF).

Importante

Modelos de processo do Microsoft definem várias consultas.Para obter mais informações, consulte Consultas compartilhadas (Scrum), Consultas compartilhadas (Agile), e Consultas compartilhadas (CMMI).Definições de consulta dependem de campos e tipos de itens de trabalho no modelo de processo.Além disso, algumas pastas de trabalho que são carregadas no Portal plug-in dependem das definições de consulta.

Especifique as definições de consulta como uma tarefa de WorkItemTracking plug-in de carregamento. Esta tarefa pode ser necessária porque vários artefatos em um modelo de processo podem depender de uma consulta. Além disso, a tarefa de carregar consultas depende a conclusão bem-sucedida da tarefa para carregar os tipos de item de trabalho. Especifique cada arquivo de consulta para carregar dentro do taskXml elemento.

Neste tópico

  • Criando um arquivo para uma consulta de Item de trabalho

  • Especificando consultas para carregar

  • Referência de elemento de consultas

Depois de um projeto de equipe é criado a partir do modelo de processo, você pode adicionar, remover e alterar consultas usando o Editor de consulta. Para mais informações, consulte Consultar itens de trabalho.

Para obter informações sobre como atribuir permissões de consulta para grupos, consulte Controlar o acesso às áreas funcionais. Para obter informações sobre como criar pastas de consulta, consulte Definir objetos para acompanhar itens de trabalho usando o plug-in de acompanhamento de item de trabalho.

Criando um arquivo para uma consulta de Item de trabalho

Cada definição de consulta deve ser especificada em seu próprio arquivo com uma extensão de .wiq, usando o WorkItemQuery pai do elemento e de acordo com o esquema definido no arquivo wiq.xsd. Você pode baixar os arquivos de esquema para controlar itens de trabalho na seguinte página no site da Microsoft: modelo de processo e trabalhar Item esquemas para Team Foundation Visual Studio.

O exemplo a seguir mostra a estrutura de sintaxe de alto nível que define uma consulta de item de trabalho:

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

Para obter mais informações sobre como criar uma consulta de item de trabalho para adicionar um modelo de processo, consulte Definir uma consulta de item de trabalho a ser adicionada a um modelo de processo.

De volta ao topo

Especificando consultas para carregar

Para incluir as consultas de item de trabalho no modelo de processo, crie uma ou mais tarefas no arquivo arquivo WorkItems. XML, que pode ser encontrado na pasta \WorkItem controle, que é a pasta na qual você baixou o modelo de processo. Use o Query elemento para especificar o arquivo para a consulta de item de trabalho. Por exemplo, o XML a seguir especifica a consulta definida no arquivo ActiveBugs.wiq sejam carregados e chamado Bugs ativos.

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

Adicionar o conjunto de consultas como uma tarefa de WorkItemTracking plug-in de carregamento.

O exemplo a seguir mostra como especificar uma tarefa para criar uma pasta de consulta é chamada de gerenciamento de produtos e carregar uma consulta é chamada todas as histórias de usuários para essa pasta.

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

Para mais informações, consulte Definir objetos para acompanhar itens de trabalho usando o plug-in de acompanhamento de item de trabalho.

De volta ao topo

Elementos de consulta

A sintaxe a seguir mostra a estrutura do QUERIES elemento e seus elementos filho.

<QUERIES>
   <Permission />
   <QueryFolder >
      <Query />
   </QueryFolder>
</QUERIES>

A tabela a seguir descreve os elementos que você usar para especificar a estrutura de pasta de consulta, permissões e consultas para carregar. Especificar esses elementos dentro de um taskXml elemento de recipiente no arquivo WorkItemTracking plug-in.

Elemento

Sintaxe

Descrição

Permission

<permission allow="ListOfPermissions" identity="GroupName" />

Elemento filho opcional de Query.

Especifica as permissões padrão atribuídas a consultas compartilhadas. Para mais informações, consulte Assigning Permissions for Work Item Queries.

Query

<Query name="QueryName" fileName="QueryFilePathName" />

Como mostra o exemplo a seguir, você pode carregar a consulta que é denominada "Active Bugs" e que é definido no arquivo ActiveBugs.wiq:

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

Elemento filho necessário de QUERIES.

Especifica o nome e caminho do arquivo .wiq que define uma consulta para carregar.

QueryFolder

<QueryFolder name="FolderName">
   <Query />
</QueryFolder>

Elemento filho opcional de QUERIES.

Especifica o nome de uma pasta de consulta.

QUERIES

<QUERIES>
   . . . 
</QUERIES>

Elemento filho opcional de taskXml elemento WorkItemTracking plug-in.

Especifica quais arquivos de definição de consulta para usar para criar consultas padrão.

De volta ao topo

Consulte também

Conceitos

Consultar itens de trabalho

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