Criar um relatório do Power BI com uma consulta OData
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Com o Power BI Desktop, você pode começar facilmente a criar relatórios para seu projeto no Azure DevOps.
Se você não tiver Power BI Desktop, poderá baixá-la e instalá-la gratuitamente.
Siga as etapas para criar um relatório no Power BI desktop que mostre uma tendência diária de bugs.
- Criar uma consulta do Power BI
- Criar transformações do Power BI
- Criar um relatório de tendências de Bugs Abertos
Pré-requisitos
Para criar um relatório do Power BI, você deve atender aos seguintes critérios:
- Você deve ser membro de um projeto. Se você ainda não tiver um projeto, crie um. Consulte Inscreva-se gratuitamente.
- Se você não tiver sido adicionado como membro do projeto, será adicionado agora. Qualquer pessoa com acesso ao projeto, exceto as partes interessadas, pode visualizar as visualizações do Google Analytics.
- Defina a permissão Exibir Análise como Permitir. Consulte Conceder permissões para acessar o Google Analytics.
- Os quadros devem estar habilitados. Para habilitá-lo novamente, confira Ativar ou desativar um serviço do Azure DevOps.
- Instalou a atualização Power BI DesktopOctober 2018 ou a versão posterior. Você pode baixar esse aplicativo cliente na página oficial de download do Power BI Desktop.
- Acompanhe os itens de trabalho por algum período de tempo no qual gerar um relatório de tendência.
- Você deve ser membro de um projeto. Se você ainda não tiver um projeto, crie um.
- Se você não tiver sido adicionado como membro do projeto, será adicionado agora. Qualquer pessoa com acesso ao projeto, exceto as partes interessadas, pode visualizar as visualizações do Google Analytics.
- Ter ativado ou instalado o Google Analytics. Você deve ser um proprietário da conta ou um membro do grupo Administradores de Coleção de Projetos para adicionar extensões ou habilitar o serviço.
- Os quadros devem estar habilitados. Para habilitá-lo novamente, confira Ativar ou desativar um serviço do Azure DevOps.
- Defina a permissão Exibir Análise como Permitir. Consulte Conceder permissões para acessar o Google Analytics.
- Instalou a atualização Power BI DesktopOctober 2018 ou a versão posterior. Você pode baixar esse aplicativo cliente na página oficial de download do Power BI Desktop.
- Acompanhe os itens de trabalho por algum período de tempo no qual gerar um relatório de tendência.
Criar uma consulta do Power BI
Crie uma Consulta do Power BI para extrair os dados para o Power BI da seguinte maneira:
Escolha Obter Dados e, em seguida, Consulta em Branco.
No editor de Consultas do Power BI, escolha Editor Avançado.
A janela Editor Avançado é aberta.
Substitua o conteúdo pela consulta a seguir.
let Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/WorkItemSnapshot? " $apply=filter( WorkItemType eq 'Bug' AND StateCategory ne 'Completed' AND startswith(Area/AreaPath,'{areapath}') AND DateValue ge {startdate} )/ groupby((DateValue,State,WorkItemType,Area/AreaPath), aggregate($count as Count)) &$orderby=DateValue" ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) in Source
Substitua seus valores na consulta de exemplo.
A consulta de exemplo tem cadeias de caracteres que você deve substituir por seus valores:
{organization}
- Nome da sua organização{project}
- Nome do projeto da sua equipe. Ou omitir/{project}
totalmente, para uma consulta entre projetos{areapath}
- Seu caminho de área. Formato: Project\Level1\Level2{startdate}
- A data para iniciar seu relatório de tendências. Formato: AAAA-MM-DDZ. Exemplo:2022-09-01Z
representa 2022-setembro-01. Não coloque entre aspas.
Escolha Concluído para executar a consulta.
Se você nunca se conectou à sua conta, o Power BI pode exigir que você se autentique. Para obter mais informações, consulte Opções de autenticação de cliente.
Expandir colunas Área, Iteração, AtribuídoTo
A consulta retorna várias colunas que você precisa expandir antes de usá-las no Power BI. Qualquer entidade puxada usando uma $expand
instrução retorna um registro com potencialmente vários campos. Você precisa expandir o registro para nivelar a entidade em seus campos. Exemplos de tais entidades são: AssignedTo
, , Iteration
e Area
.
Depois de fechar o Editor Avançado e enquanto permanecer no Editor do Power Query, selecione o botão de expansão nas entidades que você precisa nivelar.
Por exemplo, escolha o botão de expansão para Área, selecione as propriedades que deseja expandir e escolha OK. Aqui, escolhemos
AreaName
eAreaPath
achatamos. AAreaName
propriedade é semelhante ao campo Nome do Nó.Observação
As propriedades disponíveis a serem selecionadas dependem das propriedades solicitadas para retornar na consulta. Se você não especificar nenhuma propriedade, todas as propriedades estarão disponíveis. Para saber mais sobre essas propriedades, consulte as seguintes referências de metadados: Áreas, Iterações e Usuários.
A tabela agora contém campo(s) de entidade.
Repita as etapas 1 a 3 para todos os campos que representam entidades que precisam de expansão. Eles aparecem com Registro listado na coluna da tabela quando não expandidos.
Renomeie campos e consulta e, em seguida, Feche & Apply
Quando terminar, você pode optar por renomear colunas.
Clique com o botão direito do mouse em um cabeçalho de coluna e selecione Renomear...
Você também pode querer renomear a consulta do padrão Query1, para algo mais significativo.
Depois de terminar, escolha Fechar & Aplicar para salvar a consulta e retornar ao Power BI.
Criar o relatório
O Power BI mostra os campos sobre os quais você pode gerar relatórios.
Observação
O exemplo abaixo pressupõe que ninguém renomeou nenhuma coluna.
Para um relatório simples, execute as seguintes etapas:
- Selecione Gráfico de linhas de visualização do Power BI.
- Adicione o campo "DateValue" ao Axis
- Clique com o botão direito do mouse em "DateValue" e selecione "DateValue", em vez de Date Hierarchy
- Adicione o campo "Estado" à legenda
- Adicione o campo "Contagem" a Valores
- Clique com o botão direito do mouse no campo WorkItemId e verifique se a opção Soma está selecionada
O exemplo de relatório:
Próximas etapas
Artigos relacionados
- Visão geral de relatórios de exemplo usando consultas OData
- Construir consultas OData para Análise
- Conectar-se usando consultas do Power BI e OData
- Referência de metadados para o Azure Boards Analytics
- Relatórios de exemplo e índice de referência rápida
- Adicionar uma segmentação de equipe a um relatório existente
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de