Como consumir a Api JSON do Prolog diretamente no Power BI

O Power BI é uma ferramenta de análise de dados muito poderosa e está sendo amplamente utilizado pelas empresas para melhorar a visualização dos dados e também tomar decisões.

Nós da Prolog, preparamos um tutorial exclusivo para vocês que possuem Power BI e querem utilizar os dados dentro do BI.

Com a nossa Api você conseguirá consumir todas as informações referentes à Aferições, Checklists, Ordens de Serviços, Movimentações e mais…

Confira nossa Api aqui: Prolog Api Docs

Consumindo o JSON de um Endpoint:

Para esse tutorial, é mandatório que você possua a ferramenta Power BI e domine os conceitos de tabelas, relacionamentos, consumo e geração de dados, bem como as demais funções da ferramenta.

Passo 1: Abra o seu Power BI

Aqui é onde os dados do Prolog estarão disponíveis para você montar as visões.

Passo 2: Acesse a opção Transformar dados

Nessa tela montaremos as nossas queries que acessarão o Prolog para buscar os dados.

Passo 3: Configurando os Parâmetros

Iremos configurar dois parâmetros para utilizar nas nossas queries posteriormente. Para isso, acesse o menu Gerenciar Parâmetros > Novo Parâmetro.

Você precisa criar dois parâmetros, com exatamente estes nomes:

BASE_PATH = https://prologapp.com/prolog/

TOKEN = [seu token]

O token é o que vai garantir a segurança do seu acesso. Ele é único e deve ser armazenado com cautela. Só fornecemos o token mediante solicitação ao suporte do Prolog.

Passo 4: Criando a Power Query para buscar dados

Utilize o menu Nova Fonte > Consulta Nula, para criar uma nova consulta.

Você verá uma tela assim:

Abra o Editor Avançado para podermos escrever nossa Power Query. Uma tela assim será mostrada:

Agora você precisa substituir o texto por este:

(codUnidades as text, dataInicial as text, dataFinal as text, pageSize as number, pageNumber as number, optional data as list) =>
let
 // Transformamos as unidades. 
 // - Remove espaços em branco.
 // - Formata para queryParam. Exemplo: 1,2,3 --> 1,&codUnidades=2&codUnidades=3.
 // Esse é o padrão de busca de dados para várias unidades, utilizando Query Params.
 CodUnidadesQuery = Text.Replace(Text.Remove(codUnidades, " "), ",", "&branchOfficesId="),

// Monta a URL para buscar os dados.
RelativePath = "api/v3/tire-inspections/individual-tire",
QueryParams = "?branchOfficesId=" & CodUnidadesQuery & "&startDate=" & dataInicial & "&endDate=" & dataFinal & "&pageSize=" & Number.ToText(pageSize) & "&pageNumber=" & Number.ToText(pageNumber),
 
 // Busca as aferições Avulsas.
 Fonte = Json.Document(Web.Contents(BASE_PATH & RelativePath & QueryParams, [Headers=[#"x-prolog-api-token" = TOKEN]])),
 
 // Combina os elementos com o resultado das buscas anteriores.
 AppendedData =
 if Fonte[empty] = true and data is null then {}
 else if data is null then Fonte[content]
 else if Fonte[empty] = true then data
 else List.Combine({data, Fonte[content]}),

// Atualiza variáveis que controlam a lógica de próxima busca.
 NewPageNumber = Fonte[pageNumber] + 1 as number,
 
 // Realiza próxima busca ou retorna todos os dados.
 OutputList =
 if Fonte[lastPage] = true
 then
 AppendedData
 else 
@#"GET AfericoesAvulsas"(codUnidades, dataInicial, dataFinal, pageSize, NewPageNumber, AppendedData),

// Converte saída para tabela.
 OutputTable = Table.FromList(OutputList, Splitter.SplitByNothing(), null, null, ExtraValues.Error)
in
 OutputTable

Agora, basta renomear o nome da sua query para: GET AfericoesAvulsas

O nome tem que ser exatamente este.

A consulta está pronta!!!

Passo 5: Buscando os dados

Com tudo pronto, basta inserir os parâmetros da busca e clicar em invocar.

Para preencher os parâmetros, verifique os exemplos presentes na documentação do Prolog.

Ao invocar, a function que acabamos de criar será acionada, e buscará as Aferições Avulsas. Ao final da busca, uma tabela com os dados será exibida e está tudo pronto para começar a transformar esses dados, gerando gráficos e visões sobre eles!

No exemplo, mostramos como consumir a Api do Prolog para buscar as Aferições Avulsas. Você pode replicar esse processo para consumir os demais recursos disponíveis na Api. Além disso, você pode personalizar ou criar o seu proprio script!

Sinta-se a vontade para compartilhar conosco qualquer sugestão de melhoria!

Ficou com alguma dúvida? Entre em contato com o nosso suporte através da nossa Central de Atendimento!

Abertura de Chamado - Como entrar em contato com a nossa equipe.

Olá, como podemos ajudar você?