Compartilhar via


Criar um relatório do Power BI a partir de um modo de exibição de Análise padrão

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

Neste início rápido, você usará um modo de exibição de Análise padrão para criar dois relatórios do Power BI para seu projeto do Azure DevOps - um gráfico de tendência diário de itens de backlog por estado e um cartão que mostra a contagem atual de histórias de usuários ativos. Usando exibições do Analytics, você pode definir critérios de filtro para dados de acompanhamento de trabalho sem gravar consultas OData.

Você pode usar uma das exibições padrão internas ou criar uma exibição de Análise personalizada para obter mais controle sobre filtros e campos.

Importante

As exibições do Analytics só dão suporte a dados do Azure Boards (itens de trabalho). As exibições do Analytics não oferecem suporte a outros tipos de dados, como pipelines. As exibições fornecem uma lista simples de itens de trabalho e não dão suporte a hierarquias de item de trabalho. Neste ponto, não há planos para atualizar o conector para dar suporte a outros tipos de dados. Para obter informações sobre outras abordagens, consulte Sobre a integração do Power BI.

Dica

Você pode usar a IA para ajudar nessa tarefa mais adiante neste artigo ou consulte Ativar a assistência de IA com o Azure DevOps Server MCP para começar.

Pré-requisitos

Categoria Requisitos
Níveis de Acesso - Membro do projeto.
- No mínimo, acesso Básico.
Permissões A permissão Exibir Análise definida como Permitir. Para obter mais informações, consulte Definir permissões para acessar Análise de dados e visões de análise.
Ferramentas - Os Quadros do Azure ativados.
- Power BI Desktop.
Tarefas Monitore itens de trabalho durante um período especificado para gerar um relatório de tendência.
Categoria Requisitos
Níveis de Acesso - Membro do projeto.
- No mínimo, acesso Básico.
Permissões A permissão Exibir Análise definida como Permitir. Para obter mais informações, consulte Definir permissões para acessar Análise de dados e visões de análise.
Ferramentas - A extensão Analytics. Os membros do grupo Administradores de Coleção de Projetos podem adicionar e habilitar o serviço.
- Os Quadros do Azure ativados.
- Power BI Desktop.
Tarefas Monitore itens de trabalho durante um período especificado para gerar um relatório de tendência.

Abrir o Analytics para acessar exibições

Do seu portal web, selecione Boards>Exibições do Analytics.

Se você não vir exibições do Analytics, verifique se você tem permissões para exibir o Analytics. Consulte permissões e pré-requisitos para acessar o Analytics.

Captura de tela do portal web do Azure DevOps. Ao lado, as visões Boards e Análises são destacadas. O painel principal lista visões compartilhadas.

Verificar a vista padrão do Analytics

Antes de se conectar ao Power BI, verifique se o modo de exibição padrão é carregado corretamente. A verificação captura problemas como conjuntos de dados muito grandes ou referências de campo inválidas antes que eles causem falhas de atualização do Power BI.

  1. Na página De exibições do Analytics , selecione a guia Todos .

  2. Selecione o ícone Mais Ações no modo de exibição padrão e selecione Editar. Para projetos Agile, use o modo de exibição Histórias – Últimos 30 dias .

    Captura de tela da página de visualizações do Analytics. No menu de atalho para a exibição Histórias – Últimos 30 dias, Editar está destacado.

  3. Selecione a guia Verificação e, em seguida, selecione Verificar exibição.

    Captura de tela da caixa de diálogo para edição do modo de exibição Histórias – Últimos 30 dias. Na guia Verificação, o modo de exibição Verificar está realçado.

    O tempo de verificação depende do escopo da sua visualização. Uma visualização com escopo para histórias com um período contínuo de 30 dias se verifica mais rapidamente do que uma visualização que inclui todos os tipos de item de trabalho e todo o histórico.

    Captura de tela da caixa de diálogo para edição do modo de exibição Histórias – Últimos 30 dias. Na guia Verificação, uma mensagem indica que a exibição foi verificada.

  4. Se a verificação for bem-sucedida, continue para a próxima etapa. Se falhar, vá para a guia Itens de Trabalho e reduza o escopo , por exemplo, selecione menos equipes ou restrinja os tipos de item de trabalho. Para obter mais informações, consulte Criar uma exibição de Análise.

Conectar-se a uma visualização de Análise

