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

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

Marcar itens de trabalho o ajuda a filtrar rapidamente a lista de pendências do produto ou uma consulta de item de trabalho pelas categorias que você define. Uma marca corresponde a uma ou duas frases-chave que você define e que dá suporte às suas necessidades de filtrar uma lista de pendências ou uma consulta ou definir uma consulta.

As marcas são uma opção melhor para filtrar itens de trabalho do que usar cadeias de caracteres de texto, conforme descrito em Diretrizes para criar consultas de alto desempenho.

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

Observação

As marcas são um recurso compartilhado, estão associadas a um projeto e não a uma equipe. Se o projeto contiver várias equipes, todas as equipes adicionarão e trabalharão do mesmo conjunto de marcas.

Pré-requisitos

  • Você deve se conectar a um projeto. Se você ainda não tiver um projeto, crie um.
  • Você deve ser adicionado a um projeto. Para ser adicionado, adicione usuários a um projeto ou equipe.
  • Para exibir ou modificar itens de trabalho, você deve ter seus itens de trabalho de exibição neste nó e editar itens de trabalho neste nó definido como Permitir. Por padrão, o grupo Colaboradores tem esse conjunto de permissões. Para saber mais, consulte Definir permissões e acesso para o acompanhamento de trabalho.
  • Para adicionar novas marcas a serem adicionadas aos itens de trabalho, você deve ter acesso básico ou superior e ter as permissões de definição de marca no nível do projeto definidas como Permitir. Por padrão, o grupo Colaboradores tem esse conjunto de permissões. Mesmo que a permissão seja definida explicitamente para um Stakeholder, ela não terá permissão para adicionar novas marcas, pois elas são proibidas por meio de seu nível de acesso. Para saber mais, confira a referência rápida de acesso do Stakeholder.
  • Todos os membros do projeto, mesmo aqueles que pertencem ao grupo Leitores , podem enviar itens de trabalho por email.
  • Você deve se conectar a um projeto. Se você ainda não tiver um projeto, crie um.
  • Você deve ser adicionado a um projeto. Para ser adicionado, adicione usuários a um projeto ou equipe.
  • Para exibir ou modificar itens de trabalho, você deve ter seus itens de trabalho de exibição neste nó e editar itens de trabalho neste nó definido como Permitir. Por padrão, o grupo Colaboradores tem esse conjunto de permissões. Para saber mais, consulte Definir permissões e acesso para o acompanhamento de trabalho.
  • Para adicionar novas marcas a serem adicionadas aos itens de trabalho, você deve ter acesso básico ou superior e ter as permissões de definição de marca no nível do projeto definidas como Permitir. Por padrão, o grupo Colaboradores tem esse conjunto de permissões. Mesmo que a permissão seja definida explicitamente para um Stakeholder, ela não terá permissão para adicionar novas marcas, pois elas são proibidas por meio de seu nível de acesso. Para saber mais, confira a referência rápida de acesso do Stakeholder.
  • Todos os membros do projeto, mesmo aqueles que pertencem ao grupo Leitores , podem enviar itens de trabalho por email.

Observação

Os usuários com acesso do Stakeholder para projetos públicos têm permissão para adicionar novas marcas.

Adicionar marcas a um item de trabalho

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

Dica

Recomendamos que você 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, a marca 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.

Adicionar uma ou mais marcas a um item de trabalho

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, escolha o x na marca, excluir uma marca atribuída a um item de trabalho.

Observação

Por padrão, todos os Colaboradores e Stakeholders de projetos públicos recebem permissões para adicionar marcas novas e existentes. Os stakeholders em projetos privados podem adicionar marcas que já estão definidas, mas não adicionar novas marcas. Para conceder ou restringir permissões para criar novas marcas, defina a permissão Criar definição de marca no nível do projeto. Para saber mais, consulte Alterar permissões no nível do projeto.

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 em massa outros campos usando o portal da Web. Ou você pode usar o Excel para adicionar ou remover marcas em massa.

Caixa de diálogo Editar itens de trabalho, adicionar em massa a vários itens de trabalho.

Observação

Não há suporte para modificação em massa de marcas do Visual Studio ou de outros clientes com suporte.

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 à sua consulta.

Dica

Você pode usar os operadores Contains ou Does Not Contain . 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 Web ou Service.

Captura de tela de Editor de Consultas consultar em marcas.

Dica

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

Observação

A capacidade de consultar itens de trabalho que não têm marcas anexadas a eles não é um recurso com suporte. Se você quiser votar a solicitação para dar suporte a esse recurso, poderá fazê-lo em nosso Developer Community página, procure marcas 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.

Caixa de diálogo Opções de coluna, Adicionar Marcas às colunas selecionadas a serem exibidas.

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

Captura de tela da lista de pendências do produto, Exibição com a coluna Marcas adicionada.

Filtrar listas usando marcas

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

Comece escolhendo Filtro .

Marque as caixas dessas 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.

Exibir com a coluna Marcas adicionada

Excluir, remover ou gerenciar marcas

Você não pode excluir uma marca propriamente dita. No entanto, se você excluir uma marca de todos os itens de trabalho aos quais ela está atribuída no momento, o sistema excluirá a marca. O sistema exclui automaticamente marcas não atribuídas após três dias de desuso.

Se você escrever incorretamente uma marca, não atribua a marca incorreta a nenhum item de trabalho e o sistema a excluirá automaticamente dentro de três dias.

Outra opção é instalar o Gerenciador de Marcas do Marketplace, que adiciona uma página Marcas em Quadros ou Trabalho para gerenciar marcas.

Marcas de código de cor em placas

Você pode realçar marcas em cartões de placa Kanban codificando-as por cores. Essas cores aparecem apenas no quadro Kanban que você configura. Eles não aparecem em backlogs ou quadros de tarefas. Para saber mais, consulte Personalizar cartões, marcas de código de cor.

Caixa de diálogo Cores da Marca de Configurações de Quadros>>

Gráfico de itens de trabalho e agrupar por marcas

Observação

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

Para agrupar um widget gráfico para itens de trabalho por marcas, conclua as mesmas etapas fornecidas em Acompanhar o progresso com gráficos baseados em consulta de tendência e status, adicione um widget de gráfico a um painel. Verifique se sua consulta de lista simples contém marcas na cláusula de consulta ou como uma opção de coluna. Em seguida, escolha Marcas para o Grupo por seleção. 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.

Captura de tela de Gráfico por Itens de Trabalho, Configurar, Agrupar por Marcas.

Extensão do Marketplace

Limites no número de marcas

Embora nenhum limite rígido exista, criar 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 um máximo de 200 marcas. Quando mais de 200 marcas forem definidas, comece a digitar para fazer com que o controle de marca exiba 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, em seguida, você pode adicionar mais marcas.

Limite as consultas a menos de 25 marcas. Mais do que essa quantidade e a consulta provavelmente acabará.

Adicionar marcas à exibição de coluna padrão na lista de pendências do produto

Para adicionar o campo Marcas como um campo de coluna para a lista de pendências do produto, modifique o arquivo ProcessConfiguration para incluir System.Tags. Para saber como, consulte a referência do elemento XML de configuração do processo.