Compartilhar via


Consultar itens de trabalho por link ou contagem de anexos

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Vincule itens de trabalho para acompanhar o trabalho e as dependências relacionadas e anexe arquivos para compartilhar informações com sua equipe. Consultar itens de trabalho usando os seguintes campos:

  • Contagem de Arquivos Anexados
  • (Discussão) Contagem de Comentários
  • Contagem de vínculos externos
  • Contagem de Hiperlinks
  • Comentário do vínculo
  • Contagem de vínculos relacionados
  • Contagem de vínculos remotos
  • Contagem de Arquivos Anexados
  • (Discussão) Contagem de Comentários
  • Contagem de vínculos externos
  • Contagem de Hiperlinks
  • Comentário do vínculo
  • Contagem de vínculos relacionados

Para obter descrições de campo detalhadas, consulte Campos associados a links e anexos.

Pré-requisitos

Categoria Requisitos
Níveis de Acesso – Para exibir e executar consultas compartilhadas: membro do projeto.
– Para adicionar e salvar uma consulta compartilhada: no mínimo, acesso Básico.
Permissões Permissão Contribuir definida como Permitir para a pasta à qual você deseja adicionar uma consulta. Por padrão, o grupo colaboradores não tem essa permissão.

Observação

Os usuários com acesso de Stakeholders para um projeto público têm acesso completo aos recursos de consultas, assim como os usuários com acesso Básico. Para mais informações, veja Referência rápida de acesso das partes interessadas.

Categoria Requisitos
Níveis de Acesso – Para exibir e executar consultas compartilhadas: membro do projeto.
– Para adicionar e salvar uma consulta compartilhada: no mínimo, acesso Básico.
Permissões Permissão Contribuir definida como Permitir para a pasta à qual você deseja adicionar uma consulta. Por padrão, o grupo colaboradores não tem essa permissão.

Operadores e macros com suporte

Use os seguintes operadores para cláusulas que especificam um campo inteiro:

= , <> , > , < , >= , <=
=[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]
In, Not In
Was Ever

Listar itens hierárquicos em uma exibição de árvore

Crie uma consulta e selecione Árvore de itens de trabalho para começar. O Editor de Consultas mostra os seguintes exemplos:

Observação

Você não pode construir uma consulta que mostre uma exibição hierárquica de Planos de Teste, Conjuntos de Testes e Casos de Teste porque esses itens não se vinculam usando tipos de link pai-filho. Use uma consulta de links diretos para listar itens de trabalho relacionados ao teste ou exibir a hierarquia na página Planos de Teste.

Opções para filtros e cláusulas de consulta

Altere as opções de filtro para itens de trabalho vinculados e adicione cláusulas de consulta usando as opções no Editor de Consultas.

Filtrar por

Incluir essas cláusulas de consulta

Somente itens filho do item de trabalho 645

Adicione a Filtros para itens de trabalho de nível superior:
ID = 645

Tarefas ou bugs

Adicionar a Filtros para itens de trabalho vinculados:
Work Item Type In Task,Bug

Itens atribuídos à minha equipe (Web)

Adicione aos filtros superior e inferior:
Assigned to In Group [Fabrikam Fiber]\Web

Itens pai de tarefas atribuídas a mim

Alterar as opções de Filtro para Corresponder primeiro aos itens de trabalho vinculados
Adicionar a Filtros para itens de trabalho vinculados:
Assigned To = @Me

Listar itens com base em dependentes vinculados

O exemplo a seguir mostra uma consulta vinculada dependente que retorna itens com dependências em trabalhos gerenciados por outras equipes e projetos.

A consulta a seguir localiza itens de trabalho em todos os projetos que estão vinculados a itens de trabalho no caminho de área e projeto da Fabrikam utilizando os tipos de links Predecessor e Successor.

Captura de tela que mostra uma consulta de links diretos no portal da Web.

  • Selecione Consulta entre projetos para incluir itens de trabalho vinculados dependentes de outros projetos.
  • Adicione a cláusula caminho de área sob Fabrikam para filtrar por itens de trabalho que estão ligados a itens definidos no projeto Fabrikam.
  • Selecione Somente retornar itens que tenham links correspondentes e, em seguida, selecione Retornar tipos de link selecionados para retornar somente itens de trabalho vinculados como Predecessor ou Sucessor.

Listar histórias de usuários órfãs

Se você organizar histórias de usuários em funcionalidades, encontre histórias não parentadas rapidamente executando uma das seguintes ações:

  1. Abra a lista de pendências do produto e ative a opção de exibição Pais Ativados.
  2. Role até a seção Histórias Sem Vinculação (Agile) ou Itens de Pendências Sem Vinculação (Scrum).