Siga estas etapas para conectar a uma visão do Analytics:

  1. Abra o Power BI Desktop.

  2. Entre no serviço. O acesso pela primeira vez exige que você entre e autentique suas credenciais. O Power BI Desktop salva suas credenciais, portanto, você só precisa entrar uma vez.

    Observação

    O Azure DevOps não dá suporte a cenários entre locatários que usam OAuth (Autorização Aberta). Em vez disso, use entidades de serviço e identidades gerenciadas.

  3. Selecione Conectar.

    Captura de tela que mostra a janela de diálogo de Conexão do Power BI, com uma mensagem sobre estar logado e o botão Conectar realçado.

  4. Selecione Obter Dados>Serviços Online e, em seguida, selecione Azure DevOps (somente Quadros) para serviços de nuvem ou Azure DevOps Server (somente Quadros) para um servidor local. Selecione Conectar. As visualizações de análise dão suporte a consultas apenas para itens de trabalho e casos de teste.

    Captura de tela do Power BI com Obter dados, Serviços Online e os serviços do Azure DevOps realçados.

  5. Especifique os parâmetros básicos para se conectar aos seus dados.

    Captura de tela da caixa de diálogo Azure DevOps (somente Boards). Os campos de projeto Organização e Equipe estão realçados.

    Captura de tela da caixa de diálogo do Servidor do Azure DevOps (apenas Boards). Os campos URL de Coleção e Projeto de Equipe, assim como o botão OK, estão destacados.

    • URL de coleta: digite o URL em que sua instância Azure DevOps Server está hospedada. Um exemplo de URL é https://fabrikam-server/AzureDevOpsServer/fabrikam-collection.
    • Projeto em equipe: digite apenas o nome do projeto. Por exemplo, digite Fabrikam-Fiber caso a URL da instância do Azure DevOps Server seja https://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber.

    Importante

    Não confunda o nome da equipe com o nome do projeto, o que é um erro comum. Por exemplo, se a URL usada for https://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber-Git/Device, Fabrikam-Fiber-Git for o nome do projeto e Dispositivo for o nome da equipe.

    Depois de entrar com êxito, o Power BI verifica se suas credenciais têm as permissões necessárias para acessar o projeto especificado. Para obter soluções para problemas comuns, consulte Solução de problemas.

Selecione a exibição do Analytics

Siga estas etapas para selecionar o modo de exibição de análise:

  1. Expanda Exibições Compartilhadas. O Conector de Dados apresenta uma lista de visões de Análise disponíveis. Cada exibição representa um conjunto de dados que você pode importar para o Power BI. Você também pode criar exibições personalizadas do Analytics.

    A imagem a seguir mostra as exibições padrão do Analytics. Sua lista de exibições pode ser diferente com base no modelo de processo usado para criar seu projeto. Todas as exibições listadas, exceto as exibições acrescentadas ao Today, fornecem dados de tendência históricos.

    Captura de tela da caixa de diálogo Navegador. A pasta Exibições Compartilhadas é realçada e expandida, com várias exibições padrão visíveis.

  2. Selecione os Itens de Trabalho – Exibição dos últimos 30 dias e aguarde até que a visualização seja carregada. Essa exibição usa um filtro para mostrar os últimos 30 dias de histórico para todos os itens de trabalho no projeto.

    Observação

    Se você verificar a visualização ao criá-la, ela deverá ser carregada. Se a exibição não for carregada, é mais provável que o conjunto de dados seja muito grande. Retorne à página de visualizações do Analytics no portal da web e abra a visualização para edição. Ajuste os filtros para diminuir o tamanho do conjunto de dados.

    Captura de tela da caixa de diálogo Navegador. O modo de exibição Itens de Trabalho – Últimos 30 dias está selecionado e realçado e sua visualização está visível.

    Observação

    • A visualização mostrada para qualquer exibição selecionada no navegador pode ser truncada dependendo do número de campos selecionados e do tamanho do conjunto de dados. Os dados são truncados apenas para a visualização e não afetam a atualização de dados completa.
    • As exibições do Analytics não aplicam filtros definidos usando o Power BI no servidor. Todos os filtros aplicados no Power BI limitam os dados mostrados aos usuários finais, mas não reduzem a quantidade de dados recuperados do Analytics. Se o filtro tiver a intenção de reduzir o tamanho do conjunto de dados, aplique-o personalizando a exibição.
  3. Marque a caixa de seleção ao lado do modo de exibição Histórias – Últimos 30 dias e selecione Carregar. Aguarde o carregamento dos dados. Monitore seu progresso por meio das mensagens de status exibidas sob o nome da tabela. Para obter soluções para problemas comuns, consulte Solução de problemas.

    Captura de tela da janela do modo de exibição Histórias – Últimos 30 Dias. Um anel de progresso parcial e uma mensagem de Avaliação estão visíveis.

  4. Examine o modelo de dados. Enquanto o modelo é carregado, examine a estrutura do conjunto de dados para o Conector de Dados do Power BI.

