Partilhar via


Consultar itens de trabalho por link ou contagem de anexos

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

Vincule itens de trabalho para controlar 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 links externos
  • Contagem de hiperlinks
  • Link Comentário
  • Contagem de links relacionados
  • Contagem de links remotos
  • Contagem de arquivos anexados
  • (Discussão) Contagem de comentários
  • Contagem de links externos
  • Contagem de hiperlinks
  • Link Comentário
  • Contagem de links relacionados

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

Pré-requisitos

Categoria Requerimentos
Níveis de acesso - Para visualizar e executar consultas compartilhadas: Membro do Projeto.
- Para adicionar e salvar uma consulta partilhada: Pelo menos acesso básico .
Permissões permissão Contribute definida como Permitir para a pasta à qual você deseja adicionar uma consulta. Por padrão, o grupo Colaboradores não tem essa permissão.

Nota

Os utilizadores com acesso Stakeholder a um projeto público têm acesso total às funcionalidades de consulta, tal como os utilizadores com acesso Basic. Para obter mais informações, consulte Referência rápida de acesso para partes interessadas.

Categoria Requerimentos
Níveis de acesso - Para visualizar e executar consultas compartilhadas: Membro do Projeto.
- Para adicionar e salvar uma consulta compartilhada: Pelo menos acesso Básico.
Permissões permissão Contribute 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 suportados

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 um modo de 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:

Nota

Não é possível 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 exiba 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

Inclua estas cláusulas de consulta

Apenas os itens filhos do item de trabalho 645

Adicionar aos Filtros para itens de trabalho de topo:
ID = 645

Tarefas ou erros

Adicionar aos filtros para itens de trabalho vinculados:
Work Item Type In Task,Bug

Itens atribuídos à minha equipa (Web)

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

Itens principais das tarefas que me foram atribuídas

Altere as opções de Filtro para Associar itens de trabalho vinculados primeiro
Adicionar aos 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 no trabalho gerenciado 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 da Fabrikam e sob o projeto usando os tipos de ligação Predecessor e Sucessor.

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

  • Selecione Consultar entre projetos para incluir itens de trabalho vinculados dependentes de outros projetos.
  • Adicione a cláusula Area Path Under Fabrikam para filtrar itens de trabalho vinculados a itens definidos no projeto da 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ãos

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

  1. Abra a lista de pendências do produto e ative a opção Pais na visualização.
  2. Role até a seção Unparented Stories (Agile) ou Unparented Backlog items (Scrum).

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

Ou localize itens da lista de pendências não parentais usando uma consulta Itens de trabalho e links diretos . Por exemplo, a consulta a seguir lista histórias de utilizador ativas para a equipa de DevOps do Azure que não têm uma ligação de origem.

Captura de tela que mostra o Editor de Consultas para histórias de usuários não parentais 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 de 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 controle de item de trabalho.
Nome=System.AttachedFileCount de referência, Tipo de dados=Inteiro

Nota

Para os Painéis do Azure (serviço de nuvem), você pode adicionar até 100 anexos a um item de trabalho. Tenta adicionar mais resultado em uma mensagem de erro quando você salva o item de trabalho.

Contagem de comentários

O número de comentários adicionados à seção Discussão do item de trabalho.
Nome=System.CommentCount de referência, 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 pull requests, commits, changesets ou outros tipos de link.
Nome=System.ExternalLinkCount de referência, Tipo de dados=Inteiro

Contagem de hiperlinks

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

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

Link Comentário

Contém comentários do membro da equipe que criou o link. Você pode configurar esse campo para aparecer como uma coluna em uma lista de links em um formulário de item de trabalho. (O Editor de Consultas não suporta este campo.)

Nome de referência=System.Links.Comment, Tipo de dados = Texto sem formatação

Descrição do link

Contém o tipo de item de trabalho, ID e título do item de trabalho que é o destino do link. Você pode configurar esse campo para aparecer como uma coluna em uma lista de links em um formulário de item de trabalho. (O Editor de Consultas não suporta este campo.)

Nome de referência=System.Links.Description, Tipo de dados = Texto sem formatação

Elemento Pai

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.

Nota

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

Contagem de links relacionados

O número de links definidos para um item de trabalho que usam 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=System.RelatedLinkCount de referência, Tipo de dados=Inteiro

Contagem de ligações remotas

Disponível apenas para os Serviços de DevOps do Azure. O número de links de um item de trabalho para itens de trabalho definidos em outra organização. O mesmo ID do Microsoft Entra deve gerenciar as organizações. Os tipos de links suportados incluem Consumes From, Produced For e Remote Related. Para obter mais informações, consulte Adicionar link a itens de trabalho, Vincular a um item de trabalho remoto.
Nome=System.RemoteLinkCount de referência, Tipo de dados=Inteiro

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

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

Todas as guias que oferecem suporte à criação de links entre itens de trabalho usam o elemento LinksControl no formulário de item de trabalho. Este 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 controlos e restrições de link, modifique a definição de LinksControlOptions para um tipo de item de trabalho; consulte Elementos XML de LinksControlOptions.

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