Captura de tela que mostra a lista de pendências do produto com histórias nãoparenciadas.

Ou encontre itens de lista de pendências nãoparenciados usando uma consulta de itens de trabalho e links diretos . Por exemplo, a consulta a seguir lista histórias de usuários ativas para a equipe do Azure DevOps que não tem um link Pai.

Captura de tela que mostra o Editor de Consultas para histórias de usuários não parentados no portal da web.

A tabela a seguir descreve os campos associados a links e anexos. A maioria desses campos não aparece no formulário do item de trabalho, mas é rastreada para todos os tipos de item de trabalho.

Contagem de Arquivos Anexados

O número de arquivos anexados ao item de trabalho e armazenados no banco de dados de acompanhamento de item de trabalho.
Nome de referência=System.AttachedFileCount, tipo de dados=Inteiro

Observação

Para o Azure Boards (serviço de nuvem), você pode adicionar até 100 anexos a um item de trabalho. Tenta adicionar mais resultados em uma mensagem de erro ao salvar o item de trabalho.

Contagem de comentários

O número de comentários adicionados à seção Discussão do item de trabalho.
Nome de referência=System.CommentCount, tipo de dados=Inteiro

Contagem de Links Externos

O número de links do item de trabalho para artefatos que não são itens de trabalho, como solicitações de pull, confirmações, conjuntos de alterações ou outros tipos de link.
Nome de referência=System.ExternalLinkCount, tipo de dados=Inteiro

Contagem de Hiperlinks

O número de hiperlinks que o item de trabalho contém.

Nome de referência=System.HyperLinkCount, tipo de dados=Inteiro

Comentário do vínculo

Contém comentários para do membro da equipe que criou o vínculo. Você pode configurar esse campo para que ele seja exibido como coluna em uma lista de links em um formulário de item de trabalho. (O Editor de Consultas não dá suporte a este campo.)

Nome de=System.Links.Comment referência, tipo de dados=PlainText

Descrição do Link

Contém o tipo de item, o ID e o título do item de trabalho que é o destino do vínculo. Você pode configurar esse campo para que ele seja exibido como coluna em uma lista de links em um formulário de item de trabalho. (O Editor de Consultas não dá suporte a este campo.)

Nome de=System.Links.Description referência, tipo de dados=PlainText

Parent

Quando incluído como uma opção de coluna em uma lista de resultados de consulta ou de lista de pendências, o sistema exibe o título do item de trabalho pai. Internamente, o sistema armazena a ID do item de trabalho em um campo Inteiro.

Observação

Você pode adicionar o campo Pai como uma coluna ou especificá-lo dentro de uma cláusula de consulta especificando a ID do item de trabalho pai.
Nome de referência=System.Parent, tipo de dados=Inteiro

Contagem de vínculos relacionados

O número de links definidos em um item de trabalho que usa um tipo de link de trabalho, como Pai-Filho, Predecessor-Sucessor e Relacionado. Para obter uma lista completa, consulte Referência de tipo de link.
Nome de referência=System.RelatedLinkCount, tipo de dados=Inteiro

Contagem de Links Remotos

Disponível apenas para Azure DevOps Services. O número de links de um item de trabalho para itens de trabalho definidos em outra organização. A mesma ID do Microsoft Entra deve gerenciar as organizações. Os tipos de link com suporte incluem Consome de, Produzido para e Relacionados Remotos. Para obter mais informações, confira Adicionar link a itens de trabalho, Vincular a um item de trabalho remoto.
Nome de referência=System.RemoteLinkCount, tipo de dados=Inteiro

Exiba objetos e itens de trabalho relacionados em um item de trabalho usando a extensão de visualização de item de trabalho disponível na guia Visual Studio Marketplace, Azure DevOps.

Para adicionar tipos de link, consulte Gerenciar tipos de link [witadmin].

Todas as guias que dão suporte à criação de links entre itens de trabalho usam o elemento LinksControl no formulário do item de trabalho. Esse elemento controla a filtragem e restringe os tipos de itens de trabalho aos quais você pode vincular. Ele também controla os tipos de links que você pode criar e se você pode vincular itens de trabalho em outro projeto. Para personalizar os controles e restrições de link, modifique a definição do tipo de item de trabalho LinksControlOptions; consulte os elementos XML LinksControlOptions.

Você pode adicionar ou remover colunas da lista de vínculos e personalizar as colunas padrão e a ordem das colunas. Para obter mais informações, consulte Elementos XML de LinksControlOptions.