Configurar um gráfico para widget de itens de trabalho
Azure DevOps Services | 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 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 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
No portal da Web, abra o painel ao qual você deseja adicionar o gráfico.
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.
Selecione o widget Gráfico para itens de trabalho e, em seguida, selecione Adicionar ou arraste-o para o painel.
Para configurar o widget, selecione Mais ações do widget e escolha a opção Configurar.
A caixa de diálogo Configuração é aberta.
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.
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.
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.
Depois de salvar as alterações, você verá que o novo gráfico foi adicionado ao painel.
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.
Arraste o bloco para qualquer lugar no painel para colocá-lo onde quiser.
Quando terminar as alterações, selecione Edição concluída para sair do modo de edição do painel.
No portal da Web, abra o painel ao qual você deseja adicionar o gráfico.
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.
Selecione o widget Gráfico para itens de trabalho e, em seguida, selecione Adicionar ou arraste-o para o painel.
Para configurar o widget, selecione Mais ações do widget e escolha a opção Configurar.
A caixa de diálogo Configuração é aberta.
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.
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.
Depois de salvar as alterações, você verá que o novo gráfico foi adicionado ao painel.
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.
Arraste o bloco para qualquer lugar no painel para colocá-lo onde quiser.
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.
Para obter mais informações sobre como usar tags, consulte Adicionar tags a itens de trabalho.