Adicionar marcas de item de trabalho para categorizar e filtrar listas e placas

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

Marque itens de trabalho para filtrar rapidamente a lista de pendências do produto ou uma consulta de item de trabalho pelas categorias que você define. Uma tag corresponde a uma frase de uma ou duas palavras-chave que você define. Uma marcação dá suporte às suas necessidades de filtrar uma lista de pendências ou consulta ou definir uma consulta.

Você pode adicionar e modificar tags através do portal web ou do plug-in do Team Explorer para Visual Studio. Além disso, você pode abrir uma consulta no Excel para modificar marcas em massa.

As marcas são uma opção melhor para filtrar itens de trabalho do que usar cadeias de caracteres de texto, conforme descrito em Definir uma consulta de item de trabalho. As marcas são um recurso compartilhado, associadas a um projeto e não a uma equipe. Se o seu projeto contiver várias equipes, todas as equipes farão adições ao mesmo conjunto de marcas e trabalharão nelas.

Note

Os nomes das tags de itens de trabalho e das tags de pull request (PR), também chamados de rótulos, compartilham o mesmo conjunto em uma organização ou coleção de projetos. O limite combinado é de 150.000 nomes de marca exclusivos. Para obter mais informações, consulte Acompanhamento de trabalho, processo e limites de projeto e Rótulos de solicitação de pull.

Tip

Você pode usar a IA para ajudar nessa tarefa mais adiante neste artigo ou consulte Ativar a assistência de IA com o Azure DevOps Server MCP para começar.

Prerequisites

Category	Requirements
Permissões	Para exibir, seguir e editar itens de trabalho: - Exibir itens de trabalho neste nó (Permitir) - Editar itens de trabalho neste nó (Permitir) Por padrão, o grupo Colaboradores tem essas permissões. Para obter mais informações, consulte Definir permissões de acompanhamento de trabalho. Para adicionar novas tags: - permissão no nível do projeto para criar definição de tag (Permitir) Por padrão, o grupo Colaboradores tem essa permissão.
Níveis de Acesso	- Membro do projeto Para adicionar novas tags ou acompanhar solicitações de pull: pelo menos básico Para visualizar ou acompanhar itens de trabalho: pelo menos Stakeholder Para enviar emails com itens de trabalho: deve ser membro do grupo Colaboradores

Note

• Atribua acesso de Stakeholder a membros que desejam acompanhar o progresso e discutir itens de trabalho, mas não contribuem com código. Eles podem visualizar itens de trabalho, listas de pendências, quadros e painéis.
• Por padrão, colaboradores e partes interessadas em projetos públicos podem adicionar tags novas e existentes. Em projetos privados, somente Contributors podem adicionar novas tags. Para alterar as permissões de criação de marca, defina a permissão Criar definição de marca no nível do projeto. Para obter mais informações, consulte Alterar permissões no nível do projeto.

Adicionar marcas a um item de trabalho

As marcas devem ter 400 caracteres ou menos e não conter separadores, como , (vírgula), ; (ponto e vírgula) ou outro caractere de formatação.

Recomendação: não use o caractere @ em uma marca. Marcas que começam com o caractere @ não podem ser usadas em uma consulta de item de trabalho. O caractere @ significa uma macro dentro de uma consulta e, portanto, ela não é reconhecida como uma marca.

No portal da Web, abra um item de trabalho e adicione uma marca. Escolha Adicionar marca e digite sua palavra-chave. Ou, selecione na lista de marcas atribuídas anteriormente.

Para adicionar várias marcas ao mesmo tempo, digite uma vírgula entre as marcas. Marcas diferenciam maiúsculas de minúsculas.

As marcas que aparecem na barra de marcas já estão atribuídas ao item de trabalho. Para cancelar a atribuição de uma marcação, escolha o x na marcação .

Adicionar ou remover marcas em massa

Você pode atualizar em massa itens de trabalho para adicionar ou remover marcas do portal da Web. Você modifica marcas em massa da mesma forma que modifica outros campos em massa usando o portal da Web. Ou você pode usar o Excel para adicionar ou remover marcas em massa.

Note

Os quadros não oferecem suporte à modificação em massa de marcações no Visual Studio ou outros clientes.

Consultar itens de trabalho com base em marcas

Para consultar itens de trabalho com base em marcas, adicione uma cláusula para cada marca que você deseja usar para dar suporte à consulta.

Tip

Para entender como as cláusulas AND/OR são agrupadas, consulte Cláusulas de grupo. Para exibir a sintaxe WIQL de uma consulta, instale a extensão do editor de consultas WIQL, que permite ver a versão WIQL de qualquer entrada do editor de consultas.

Você pode usar os operadores Contém ou Não contém. As marcas que começam com o @ caractere não podem ser usadas em uma consulta de item de trabalho porque o editor de consultas interpreta o @ caractere como uma macro. Para obter mais informações, confira Definir uma consulta de item de trabalho.

Por exemplo, aqui está uma consulta para todos os itens de trabalho marcados como Web ou Service.

Note

