Definir uma consulta de item de trabalho a ser adicionada a um modelo de processo
Você pode criar um arquivo de consulta de item de trabalho (.wiq) com mais facilidade no Team Explorer. Em um projeto de equipe existente, você pode usar o Team Explorer para criar todas as consultas de item de trabalho que desejar adicionar ao seu modelo de processo e seguir as etapas deste tópico para salvar cada consulta como um arquivo .wiq. Para obter mais informações sobre como criar consultas de itens de trabalho, consulte Consultar itens de trabalho.
Requisitos
Para criar uma consulta, você deve ser membro do grupo Leitores ou sua permissão Exibir itens de trabalho neste nó deve estar definida para Permitir para cada projeto de equipe na consulta.
Para salvar uma consulta como uma consulta de equipe, você deve ter as permissões apropriadas descritas Definir permissões em consultas.
Salvar uma consulta de item de trabalho como um arquivo .wiq
No Team Explorer, abra a consulta que deseja salvar.
No menu Arquivo, escolha Salvar <nome de consulta> [Consulta] como.
Na caixa de diálogo Salvar Consulta como, escolha Arquivo e especifique um local e um nome de arquivo para o arquivo .wiq. Como alternativa, escolha Procurar, especifique um nome de arquivo, navegue até o local para salvar o arquivo e escolha Salvar.
Copie o arquivo na pasta \Acompanhamento do Item de Trabalho\Consultas, que está na pasta em que você baixou seu modelo de processo.
Abra o arquivo .wiq em um editor de texto.
Remova os elementos <TeamFoundationServer> e <TeamProject> que associam a consulta a um servidor específico que esteja executando o Visual Studio Team Foundation Server e a um projeto de equipe específico, como mostra o exemplo a seguir:
<TeamFoundationServer>CollectionURL</TeamFoundationServer> <TeamProject>ProjectName</TeamProject>Dica
Você deve editar o arquivo .wiq em um editor de texto e remover os elementos <TeamFoundationServer> e <TeamProject> que associam a consulta a um servidor específico e ao projeto de equipe.Caso contrário, a consulta não funcionará corretamente se o modelo de processo for carregado em um servidor diferente.Como alternativa, use macros onde for possível de modo que sua consulta não contenha o nome explícito do projeto de equipe atual ou quaisquer outros valores específicos a um determinado ambiente.
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 faça referência a um caminho de iteração específico incluindo a macro do 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 sintaxe a seguir especifica uma consulta que inclui apenas esses itens de trabalho cujo caminho de iteração está na a iteração 1.
AND [Source].[System.IterationPath] UNDER '$$PROJECTNAME$$\Iteration 1'
Quando o projeto de equipe é criado, a macro é substituída pelo nome do projeto de equipe.
Ao usar essa macro, você pode definir as pastas de trabalho que fazem referência a caminhos de iteração específicos. O modelo de processo para o desenvolvimento ágil do software MSF contém uma consulta específica de iteração, Iteration1Backlog.wiq, que oferece suporte à pasta de trabalho específica de iteração, Iteration Backlog.xlsm.
Ao carregar consultas específicas de iteração, a tarefa de processar o arquivo Classification.xml deve ser concluída antes da tarefa de processar os arquivos de consulta. Para obter mais informações, consulte Definir o plug-in de classificação e Definir as tarefas raiz usando o arquivo de plug-in de modelo de processo.
Exemplo de uma consulta de item de trabalho específica de interação
O exemplo a seguir mostra a consulta de item de trabalho Iteration1Backlog, que oferece suporte à pasta de trabalho 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>
Referência de elemento WorkItemQuery
A sintaxe a seguir mostra a estrutura do elemento WorkItemQuery e seus elementos filho.
<WorkItemQuery Version="1">
<TeamFoundationServer>collectionURL </TeamFoundatonServer>
<TeamProject>TeamProjectName </TeamProject>
<Wiql>
WorkItemQueryLanguage
</Wiql>
</WorkItemQuery>
Elemento |
Sintaxe |
Descrição |
|---|---|---|
TeamFoundationServer |
|
Elemento filho opcional de WorkItemQuery. Importante Em geral, você remove esse elemento das consultas adicionadas aos modelos de processo. Especifica o URI da coleção de projeto de equipe no seguinte formato: http:// Nome_do_servidor: port/VirtualDirectoryName/CollectionName Se nenhum diretório virtual for usado, use o seguinte formato para o URI: http:// Nome_do_servidor: port / CollectionName O tipo de atributo é ServerNameType com o comprimento máximo de 2047 caracteres. |
TeamProject |
|
Elemento filho opcional de WorkItemQuery. Importante Em geral, você remove esse elemento das consultas adicionadas aos modelos de processo. Especifica o projeto de equipe no qual executar a consulta. O tipo de atributo é ProjectNameType com o comprimento máximo de 255 caracteres. |
Wiql |
|
Elemento filho de WorkItemQuery obrigatório. Especifica uma sequência de comandos SQL (Structured Query Language) que atua 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 de campos definido. Os modelos de processo do MSF fornecem vários exemplos de comandos SQL aos quais o elemento Wiql oferece suporte. Esses arquivos estão localizados na pasta Consultas da pasta Acompanhamento do Item de Trabalho. |