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

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Marque itens de trabalho para filtrar rapidamente a lista de pendências do produto ou uma consulta de item de trabalho por categorias que você definir. 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 etiquetas no portal da Web ou no plug-in Team Explorer para Visual Studio. Além disso, você pode abrir uma consulta no Excel para modificar tags em massa.

Nota

As etiquetas são um recurso partilhado associado a um projeto e não a uma equipa. Se o seu projeto contiver várias equipes, todas as equipes adicionam e trabalham a partir do mesmo conjunto de tags.

Pré-requisitos

Categoria	Requerimentos
Permissões	- Para visualizar, seguir e editar itens de trabalho: Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó permissões definidas como Permitir. Por padrão, o grupo de Colaboradores tem essas permissões. Para obter mais informações, consulte Definir permissões de controle de trabalho. - Para adicionar tags a itens de trabalho: permissão de nível de projeto Criar nova definição de tag definida como Permitir. Por padrão, o grupo de Colaboradores tem essa permissão.
Níveis de acesso	- Membro do projeto. - Para adicionar novas tags a itens de trabalho ou para visualizar ou seguir solicitações pull: Pelo menos acesso Básico . - Para visualizar ou acompanhar itens de trabalho: Pelo menos acesso de Participante. Para obter mais informações, consulte Sobre níveis de acesso. - Todos os membros do projeto, incluindo os do grupo Readers, podem enviar e-mails contendo itens de trabalho.

Nota

• Forneça acesso de Stakeholder aos membros que desejam contribuir para a discussão e rever o progresso. Normalmente, são membros que não contribuem para o código, mas querem visualizar itens de trabalho, listas de pendências, quadros e painéis.
• Por predefinição, todos os Colaboradores e Partes Interessadas em projetos públicos podem adicionar tags novas e existentes. Em projetos privados, as partes interessadas só podem adicionar tags existentes. Para controlar a capacidade de criar novas tags, defina a permissão Criar definição de tag no nível do projeto. Para obter mais informações, consulte Alterar permissões ao nível do projeto.

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.

Recomendação: 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 são sensíveis a maiúsculas e 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 ,.

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 com suporte.

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

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.

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 obter mais informações, consulte Criar consultas gerenciadas.

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

Nota

Não é possível consultar itens de trabalho que não tenham nenhuma tag anexada a eles. 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 da Coluna para adicionar o campo de 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 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 AND para executar uma operação E lógica em todas as tags selecionadas.

Excluir, remover ou gerenciar tags

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

Se precisa remover uma marca, podes criar um script ou aplicação capaz de efetuar uma eliminação utilizando a API REST do Azure DevOps ou as bibliotecas 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

Realce as etiquetas nos cartões de bordo codificando-as por cores. Essas cores só aparecem na placa 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.

"Gráfico dos itens de trabalho e agrupe por tags"

Não é possível agrupar um gráfico baseado em consulta por tags, mas é possível 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 Gerir ou ativar funcionalidades e ative Agrupar por tags para o widget de 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 a sua consulta de lista plana contém Tags na cláusula de consulta ou como uma opção de coluna. Em seguida, escolha Tags para a opção Grupo por. Para filtrar o gráfico para mostrar apenas algumas tags, escolha o botão de opção Tags selecionadas e, em seguida, escolha as tags que pretende que o gráfico apresente.

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 controlo de etiquetas exibe um máximo de 200 etiquetas. Quando mais de 200 tags forem definidas, comece a digitar 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ê recebe 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. Se o valor exceder este montante, a consulta provavelmente expira.

Artigos relacionados

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

Extensão do mercado

• Gerenciador de tags do Marketplace