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

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

A marcação de itens de trabalho ajuda-o a filtrar rapidamente o atraso do produto ou uma consulta de produto por categorias que define. Uma etiqueta corresponde a uma ou duas palavras-chave que define e que suporta as suas necessidades de filtrar um atraso ou consulta, ou definir uma consulta.

As etiquetas são uma melhor escolha para filtrar itens de trabalho do que usar cordas de texto como descrito na Orientação para criar consultas de alto desempenho.

Pode adicionar e modificar tags a partir do portal web, a partir do plug-in do Team Explorer para o Visual Studio. Além disso, pode abrir uma consulta no Excel para modificar tags a granel.

Nota

As etiquetas são um recurso partilhado, estão associadas a um projeto e não a uma equipa. Se o seu projeto contiver várias equipas, todas as equipas irão adicionar e trabalhar a partir do mesmo conjunto de tags.

Pré-requisitos

  • Tens de te ligar a um projeto. Se ainda não tem um projeto, crie um.
  • Deve ser adicionado a um projeto. Para ser adicionado, Adicione os utilizadores a um projeto ou equipa.
  • Para visualizar ou modificar itens de trabalho, tem de ter os itens de trabalho do seu Vervisão neste nó e editar itens de trabalho neste nó de permissões definidas para Permitir. Por predefinição, o grupo De contribuintes tem esta permissão definida. Para saber mais, consulte permissões de definição e acesso para rastreio de trabalho.
  • Para adicionar novas tags para adicionar a itens de trabalho, você deve ter acesso básico ou superior e ter o nível de projeto Criar novas permissões de definição de etiqueta definidas para Permitir. Por predefinição, o grupo De contribuintes tem esta permissão definida. Mesmo que a permissão seja explicitamente definida para uma Parte, eles não terão permissão para adicionar novas tags, uma vez que são proibidas através do seu nível de acesso. Para saber mais, consulte o Stakeholder aceda a referência rápida.
  • Todos os membros do projeto, mesmo aqueles que pertencem ao grupo Leitores , podem enviar por e-mail artigos de trabalho.
  • Tens de te ligar a um projeto. Se ainda não tem um projeto, crie um.
  • Deve ser adicionado a um projeto. Para ser adicionado, Adicione os utilizadores a um projeto ou equipa.
  • Para visualizar ou modificar itens de trabalho, tem de ter os itens de trabalho do seu Vervisão neste nó e editar itens de trabalho neste nó de permissões definidas para Permitir. Por predefinição, o grupo De contribuintes tem esta permissão definida. Para saber mais, consulte permissões de definição e acesso para rastreio de trabalho.
  • Para adicionar novas tags para adicionar a itens de trabalho, você deve ter acesso básico ou superior e ter o nível de projeto Criar novas permissões de definição de etiqueta definidas para Permitir. Por predefinição, o grupo De contribuintes tem esta permissão definida. Mesmo que a permissão seja explicitamente definida para uma Parte, eles não terão permissão para adicionar novas tags, uma vez que são proibidas através do seu nível de acesso. Para saber mais, consulte o Stakeholder aceda a referência rápida.
  • Todos os membros do projeto, mesmo aqueles que pertencem ao grupo Leitores , podem enviar por e-mail artigos de trabalho.

Nota

Os utilizadores com acesso das Partes Interessadas a projetos públicos podem adicionar novas tags.

Adicionar etiquetas a um item de trabalho

As etiquetas devem ter 400 caracteres ou menos e não conter separadores tais como uma , (vírgula), ; (ponto e vírgula) ou outro carácter de formatação.

Dica

Recomendamos que não use o @ personagem numa etiqueta. Etiquetas que começam com o @ personagem não podem ser usadas numa consulta de artigo de trabalho. O @ personagem significa uma macro dentro de uma consulta e, portanto, a etiqueta não é reconhecida como uma etiqueta.

A partir do portal web, abra um item de trabalho e adicione uma etiqueta. Escolha Adicionar a etiqueta e digitar a sua palavra-chave. Ou, selecione a partir da lista de tags previamente atribuídas.

Adicione uma ou mais etiquetas a um item de trabalho

Para adicionar várias etiquetas de uma vez, digite uma vírgula entre as etiquetas. As etiquetas são sensíveis a casos.

As etiquetas que aparecem na barra de identificação já estão atribuídas ao item de trabalho. Para não assinar uma etiqueta, escolha o x na etiqueta,Elimine uma etiqueta atribuída a um item de trabalho.

Nota

Por defeito, todos os Colaboradores e Partes Interessadas de projetos públicos recebem permissões para adicionar etiquetas novas e existentes. Os interessados em projetos privados podem adicionar tags que já estão definidas, mas não adicionar novas etiquetas. Para conceder ou restringir permissões para criar novas etiquetas, define a definição de etiqueta de marcação ao nível do projeto. Para saber mais, consulte as permissões ao nível do projeto Change.

Adicionar ou remover etiquetas a granel

Pode atualizar itens de trabalho em massa para adicionar ou remover tags do portal web. Modifica etiquetas em massa da mesma forma que modifica em massa outros campos utilizando o portal web. Ou, pode usar o Excel para adicionar ou remover etiquetas a granel.

