Adicionar etiquetas de itens de trabalho para categorizar e filtrar listas e quadros

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

A marcação de itens de trabalho ajuda a filtrar rapidamente a lista de pendências do produto ou uma consulta de item de trabalho por categorias definidas por você. Uma tag corresponde a uma ou duas palavras-chave que você define e que suporta suas necessidades para filtrar uma lista de pendências ou consulta, ou definir uma consulta.

As tags 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/Práticas recomendadas.

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

Nota

As tags são um recurso compartilhado, estão associadas a um projeto e não a uma equipe. Se o seu projeto contiver várias equipes, todas as equipes adicionam e trabalham a partir do mesmo conjunto de tags.

Pré-requisitos

• Você deve ser adicionado a um projeto.
• Para exibir ou modificar itens de trabalho, você deve ter suas permissões Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó definidas como Permitir. Por padrão, o grupo de Colaboradores tem esse conjunto de permissões. Para obter mais informações, consulte Definir permissões e acesso para acompanhamento de trabalho.
• Para adicionar novas tags a serem adicionadas a itens de trabalho, você deve ter acesso Básico ou superior e ter as permissões Criar nova definição de tag no nível do projeto definidas como Permitir. Por padrão, o grupo de Colaboradores tem esse conjunto de permissões. Mesmo que a permissão esteja explicitamente definida para um Stakeholder, ele não tem permissão para adicionar novas tags, pois é proibido através de seu nível de acesso. Para obter mais informações, veja Referência rápida sobre o acesso de Interveniente.
• Todos os membros do projeto, mesmo os membros do grupo Leitores , podem enviar e-mails contendo itens de trabalho.

Nota

Os usuários com acesso de partes interessadas para projetos públicos podem adicionar novas tags.

Adicionar tags a um item de trabalho

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

Gorjeta

Recomendamos que você não use o @ caractere em uma tag. As tags 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, a tag não é reconhecida como uma tag.

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

Para adicionar várias tags ao mesmo tempo, digite uma vírgula entre elas. As tags diferenciam maiúsculas de minúsculas.

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

Nota

Por predefinição, são concedidas permissões a todos os Contribuidores e Intervenientes de projetos públicos para adicionar etiquetas novas e existentes. Os Intervenientes em projetos privados podem adicionar etiquetas já definidas, mas não podem adicionar novas etiquetas. Para conceder ou restringir permissões para criar novas tags, defina a permissão Criar definição de tag no nível do projeto. Para saber mais, consulte Alterar permissões no nível do projeto.

Adicionar ou remover tags em massa

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

Nota

Não há suporte para a modificação em massa de tags do Visual Studio ou de outros clientes suportados.

Consulta de itens de trabalho com base em tags

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

Gorjeta

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, pois o editor de consultas interpreta o @ caractere como uma macro. Para saber mais sobre consultas, consulte Criar consultas gerenciadas.

Por exemplo, aqui consultamos todos os itens de trabalho marcados como Web .Service

Gorjeta

Para entender como AND/OR as cláusulas são agrupadas, consulte Criar e salvar consultas gerenciadas, Cláusulas de grupo. Para visualizar 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.

Nota

A capacidade de consultar itens de trabalho que não têm nenhuma tag anexada a eles não é um recurso suportado. Se você quiser votar na solicitação para dar suporte a esse recurso, você pode fazê-lo em nossa página da Comunidade de desenvolvedores, Ser capaz de pesquisar tags vazias.

Mostrar tags na lista de pendências ou nos resultados da consulta

Escolha Opções de Coluna para adicionar o campo Tags à 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 tags que foram adicionadas aos itens de trabalho listados são exibidas.

Filtrar listas usando tags

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

Comece escolhendo Filtrar .

Marque as caixas dessas tags nas quais você deseja filtrar. Mantenha a seleção OR para executar um OR lógico para todas as tags selecionadas. Ou escolha a opção E para executar um E lógico em todas as tags selecionadas.

Excluir, remover ou gerenciar tags

Não é possível excluir marcas usando a interface do usuário da Web do Azure DevOps.

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

Outra opção é instalar o Gerenciador de tags do Marketplace, que adiciona uma página de tags em Painéis ou Trabalho para gerenciar tags, incluindo exclusões.

Etiquetas de código de cores nos painéis

Você pode destacar tags em cartões de quadro Kanban codificando-as por cores. Essas cores só aparecem no quadro Kanban que você configurar. Eles não aparecem em listas de pendências ou Taskboards. Para obter mais informações, consulte Personalizar cartões, tags de código de cores.

Itens de trabalho do gráfico e agrupar por tags

Nota

Não é possível agrupar um gráfico baseado em consulta por tags, no entanto, você pode agrupar um widget Gráfico para Itens de Trabalho por tags adicionadas a um painel. Esta funcionalidade está em pré-visualização pública. Para habilitá-lo, consulte Gerenciar ou habilitar recursos e ativar o widget Habilitar grupo por tags para gráfico de item de trabalho no painel.

Para agrupar um widget Gráfico para Itens de Trabalho por tags, conclua as mesmas etapas fornecidas em Acompanhar o progresso com gráficos baseados em consultas de status e tendência, Adicionar um widget de gráfico a um painel. Certifique-se de que sua consulta de lista simples contém Tags na cláusula de consulta ou como uma opção de coluna. Em seguida, escolha Tags para o grupo por seleção. Para filtrar o gráfico para mostrar apenas algumas etiquetas, escolha o botão de opção Etiquetas selecionadas e, em seguida, escolha as etiquetas que pretende que o gráfico apresente.

Artigos relacionados

• Usar o editor de consultas para listar e gerenciar consultas
• Mostrar tags em cartões
• Modificar itens de trabalho em massa a partir do portal da Web
• Modificar itens de trabalho em massa do Excel

Extensão do mercado

• Gerenciador de tags do Marketplace

Limites no número de tags

Embora não exista um limite rígido, a criação de mais de 100.000 tags 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 tag exibe um máximo de 200 tags. Quando mais de 200 tags forem definidas, comece a entrar para fazer com que o controle de tag exiba tags relevantes.

Não é possível atribuir mais de 100 tags a um item de trabalho ou você receberá a seguinte mensagem:

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

Guarde o item de trabalho com as etiquetas (100 ou menos) que adicionou e, em seguida, pode adicionar mais etiquetas.

Limite as consultas a menos de 25 tags. Mais do que esse valor e a consulta provavelmente expira.