Não é possível consultar itens de trabalho que não tenham marcas anexadas a eles. Se você quiser votar na solicitação para dar suporte a esse recurso, poderá fazê-lo em nossa página da Comunidade de Desenvolvedores, Ser capaz de procurar por tags vazias.

Mostrar marcas em sua lista de pendências ou resultados da consulta

Escolha Opções de Coluna para adicionar o campo Marcas à lista de pendências do produto ou a uma consulta de item de trabalho. Se a opção não aparecer, escolha Mais comandos para selecioná-la no menu de opções.

Todas as marcas adicionadas aos itens de trabalho listados são exibidas.

Filtrar listas usando marcas

No portal da Web, você pode filtrar listas de pendências, quadros e resultados de consulta usando marcas.

Comece escolhendo Filtrar .

Selecione as marcas nas quais você deseja filtrar. Mantenha a seleção OR para executar um OR lógico para todas as marcas selecionadas. Ou escolha a opção AND para executar um AND lógico em todas as marcas selecionadas.

Excluir, remover ou gerenciar marcas

Não é possível excluir tags usando a interface Web do Azure DevOps.

Se você precisar remover uma marca, crie um script ou aplicativo capaz de excluir usando a API REST Azure DevOps ou as bibliotecas de cliente .NET. Para obter mais exemplos, consulte Azure-DevOps-Admin-CLI.

Outra opção é instalar o Gerenciador de Marcas do Marketplace, que adiciona uma página Marcas a Quadros ou Trabalho para gerenciar as marcas, incluindo as exclusões.

Marcas de código de cor em quadros

Destaque marcações em cartões de quadro codificando-as por cores. Essas cores só aparecem no quadro que você configura. Elas não aparecem nas listas de pendências nem nos quadros de tarefas. Para obter mais informações, consulte Atribuir cores de etiquetas.

Itens de trabalho de gráfico e agrupar por marcas

Não é possível agrupar um gráfico baseado em consulta por marcas, mas você pode agrupar um widget Gráfico para Itens de Trabalho por marcas que você adiciona a um dashboard. Esse recurso está em uma versão prévia. Para habilitá-lo, confira Gerenciar ou habilitar recursos e ativar Habilitar o grupo por marcas para o widget do gráfico de itens de trabalho no dashboard.

Para agrupar um widget gráfico para itens de trabalho por marcas, conclua as mesmas etapas fornecidas em Adicionar um gráfico a um painel. Certifique-se de que a consulta de lista simples contém Sinalizações na cláusula de consulta ou como uma opção de coluna. Em seguida, escolha Marcas para a seleção Agrupar por. Para filtrar o gráfico para mostrar apenas algumas marcas, escolha o botão de opção Marcas selecionadas e escolha as marcas que você deseja que o gráfico exiba.

Limites no número de marcas

Embora não exista um limite rígido, a criação de mais de 100.000 marcas para uma coleção de projetos pode afetar negativamente o desempenho. Além disso, o menu suspenso de preenchimento automático para o controle de marca exibe no máximo 200 marcas. Quando mais de 200 marcas forem definidas, comece a digitar para fazer o controle de marca exibir as marcas relevantes.

Você não pode atribuir mais de 100 marcas a um item de trabalho ou receberá a seguinte mensagem:

TF401243: Failed to save work item because too many new tags were added to the work item.

Salve o item de trabalho com as marcas (100 ou menos) que você adicionou e adicione mais marcas.

Limite as consultas a menos de 25 marcas. Um número acima desse valor provavelmente fará com que a consulta atinja o tempo limite.

Usar a IA para consultar e gerenciar tags de itens de trabalho

Se você tiver o Azure Boards MCP Server conectado ao seu agente de IA no modo de agente, poderá usar prompts de linguagem natural para localizar e atualizar itens de trabalho com base em tags.

Tarefa	Exemplo de prompt
Localizar itens marcados	Find all active work items tagged with "security" in my project
Adicionar tags em massa	Add the tag "tech-debt" to all active bugs in the current sprint
Localizar itens não registrados	List work items with no tags assigned in the <Contoso> area path
Consulta por várias etiquetas	Find user stories tagged with both "performance" and "P1"
Listar todas as tags em uso	Show all distinct tags used on work items in project <Contoso> sorted by usage count
Limpar tags obsoletas	List tags in <Contoso> that are used on fewer than 2 work items
Substituir uma etiqueta	Find all work items in <Contoso> tagged "wontfix" and replace that tag with "by-design"
Marcar por critério	Add tag "needs-review" to all user stories in <Contoso> that were resolved in the last week but have no linked pull request
Analisar padrões de tags	Show the count of active work items per tag in area path <Contoso\\Frontend>
Localizar incompatibilidades de etiquetas	List work items in <Contoso> tagged "sprint-goal" that aren't assigned to the current sprint

Note

O modo de agente e o servidor MCP usam linguagem natural, para que você possa ajustar esses prompts ou fazer perguntas de acompanhamento para refinar os resultados.

Conteúdo relacionado

• Definir uma consulta de item de trabalho
• Personalizar cartões em um quadro
• Modificar itens de trabalho em massa no portal da Web
• Modificar itens de trabalho em massa do Excel

Extensão do Marketplace

• Gerenciador de Marcas do Marketplace