Oi Pessoal!
Ao pesquisar sobre como consumir api's páginadas no powerbi encontrei alguns exemplos que utilizam a linguagem M, como no vídeo do colega Raphael Pacheco.
Esse post é uma alternativa a solução direta no powerbi utilizando M.
Minha motivação é diminuir a carga cognitiva do processo, visto que não sou um especialista em powerbi e não conheço muito M. Vamos isolar o powerbi apenas como a camada de montagem de painéis. Toda a lógica de integração fica em uma outra camada (logic app), os dados prontos para consumo ficam no storage account e disponibilizado através de uma url.
É provável que seja possível fazer o mesmo processo com o Power Automate.
Arquitetura
Vou focar na camada central que é a extração e preparação de dados, e partir do pressuposto que você já tenha algum conhecimento prévio em API's e Powerbi.
Recursos
Fonte Bruta - Api da Omie
Faça o download do postman.
Entre no site da omie e faça o cadastro.
Vamos usar a api de lista de produtos para esse exemplo.
Por algum motivo não conseguimos fazer a requisição conforme é apresentado na tela.
Ao inspecionar a requisição (aperte F12 no navegador), é possível ver que a requisição tem um parâmetro a mais, url, e temos que incluir esse para parâmetro para reproduzir em nossa aplicação.
Preencha a requisição no postman conforme as imagens abaixo:
A parte da resposta que contém a lista de produtos está em "response"
Por hora é isso, depois voltamos aqui.
Storage Account | Container - Azure
Vá até o portal do azure e crie um novo grupo de recursos.
Recomendo que você siga os nomes que vou atribuir aos recursos, ao menos pra esse tutorial.
Crie todos recursos desse tutorial dentro desse grupo de recursos.
Agora vamos criar um storage account.
Nessa estapa substitua o conteúdo de Storage account name
de nomeomie por {seunome}omie, pra evitar conflitos com a url.
Nessa etapa eu dei o nome de container de 'fonte-preparada' e configurei a camada de acesso como pública, para focarmos no processo de integração, mas em produção fique atento nas questões de segurança.
Nosso container para receber os dados está pronto.
Logic App
Volte até o grupo de recursos OMIE e clique novamente para adicionar um novo recurso.
Repare que o nosso storage já se encontra listado.
Recorrência
Na tela de designer, vamos definir a primeira etapa que é como esse procedimento será iniciado. Vamos escolher o método de recorrência e definir que ele seja repetido de 5 em 5 minutos. Estou definindo esse intervalo curto, pra podermos analisar os resultados em uma janela menor de tempo, mas faça como fizer sentido para você.
Dados da paginação
A próxima etapa é obter os dados da paginação de forma dinâmica. Para isso vamos fazer uma requisição a api, reservar os dados da página atual e total de páginas e desprezar o restante das respostas.
Esses são os dados que vamos reservar.
No nosso designer acrescente na sequencia uma etapa do tipo HTTP.
Configure essa etapa conforme fizemos no postman e a renomeie para "ObterDadosDaPagina", importante dizer o que estamos fazendo.
Propriedades da paginação
A próxima etapa é mapear a resposta da api, para que possamos usar suas propriedades como variáveis nas etapas a seguir.
Para isso vamos utilizar o método Parse Json.
Em content vamos utilizar o output Body da etapa anterior, que é o corpo da resposta da api.
Em Schema, clique em "Use sample payload to generate schema".
Agora copie e cole a reposta do postman na janela que vai abrir.
Esse procedimento vai auto mapear os nomes e tipos das propriedades da resposta.
Renomeie essa etapa como PropriedadesDaPagina
Variáveis
Na próxima etapa vamos definir as variáveis que vamos utilizar para as próximos métodos.
Produtos
Essa variável é do tipos lista e será iniciada como vazia, ela será responsável por armazenar as respostas das requisições.
Para isso vamos utilizar o método Variables.
Página
Agora vamos declarar a variável Pagina que será responsável por armazenar o número da página a ser requisitada.
Dessa vez vamos iniciar essa variável com o valor da propriedade pagina, obtida no output do método PropriedadesDaPagina.
Total de páginas
Vamos declarar a variável TotalDePaginas que será responsável por armazenar o número total de páginas a serem requisitadas.
Vamos iniciar essa variável com o valor da propriedade total_de_paginas, obtida no output do método PropriedadesDaPagina.
Recursão
Nessa etapa vamos declarar um método de recursão. A lógica aqui é fazer a requisição da página X, armazenar a resposta na variável produto, e repetir esse processo na página X + 1 até que o número total de páginas tenha sido requisitado.
Para isso vamos utilizar o método Until.
A lógica utilizada nesse laço de repetição é executar as tarefas a seguir até que o Total de páginas for menor que o valor da página.
Obter Produtos
Agora sim vamos fazer a requisição onde vamos o obter os valores para alimentar nossa resposta.
Dentro do laço vamos adicionar novamente o método HTTP, e configurá-lo quase igual a primeira vez que o fizemos. Porém dessa vez no body da requisição vamos substituir o valor da página que até então era 1 para o valor da variável página.
Propriedades Do Produto
Na sequência vamos executar novamente o método Parse Json para analisar a resposta da requisição feita na etapa anterior.
Em Schema, clique em "Use sample payload to generate schema" e vamos copiar e colar a reposta do postman na janela que vai abrir.
Esse procedimento vai auto mapear os nomes e tipos das propriedades da resposta. Porém dessa vez teremos que fazer uma alteração no mapeamento.
As propriedades peso_bruto e peso_liq tem que ter seu type substituído de integer para um array de tipos:
Isso deve ser feito sempre que um campo pode obter valores inteiros ou decimais.
Preencher Produtos
A próxima etapa é preencher a variável produtos com o valor da propriedade response anteriormente mapeada pelo método Propriedades do produto.
Para isso vamos utilizar o método Append to array variable.
Incrementar Página
Agora pra finalizar o laço vamos incrementar a variável página, fazendo com o que o seu valor seja X + 1.
Para isso vamos utilizar o método Increment Variable.
Criar arquivo
Agora vamos criar a última etapa dentro do logic app que é enviar a resposta como um arquivo no formato json para dentro do container no storage account.
Para isso vamos utilizar o método Create blob.
A primeira parte é criar uma conexão com o storage.
A segunda parte é configurar o blob, informar em qual container ele será salvo, seu nome seguido da extensão e o seu conteúdo. Infelizmente o Dynamic content não reconhece a variável Produtos como um valor elegível para o campo content, de forma que temos que incluí-la com uma expressão:
Ao final o processo terá o visual abaixo, após salvar vamos executar e ver o resultado.
Depois de executar, se tudo der certo o resultado será esse:
Confira indo até o storage account.
Agora você pode obter o link e abrir no powerbi.
Algumas considerações.
Esse post segue o caminho feliz.
Não foi analisado escala.
Não foi considerado segurança.
Não foi utilizado tratamento de erros.
Não foi considerado cargas incrementais, de forma que o arquivo é sempre substituído como o todo.
Espero que isso te ajude!
Top comments (2)
Olá Lucas, agradeço pelo tutorial aqui funcionou perfeitamente, agora preciso fazer melhorias de incluir os movimentos de contas a pagar e receber e colocar mais de um aplicativo do OMIE em minha consulta!
Boa tarde! Gostaria de saber se esse post refere se a redução do tempo de carregamento do power BI das paginações. Estou com esse problema e queria saber se solucionaria aplicado os conceitos deste post.