Share via


Configurar um gráfico para widget de itens de trabalho

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

O widget Gráfico para Itens de Trabalho permite selecionar qualquer consulta de lista simples e configurá-la para suportar qualquer um dos tipos de gráficos suportados. 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 Gráficos de consultas>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 rerotular, 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 a partir do widget Gráfico para Itens de Trabalho que não pode ser realizada na página Gráficos de Consultas>é agrupar itens de trabalho por Tags. Esse recurso é suportado para o servidor Azure DevOps 2022 e versões posteriores.

Pré-requisitos

Os pré-requisitos a serem atendidos incluem ter as permissões necessárias, definir e salvar uma consulta de lista simples na pasta Consultas Compartilhadas e criar o painel onde você deseja adicionar o widget.

Permissões

Por padrão, os usuários com acesso Básico ou superior podem criar gráficos. Os usuários com acesso de partes interessadas não podem visualizar ou criar gráficos na página Consultas , no entanto, eles podem exibir gráficos adicionados a um painel de equipe. Para obter detalhes, consulte Referência rápida de acesso das partes interessadas.

  • Para salvar uma consulta em uma pasta Consultas Compartilhadas , você deve receber permissões para salvar consultas em uma pasta. Para obter permissões concedidas, consulte Definir permissões em consultas e pastas de consulta.
  • Para adicionar um widget a um painel de equipe, você deve ser membro da equipe ou do grupo de segurança Administradores de Projeto .
  • Para adicionar um widget a um painel do projeto, você deve ter criado o painel ou receber permissões para editá-lo ou ser membro do grupo de segurança Administradores de Projeto .
  • Para exibir um widget baseado em consulta adicionado a um painel, você deve ter permissões de Leitura para a consulta subjacente. Se essa permissão tiver sido negada, o widget será exibido com uma mensagem de falha ao carregar o widget.

Nota

Os usuários com acesso de partes interessadas para um projeto público têm acesso total aos recursos do gráfico de consulta, assim como os usuários com acesso Básico . Para obter detalhes, consulte Referência rápida de acesso das partes interessadas.

  • Para salvar uma consulta em uma pasta Consultas Compartilhadas , você deve receber permissões para salvar consultas em uma pasta. Para obter permissões concedidas, consulte Definir permissões em consultas e pastas de consulta.
  • Para adicionar um widget a um painel de equipe, você deve ser membro da equipe ou do grupo de segurança Administradores de Projeto .
  • Para exibir um widget baseado em consulta adicionado a um painel, você deve ter permissões de Leitura para a consulta subjacente. Se essa permissão tiver sido negada, o widget será exibido com uma mensagem de falha ao carregar o widget.

Para saber mais sobre permissões de painel, consulte Definir permissões de painel.

Definir e salvar uma consulta de lista simples

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

Gorjeta

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

Criar um dashboard

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.

    Nota

    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, Catálogo de widgets, Widget 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 do menu de ações.

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

  5. Introduza um Título, selecione a Largura e 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 de gráfico, Azure DevOps Server 2020 e versões posteriores.

    Com base no tipo de gráfico, especifique valores para os campos restantes. Altere a cor de um gráfico simplesmente escolhendo outra cor entre as mostradas. Para obter orientações adicionais sobre como escolher e configurar tipos de gráficos específicos, consulte Acompanhar o progresso com gráficos baseados em consultas de status e tendência.

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

    Gráfico para widget de itens de trabalho, pivô no tipo e exemplo de estado.

    Gorjeta

    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áficos exibirão mais dados com base na área fornecida no painel.

  8. Arraste o bloco para qualquer lugar no painel para colocá-lo onde quiser.

  9. Quando terminar as alterações, selecione Edição concluída para sair do modo de edição do 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.

    Nota

    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, Catálogo de widgets, Widget 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 do menu de ações.

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

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

    Caixa de diálogo de configuração para widget de itens de trabalho de gráfico, Azure DevOps Server 2019.

    Com base no tipo de gráfico, especifique valores para os campos restantes. Altere a cor de um gráfico simplesmente escolhendo outra cor entre as mostradas. Para obter orientações adicionais sobre como escolher e configurar tipos de gráficos específicos, consulte Acompanhar o progresso com gráficos baseados em consultas de status e tendência.

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

    Widget gráfico de itens de trabalho, caixa de diálogo configurar

    Gorjeta

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

  7. Arraste o bloco para qualquer lugar no painel para colocá-lo onde quiser.

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

Gráfico 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.

Para agrupar um gráfico por tags, execute as mesmas etapas fornecidas na seção anterior. 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, selecione Tags para o grupo por seleção. Para filtrar o gráfico para mostrar apenas algumas etiquetas, selecione o botão de opção Etiquetas selecionadas e, em seguida, escolha as etiquetas que pretende que o gráfico apresente.

Captura de tela de Gráfico por itens de trabalho, Configurar, Agrupar por tags.

Para saber mais sobre como usar tags, consulte Adicionar tags a itens de trabalho.