Consultar itens de trabalho
Ajuda de consultas localizar itens de trabalho que você deseja examinar, triagem, atualizar ou gerar um relatório.
Use a caixa de pesquisa para localizar itens de trabalho. Digite a ID ou use filtros. Se você quiser uma lista plana de itens de trabalho, uma lista hierárquica usando uma consulta em árvore ou uma lista que mostre as dependências usando uma consulta de vínculos diretos, use o editor de consultas para escolher o tipo de consulta.
Você pode criar consultas no Visual Studio Online, no Team Web Access (TWA) e Team Explorer. Além disso, você pode abrir uma consulta no Excel ou no Project para executar modificações em lote.
Use a caixa de pesquisa para localizar um item de trabalho pela ID.
Digite a ID na caixa Pesquisar itens de trabalho e escolha o ícone de pesquisa.
.png "Caixa de texto de itens de trabalho de pesquisa")
Usando o menu de contexto .png "Ícone de Menu de contexto")
, você pode adicionar filtros para itens de lista com base em atribuições, status, palavra-chave ou um tipo de item de trabalho.
Por exemplo, digite A=@Me T=Task para listar todas as tarefas atribuídas a você.
Abrir e editar uma consulta de lista plana
A maneira mais fácil de definir uma consulta é começar com uma consulta compartilhada existente. O exemplo a seguir mostra como localizar todos os bugs fechados modificando a consulta compartilhada Bugs Ativos fornecida com o modelo de processo Agile. Exemplos são baseados na interface do usuário fornecida pelo navegador da web.
Abra uma consulta compartilhada. Por exemplo, abra Bugs Ativos ou uma consulta de lista plana semelhante.
.png "Abra a consulta compartilhada, por exemplo, Bugs ativos")
Edite a consulta para localizar bugs fechados e execute a consulta. Use
.png "Adicionar anexo")
(Inserir nova linha de filtro) para inserir uma cláusula acima da cláusula atual. Use .png "Excluir a cláusula")
(Remover linha de filtro) para excluir uma cláusula..png "Exibição do Editor de uma consulta de lista plana")
Salve a consulta na pasta Minhas Consultas.
.png "Salvar consulta como pasta = Minhas consultas")
Para salvar uma consulta na pasta Consultas Compartilhadas, você precisa ser um administrador da equipe, um membro do grupo Administradores do Projeto ou ter suas permissões de Contribuir na pasta definidas como Permitir.
Criar uma consulta
Comece no menu Novo na pagina de consultas no TWA, ou na página de itens de trabalho do Team Explorer.
.png "Abra uma nova consulta")
Agrupar cláusulas para refinar sua lista
As cláusulas agrupadas funcionam como uma única unidade separada do resto da consulta, semelhante a colocar uma equação matemática ou expressão lógica entre parênteses. O operador And ou Or da primeira cláusula no grupo se aplica ao grupo inteiro.
No próximo exemplo, a primeira expressão retorna todos os itens de trabalho que são prioridade 1 e todos os bugs ativos de qualquer prioridade. A segunda expressão retorna todos os itens de trabalho ativos de prioridade 1 e todos os bugs de prioridade 1, ativos ou não.
Cláusulas agrupadas |
Expressão lógica |
|---|---|
.png "Filtrar usando uma ou / e expressão lógica") |
Prioridade=1 OR (Tipo de Item de Trabalho=Bug AND Estado=Ativo) |
.png "Filtrar usando uma e/ou lógico expressão") |
Prioridade=1 AND (Tipo de Item de Trabalho=Bug OR Estado=Ativo) |
Para agrupar uma ou mais cláusulas, selecione-as e escolha o ícone para agrupar cláusulas .png "Cláusula de consulta de grupo"){kind=icon}
.
.png "Agrupar cláusulas de consulta selecionada")
Se os resultados da consulta não retornarem o conjunto de itens de trabalho esperado, siga estas etapas:
Verifique se cada cláusula está definida como você pretendia.
Verifique as atribuições de E/Ou a cada cláusula. Se seus resultados contiverem mais itens de trabalho do que o esperado, normalmente uma cláusula Ou está presente em vez da cláusula E.
Determine se você precisa agrupar ou alterar o agrupamento das cláusulas da consulta e as atribuições de E/Ou de cada cláusula agrupada.
Adicione mais cláusulas de consulta para refinar seus critérios de filtragem de consulta.
Revise as opções disponíveis para especificar campos, operadores e valores.
Usar uma consulta em árvore para exibir uma lista hierárquica
Use a consulta em árvore (.png "Consulta de árvore"){kind=icon}
) para exibir uma lista aninhada de várias camadas de itens de trabalho. Por exemplo, você pode exibir todos os itens da lista de pendências e suas tarefas vinculadas.
.png "Lista de resultados mostra uma consulta em árvore")
Expanda (.png "Expanda o nó (Team Web Access)")
) ou recolha (.png "Recolher nó (Team Web Access)")
) nós de folha para focar em partes diferentes da árvore.
Defina os critérios de filtragem para os itens de trabalho pai e filho.
.png "Filtros de consulta de árvore")
Para localizar filhos vinculados, selecione Corresponder itens de trabalho de nível superior primeiro. Para localizar pais vinculados, selecione Corresponder itens de trabalho vinculados primeiro.
Usar uma consulta de vínculo direto para exibir dependências
Use a consulta de vínculos diretos (.png "Consulta de vínculos diretos"){kind=icon}
) para acompanhar itens de trabalho que dependem de outro trabalho acompanhado, como tarefas, bugs, problemas ou recursos. Por exemplo, você pode exibir itens da lista de pendências que dependem de outros itens que estão sendo implementados ou um bug que está sendo corrigido.
.png "Resultados da consulta de vínculos diretos")
Use a consulta de vínculos diretos para acompanhar dependências que sua equipe tem em que outras equipes trabalham, ou gerencie os compromissos de sua equipe com outras equipes. Especifique os critérios de filtragem para os itens de trabalho vinculados e superiores, selecione os tipos de vínculos usados para filtrar as dependências.
.png "Editor de consulta de vínculos diretos")
Filtre a lista da primeira camada de itens de trabalho escolhendo uma destas opções:
Retornar somente os itens de trabalho que têm os vínculos especificados: os itens de trabalho da primeira camada são retornados, mas somente se possuírem vínculos com itens de trabalho especificados pelos critérios de filtragem de itens de trabalho vinculados.
Retorna todos os itens de trabalho de nível mais alto: todos os itens de trabalho da primeira camada são retornados, independentemente dos critérios de filtragem dos itens de trabalho vinculados. Os itens de trabalho da segunda camada que são vinculados à primeira camada são retornados quando correspondem aos critérios de filtragem de itens de trabalhos vinculados.
Retornar somente os itens de trabalho que não têm os vínculos especificados: os itens de trabalho da primeira camada são retornados, mas somente se não estiverem vinculados a itens de trabalho especificados pelos critérios de filtragem de itens de trabalho vinculados.
Perguntas e respostas
P: Que operadores e variáveis de consulta posso usar?
R: Os operadores e as variáveis disponíveis para seleção dependem do campo que você seleciona. As quatro variáveis são @Project para o campo de nome do projeto, @Me para campos de nome de pessoa, @Today para campos de data/hora e [Qualquer]. Consulte Campos de consulta, operadores, valores e variáveis.
P: Há outros exemplos de consulta?
R: Consulte Exemplo de consultas de item de trabalho e Exemplo de consultas de caixa de pesquisa.
P: Como posso gerar um gráfico dos resultados de uma consulta?
R: No Visual Studio Online e no TWA, você pode gerar um gráfico dos resultados de qualquer consulta de lista plana. Você deve ser um membro do grupo de acesso avançado no TWA.
Ou, você pode abrir uma consulta no Excel e usar os recursos do Excel para gerar um gráfico.
P: Como atualizar consultas automaticamente com base no sprint ou na iteração atual?
R: Não há como fazer isso automaticamente; você deve atualizar manualmente as consultas para apontar para o sprint atual. Se seu projeto de equipe for baseado no Scrum ou Agile, você encontrará um conjunto de consultas nas pastas Sprint Atual ou Iteração Atual. Para que cada consulta retorne itens definidos para o sprint atual, você deve atualizar o caminho de iteração para a iteração atual de acordo com a data.
Você pode alterar muitas de suas consultas salvando-as como arquivos .wiq. Abra a consulta no Team Explorer, escolha Editar Consulta e Arquivo, Salvar como para salvar cada consulta como um arquivo .wiq. Este é um exemplo da consulta Trabalho em Andamento que foi atualizado para oferecer suporte à Versão 2\Sprint 59.
<?xml version="1.0" encoding="utf-8"?>
<WorkItemQuery Version="1">
<Wiql>
SELECT [System.Id],
[System.WorkItemType],
[System.Title],
[System.AssignedTo],
[System.State],
[Microsoft.VSTS.Scheduling.RemainingWork],
FROM WorkItems
WHERE [System.TeamProject] = @project and
[System.IterationPath] under 'FabrikamPrime\Release 2\Sprint 59' and
[System.WorkItemType] in group 'Microsoft.TaskCategory' and
[System.State] = 'In Progress'
ORDER BY [System.AssignedTo],
[Microsoft.VSTS.Common.BacklogPriority],
[System.Id]
</Wiql>
</WorkItemQuery>
P: Como posso adicionar ou modificar colunas na lista de resultados?
R: Abra Opções de Coluna para adicionar ou remover colunas, alterar a sequência de colunas e alterar a ordem da classificação em uma coluna.
.png "Guia de colunas de exibição na caixa de diálogo Opções de coluna")
Além disso, na lista de resultados, você pode arrastar uma coluna para uma nova posição e selecionar o título de coluna para alterar a ordem de classificação por coluna.
P: Posso filtrar uma consulta usando marcas?
R: Sim, se você estiver usando Visual Studio Online ou se o TFS local contém as atualizações adicionadas com o TFS 2013 atualização 2, caso contrário, não para implantações locais.
Para o Visual Studio Online e Visual Studio 2013 Update 2, você pode escolher marcas como um campo a ser filtrado. Além disso, você pode abrir uma consulta no Excel e modificar as marcas atribuídas a itens de trabalho em massa. Também é possível adicionar marcas a itens de trabalho usando o Visual Studio.
No Team Explorer plug-in para Eclipse, você pode filtrar consultas por marcas, no entanto, você não pode adicionar ou modificar marcas da interface do usuário. Você deve usar o portal da web para adicionar e modificar as marcas.
Para o TFS local sem o TFS 2013 atualização 2, você pode mostrar marcas como uma coluna nos resultados da consulta e você pode filtrar uma lista com base em uma marca, no entanto, você não pode adicionar marcas como uma cláusula aos critérios de filtragem.
P: Posso usar os resultados da consulta para modificar rapidamente as relações vinculadas?
R: partir do Team Explorer plug-in para o Visual Studio, você pode recuar (.png "Recuar"){kind=icon}
), recuar para a esquerda (.png "Diminuir recuo"){kind=icon}
) e arrastar os itens de trabalho para modificar a hierarquia.
Além disso, você pode abrir uma consulta no Excel ou no Project para modificar as relações de vínculos pai-filho e antecessor-sucessor em massa.
P: Como posso impedir alguém de modificar uma consulta que eu compartilho com a equipe?
R: Defina as permissões na consulta como Leitura.
P: Como posso adicionar uma consulta a Consultas Compartilhadas ou como um favorito da equipe?
R: para salvar uma consulta na pasta Consultas compartilhadas, são adicionados ao grupo de administradores do projeto ou ter seus as permissões definidas para uma pasta em consultas compartilhadas.
Para adicionar uma consulta como favorita da equipe, abra o menu de contexto da consulta e adicione-a como favorita da equipe. Você precisa ser um administrador da equipe para adicionar consultas aos favoritos da equipe.
Você só pode adicionar consultas compartilhadas aos Favoritos da equipe, e somente se você tiver permissões de administrador da equipe.
P: Posso adicionar pastas aos favoritos da equipe?
R: Não. Você só pode adicionar pastas em Minhas Consultas e em Consultas Compartilhadas.
P: Posso enviar uma consulta por email?
R: Sim. Consulte Enviar por email links de URL a consultas e itens de trabalho do TFS.
P: Posso definir um hiperlink que abre uma consulta?
R: Sim. A maneira mais fácil de definir um hiperlink é criar uma consulta que corresponda ao que você deseja e depois copiar a URL da consulta. O hiperlink usa a linguagem WIQL (Work Item Query Language), que lembra Transact-SQL e corresponde a esta sintaxe:
**http://ServerName:**Port/ /tfs/CollectionName/TeamProjectName/**q.aspx?pname=Project&wiql=**WorkItemQueryLanguage
Por exemplo, o hiperlink a seguir lista a ID, o título e o estado de todos os bugs com o número de compilação 9.0.30304 definido para o projeto AdventureWorksProject.
http://AdventureWorks:8080/tfs/ /q.aspx?pname=AdventureWorksProject&wiql==SELECT [System.ID], [System.Title], [System.State] FROM WorkItems WHERE [System.TeamProject]='AdventureWorksProject' AND [System.WorkItemType]='Bug' AND [System.FoundIn]='9.0.30304' http://Server1:8091/tfs/web/wi.aspx?id=9035
P: Posso exportar uma consulta?
R: Sim. No editor de consultas do Team Explorer, use o menu Arquivo para salvar uma consulta como um arquivo .wiq. Quando você cria um projeto de equipe, as consultas compartilhadas são criadas com base em arquivos .wiq definidos no modelo de processo.
P: Por que os conteúdos do painel de tarefas diferem daqueles listados com sua consulta criada?
R: é possível atribuir tarefas a uma iteração, mas não vinculá-las a um item de lista de pendências pai. Esses itens serão mostrados na consulta criada, mas não no painel de tarefas em si. O TFS executa a consulta e aplica alguns processos em segundo plano antes de exibir os itens do painel de tarefas.
Esses três motivos podem fazer com que os itens de trabalho que pertencem à categoria de tarefa não apareça em um painel de tarefas ou da lista de pendências de sprint:
A tarefa ainda não foi vinculada a um item de lista de pendências pai. Somente os bugs e as tarefas que você vinculou a um item da lista de pendências de produto (Scrum), história do usuário (Agile) ou requisito (CMMI) pai cujo caminho de iteração esteja definido para o sprint aparecerão na página da lista de pendências do sprint.
A tarefa é pai de outra tarefa. Se você tiver criado uma hierarquia de tarefas, apenas as tarefas de nível filho na parte inferior da hierarquia são exibidos.
Pai vinculado da tarefa corresponde a um item de lista de pendências definido para outra equipe. Ou o caminho da área do item da lista de pendências da tarefa pai é diferente do caminho de área da tarefa.
P: Posso consultar itens de trabalho por programação?Posso criar uma consulta dinâmica?
R: Sim. Consulte Consultar bugs, tarefas e outros itens de trabalho.
Consulte também
Conceitos
Escolher o cliente do Team Foundation para oferecer suporte às suas tarefas