Configurar um gráfico para o widget de itens de trabalho

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

O widget Gráfico para Itens de Trabalho permite selecionar qualquer consulta de lista simples e configurá-la para dar suporte a qualquer um dos tipos de gráfico com suporte. As etapas que você executa para configurar esse widget são muito semelhantes às que você executa para configurar um gráfico baseado em consulta.

Para exibir um gráfico em um painel, você pode começar na página Consultas>Gráficos e optar por adicionar o gráfico ao painel. Os gráficos adicionados ao painel aparecem como um widget Gráfico para Itens de Trabalho que você pode renomear, redimensionar e reconfigurar. Ou você pode adicionar um widget Gráfico para Itens de Trabalho , selecionar a consulta e configurar o gráfico normalmente.

A única tarefa que você pode realizar no widget Gráfico para Itens de Trabalho que não pode ser realizada na página Consultas>Gráficos é agrupar itens de trabalho por Etiquetas. Esse recurso tem suporte para Azure DevOps Server 2022 e versões posteriores.

Pré-requisitos

Observação

Os usuários com acesso de Stakeholders para um projeto público têm acesso completo aos recursos de gráfico de consultas, assim como os usuários com acesso Básico. Para mais informações, veja Referência rápida de acesso das partes interessadas.

Categoria Requirements
Access Membro do projeto com pelo menos acesso Básico . Os usuários com acesso ao Stakeholder não podem exibir ou criar gráficos na página Consultas. Eles podem exibir gráficos adicionados a um painel de equipe. Para mais informações, veja Referência rápida de acesso das partes interessadas.
Permissões - Por padrão, usuários com pelo menos acesso Básico podem criar gráficos. Os usuários com acesso de Stakeholders não podem exibir ou criar gráficos da página Consultas, no entanto, eles podem exibir gráficos adicionados ao dashboard de uma equipe. Para mais informações, veja Referência rápida de acesso das partes interessadas.
– Para salvar uma consulta em uma pasta de Consultas Compartilhadas : permissões para salvar consultas em uma pasta. Para obter mais informações, confira Definir permissões em consultas e pastas de consulta.
– Para adicionar um widget a um painel de equipe: membro da equipe ou membro do grupo de segurança Administradores do Projeto .
– Para adicionar um widget a um painel de projeto: criador do painel, ou permissões de edição para o painel, ou membro do grupo de segurança Administradores do Projeto.
- Para exibir um widget com base em consulta adicionado a um painel: permissões de Leitura para a consulta subjacente. Se essa permissão for negada, o widget exibirá um Widget com falha ao carregar a mensagem.
Consultas – Somente consultas de lista simples dão suporte a gráficos .
- Para adicionar um gráfico a um painel: salve a consulta em uma pasta de Consultas Compartilhadas . Para fazer isso, obtenha permissões para salvar consultas em uma pasta.

Para obter mais informações sobre permissões de painel, consulte Definir permissões de painel.

Definir e salvar uma consulta de lista simples

No widget de Gráfico para Itens de Trabalho, selecione a consulta que contém os itens de trabalho que deseja representar em um gráfico. Ao criar uma consulta para dar suporte ao seu gráfico, siga as diretrizes fornecidas em Criar uma consulta de lista simples.

Dica

Se você começar a configurar um widget Gráfico para Itens de Trabalho e adicionar a consulta que deseja selecionar, você deverá atualizar a página do painel para poder selecionar a consulta recém-adicionada.

Criar um painel

Antes de adicionar um widget a um painel, você deve primeiro adicionar o painel ao projeto. Para saber como, consulte Adicionar, renomear e excluir painéis.

Adicionar o widget Gráfico para Itens de Trabalho a um painel

  1. No portal da Web, abra o painel ao qual você deseja adicionar o gráfico.

  2. Para adicionar widgets ao painel, selecione Editar para abrir o catálogo de widgets.

    Observação

    Se você não vir a opção Editar, precisará obter permissões para editar o painel.

  3. Selecione o widget Gráfico para Itens de Trabalho e, em seguida, selecione Adicionar ou arraste-o para o painel.

    Portal da Web, página Painéis, no catálogo de Widgets, Widget de gráfico para itens de trabalho

  4. Para configurar o widget, selecione Mais ações do widget e escolha a opção Configurar.

    Captura de tela do widget do painel Mais opções de menu de ações.

    A caixa de diálogo Configuração é aberta.

  5. Insira um Título, selecione a Largura e a Altura e, em seguida, selecione a Consulta de lista plana na qual o gráfico se baseia. Em seguida, escolha o tipo de gráfico.

  6. Dê um título ao gráfico, selecione a consulta de lista simples na qual o gráfico se baseia e escolha o tipo de gráfico.

    Caixa de diálogo de configuração para widget de itens de trabalho do gráfico, Azure DevOps Server 2020 e versões superiores.

    Com base no tipo de gráfico, especifique valores para os campos restantes. Altere uma cor do gráfico escolhendo outra cor daquelas mostradas. Para obter diretrizes adicionais sobre como escolher e configurar tipos de gráficos específicos, consulte Acompanhar o progresso com gráficos baseados em consulta de status e tendência.

  7. Depois de salvar suas alterações, você verá que o novo gráfico foi adicionado ao painel.

    Widget de gráfico para itens de trabalho, Foco no tipo e exemplo de estado.

    Dica

    Se o gráfico não exibir todas as linhas ou colunas desejadas, tente alterar a Largura e a Altura do gráfico. As tabelas dinâmicas e outros tipos de gráfico exibirão mais dados com base na área fornecida no painel.

  8. Arraste o tile em qualquer lugar do painel para colocá-lo onde desejar.

  9. Quando terminar de fazer as alterações, selecione Edição concluída para sair do modo de edição do painel.

Gráfico de Agrupamento por Tags

Observação

Não é possível 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 dashboard.

Para agrupar um gráfico por tags, execute as mesmas etapas fornecidas na seção anterior. 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, selecione Tags para a opção agrupar por. Para filtrar o gráfico para mostrar apenas algumas tags, selecione o botão de opção Tags selecionadas e escolha as tags que deseja que o gráfico exiba.

Captura de tela do gráfico por itens de trabalho, Configurar, Agrupar por Tags.

Para obter mais informações sobre como usar marcas, consulte Adicionar marcas a itens de trabalho.