Criar um relatório de tendência diário

  1. No painel Visualizações , selecione o visual do gráfico de linhas . No painel Dados , pesquise a ID do Item de Trabalho e marque a caixa de seleção para adicioná-la como o valor do eixo Y do gráfico.

    Captura de tela de um relatório em branco no Power BI Desktop. O ícone gráfico de linhas, o campo de pesquisa e a ID do Item de Trabalho estão realçados.

    O gráfico exibe um único ponto porque você ainda não definiu um eixo de data.

    Dica

    Para redimensionar o gráfico, vá para Exibir>Exibição de página>Tamanho real, e então arraste as alças do gráfico.

    Captura de tela de um relatório do Power BI Desktop com um gráfico de linhas. O menu Exibir, a visualização de página e o tamanho real na visualização de página são destacados.

  2. No painel Dados , selecione Data para adicioná-lo como o eixo X. O Power BI usa como padrão uma hierarquia de datas (dia do trimestre >> do ano>), que agrupa todas as datas que compartilham o mesmo número do dia. Para ver uma tendência diária real, vá para o painel Visualizações, expanda a lista suspensa Data no eixo X e selecione Data em vez de Hierarquia de Data.

    Captura de tela de um gráfico de linhas. Os dados e o campo Data são realçados. No menu de atalho do campo Data, a data é selecionada e realçada.

    Observação

    Sempre use o formato Data para relatórios de tendências, não a Hierarquia de Datas. O nível de dia da hierarquia atribui todas as datas a um número entre 1 e 31, então 3 de abril e 3 de maio, ambos mapeados para o dia 3, têm suas contagens combinadas.

Agrupar e filtrar a tendência por estado

  1. No painel Dados , arraste o campo Estado para a área Legenda do painel Visualizações . O gráfico agora exibe uma linha separada para cada estado.

  2. Para limitar quais estados aparecem, expanda o campo Estado no painel Filtros e selecione apenas os valores desejados – por exemplo, Ativo, Fechado e Confirmado.

O gráfico a seguir mostra uma contagem diária distinta de histórias de usuário para cada estado selecionado.

Captura de tela de um gráfico com linhas para contagens ativas, fechadas e comprometidas. O filtro de Estado e a legenda de Visualizações são realçados.

Dica

Se você modificar sua exibição de Análise após a conexão, retorne ao Power BI e selecione Atualizar na guia Página Inicial para efetuar pull dos dados atualizados.

Captura de tela da guia Página Inicial da faixa de opções do Power BI Desktop. No grupo Consultas, Atualizar está destacado.

Criar um cartão para mostrar a contagem de histórias ativas mais recente

  1. Adicione uma nova página selecionando o sinal de adição (+) na parte inferior da página.

  2. No painel Visualizações , selecione o visual cartão . No painel Dados , selecione o campo ID do Item de Trabalho para adicioná-lo ao cartão.

  3. No painel Filtros , arraste o Estado para os Filtros nesta área de página e selecione apenas Ativo.

    O cartão exibe 111 neste exemplo. Esse número é inflado porque conta cada instantâneo diário de cada história de usuário ativo durante o período de 30 dias, e não apenas o último dia.

    Captura de tela de um visual de cartão que exibe uma contagem de 111. O ícone de cartão e o filtro Ativo estão realçados.

  4. Para mostrar apenas a contagem atual, adicione o filtro Is Current :

    1. Arraste Is Current para a área de Filtros nesta página.
    2. Selecione True para que o cartão conta apenas a última revisão de cada história de usuário.

    As exibições de análise incluem automaticamente o campo Is Current para sinalizar o instantâneo mais recente. Quando você aplica esse filtro, a contagem cai para 16 – o número real de histórias de usuários ativos hoje.

    Captura de tela de um visual de cartão que exibe uma contagem de 16. No painel Filtros, o filtro É Atual está realçado e True está selecionado.

    Esse valor deve corresponder à contagem no último dia do gráfico de tendências que você criou na seção anterior.

Usar a IA para criar relatórios do Power BI a partir de exibições do Analytics

Se você configurar o Servidor MCP do Azure DevOps, poderá usar assistentes de IA para ajudar a criar e refinar relatórios do Power BI.

Prompts de exemplo

Tarefa Prompt de exemplo
Tendência de erro por intervalo de datas Write an OData trend query that shows the daily bug count by state over the last 30 days in <ProjectName>.
Instantâneo de sprint Create an OData query against WorkItemSnapshot that shows work item counts grouped by date for the current sprint in <ProjectName>.
Filtrar por iteração Generate an OData trend query that uses the iteration start and end dates from <IterationName> to show story point burndown in <ProjectName>.
Tendência de coluna de quadro Write an OData query against WorkItemBoardSnapshot to track work items by board column over the past two weeks in <ProjectName> in the <OrganizationName> organization.
Otimizar o desempenho My WorkItemSnapshot trend query for <ProjectName> is timing out. Suggest specific date filters and aggregation to reduce the row count without losing the key metrics.
Comparar sprints Create an OData trend query that compares bug counts between <SprintName> and the previous sprint in <ProjectName> in the <OrganizationName> organization.
Tendência de trabalho restante Write an OData trend query that shows the daily sum of remaining work grouped by Area Path for the current iteration in <ProjectName>.
Detectar alterações de estado Create an OData snapshot query that tracks how many work items moved from Active to Resolved each day over the past <NumberOfDays> days in <ProjectName>.
Análise de alteração de escopo Generate an OData trend query that shows the daily count of user stories added or removed from <SprintName> by comparing WorkItemSnapshot data in <ProjectName>.

Dica

Se você estiver usando o Visual Studio Code, o modo de agente será especialmente útil para criar e refinar relatórios do Power BI a partir de exibições do Analytics.