Como consumir a Api JSON do Prolog diretamente no Power BI
6 min
Criado por Jean Zart em 07/06/2021 11:28
Atualizado por Nathalia em 08/03/2022 10:28

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

26402-working.gif

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]

warning.png 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

warning.png O nome tem que ser exatamente este.

A consulta está pronta!!! 42598rocket_99004.png 

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.

 

O que você achou deste artigo?
Últimos artigos visitados