Editar diálogo de itens de trabalho, Granel adicionar a vários itens de trabalho.

Nota

A modificação em massa de tags do Estúdio Visual ou de outros clientes suportados não é suportada.

Consulta para artigos de trabalho com base em etiquetas

Para consultar itens de trabalho com base em etiquetas, adicione uma cláusula para cada tag que pretende utilizar para suportar a sua consulta.

Dica

Pode utilizar os operadores Contém ou Não Contém . As etiquetas que começam com o @ personagem não podem ser usadas numa consulta de item de trabalho, uma vez que o editor de consulta interpreta o @ personagem como uma macro. Para saber mais sobre consultas, consulte Criar consultas geridas.

Por exemplo, aqui consultamos todos os itens de trabalho que são marcados ou WebService.

Screenshot de Editor do Power Query para consultar em tags.

Dica

Para entender como as AND/OR cláusulas são agrupadas, consulte Criar e guardar consultas geridas, cláusulas de grupo. Para visualizar a sintaxe WIQL para uma consulta, instale a extensão do editor de consulta WIQL que lhe permite ver a versão WIQL de qualquer entrada de editor de consulta.

Nota

A capacidade de consultar itens de trabalho que não tenham etiquetas anexadas a eles não é uma funcionalidade suportada. Se você quiser votar o pedido de suporte a esta funcionalidade, você pode fazê-lo na nossa página da Comunidade de Desenvolvedores, ser capaz de procurar por etiquetas vazias.

Mostrar tags nos resultados do seu atraso ou consulta

Escolha Opções de Coluna para adicionar o campo Tags ao atraso do produto ou a uma consulta de produto de trabalho. Se a opção não aparecer, escolha Mais comandos para selecioná-la no menu de opções.

Diálogo de opções de coluna, Adicione Tags às colunas selecionadas para visualizar.

Todas as etiquetas adicionadas aos itens de trabalho listados aparecem.

Screenshot do atraso do produto, Ver com a coluna Tags adicionada.

Listas de filtros usando tags

A partir do portal web, pode filtrar atrasos, placas e resultados de consulta usando tags.

Comece por escolher o Filtro .

Verifique as caixas das etiquetas que pretende filtrar. Mantenha a seleção DE OR para executar um OR lógico para todas as etiquetas selecionadas. Ou, escolha a opção E para executar um E lógico em todas as tags selecionadas.

Ver com coluna Tags adicionada

Eliminar, remover ou gerir tags

Não se pode apagar uma etiqueta em si. No entanto, se eliminar uma etiqueta de todos os itens de trabalho aos quais está atualmente atribuída, o sistema eliminará a etiqueta. O sistema elimina automaticamente as etiquetas não assinadas após três dias de inutilização.

Se soletrar mal uma etiqueta, não atribua a etiqueta mal escrita a qualquer item de trabalho e o sistema apagar-a-á automaticamente dentro de três dias.

Outra opção é instalar o Marketplace Tags Manager, que adiciona uma página tags em Placas ou Trabalho para gerir tags.

Etiquetas de código de cor nas placas

Você pode destacar tags em cartões de tabuleiro Kanban codificando-os a cores. Estas cores só aparecem no quadro kanban que você configura. Não aparecem em atrasos ou quadros. Para saber mais, consulte Personalizar cartões, etiquetas de código de cores.

Definições>de placas>Tag cores diálogo

Gráfico de trabalho e grupo por tags

Nota

Não é possível agrupar um gráfico baseado em consultas por tags, no entanto, pode agrupar um widget Chart for Work Items por etiquetas que adiciona a um dashboard. Esta funcionalidade está em pré-visualização pública. Para o ativar, consulte Gerir ou ativar as funcionalidades e ligar Ativar o grupo por tags para o widget de gráfico de artigos de trabalho no painel de instrumentos.

Para agrupar um widget de gráficos para itens de trabalho por tags, complete os mesmos passos fornecidos no progresso da Track com gráficos baseados em estado e tendências, Adicione um widget de gráfico a um dashboard. Certifique-se de que a sua consulta de lista plana contém Tags na cláusula de consulta ou como opção de coluna. Em seguida, escolha Tags para o Grupo por seleção. Para filtrar a tabela para mostrar apenas algumas etiquetas, escolha o botão de rádio de tags Selecionado e, em seguida, escolha as etiquetas que deseja que o gráfico apareça.

Screenshot de Gráfico por Itens de Trabalho, Configuração, Grupo por Tags.

Extensão do mercado

Limites ao número de etiquetas

Embora não exista um limite rígido, a criação de mais de 100.000 tags para uma coleção de projetos pode ter um impacto negativo no desempenho. Além disso, o menu de entrega automática para o controlo da etiqueta apresenta um máximo de 200 tags. Quando forem definidas mais de 200 tags, comece a escrever para que o controlo da etiqueta apresente etiquetas relevantes.

Não pode atribuir mais de 100 tags 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.

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 essa quantia e a consulta provavelmente vai sair.

Adicione etiquetas à vista da coluna predefinido no atraso do produto

Para adicionar o campo Tags como um campo de coluna para o atraso do produto, modifica o ficheiro ProcessConfiguration para incluir System.Tags. Para saber como, consulte a referência do elemento XML de configuração do processo.