Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Azure DevOps Serviços | 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:
Sugestão
Pode usar IA para ajudar nesta tarefa mais adiante neste artigo, ou consultar Enable AI assistance with Azure DevOps MCP Server para começar.
- 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 de contribuição definida como Permitir para a pasta à qual você deseja adicionar uma consulta. Por padrão, o grupo de Colaboradores não tem essa permissão. |
Nota
Os usuários com acesso de partes interessadas para um projeto público têm acesso total aos recursos de consulta, assim como os usuários com acesso Básico . Para obter mais informações, consulte Referência rápida sobre o acesso das 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 de contribuição definida como Permitir para a pasta à qual você deseja adicionar uma consulta. Por padrão, o grupo de 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 Query Editor 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
Mude as opções de filtro para itens de trabalho ligados e adicione cláusulas de consulta usando as opções no Query Editor.
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.
- 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:
- Abra a lista de pendências do produto e ative a opção Pais na visualização.
- Role até a seção Unparented Stories (Agile) ou Unparented Backlog items (Scrum).
Ou localize itens da lista de pendências não parentais usando uma consulta Itens de trabalho e links diretos . Por exemplo, a consulta seguinte lista histórias de utilizador ativas para a equipa do Azure DevOps que não têm uma ligação primária.
Campos associados a links e anexos
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 o Azure Boards (serviço cloud), podes 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
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
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 Query Editor 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 Query Editor não suporta este campo.)
Nome de referência=System.Links.Description, Tipo de dados = Texto sem formatação
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
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
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. O mesmo Microsoft Entra ID deve gerir 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
Visualize trabalhos relacionados e outros objetos
Veja itens de trabalho e objetos relacionados dentro de um item de trabalho utilizando a extensão de visualização de itens de trabalho
Adicionar tipos de link personalizados ou personalizar os controles de links
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.
Campos de dados padrão em listas de links
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.
Use IA para consultar por links e anexos
Se tiveres o Azure Boards MCP Server ligado ao teu agente de IA em modo agente, podes usar prompts em linguagem natural para encontrar itens de trabalho com base nos seus links e anexos.
| Tarefa | Exemplo de prompt |
|---|---|
| Encontrar itens não ligados | Find active user stories with no child task links |
| Pesquisa para anexos | List bugs that have attached files |
| Consulte os links de desenvolvimento | Show work items with no linked commits or pull requests |
| Encontre itens fortemente ligados | Find work items with more than 3 related links |
| Rastrear cadeias de dependência | Show all work items in <Contoso> that have predecessor links and list what they depend on |
| Encontre itens com ligações externas | List work items in <Contoso> that have hyperlinks in their links |
| Auditoria da integridade entre pais e filhos | Show child work items in <Contoso> whose parent is in the Closed state but the child is still Active |
| Encontre itens ligados a casos de teste | List user stories in the current sprint for <Contoso> that have linked test cases and show the test outcome |
| Identificar o inchaço de apego | Show work items in <Contoso> that have more than 5 attachments |
| Encontre ligações entre projetos | List work items in <Contoso> that have related links to work items in other projects |
Nota
O modo Agente e o Servidor MCP usam linguagem natural, por isso pode ajustar estes prompts ou fazer perguntas de seguimento para refinar os resultados.