Introdução

A Cobli possui uma API (Application Program Interface) que você pode utilizar para fazer integrações com outros sistemas da sua empresa.

Documentação da API: https://docs.cobli.co/

Uma das formas de utilizar a API da Cobli é conectando-a a ferramentas de Business Intelligence (BI) para poder utilizar relatórios específicos que façam sentido para o seu negócio. Para utilizar essa ferramenta de maneira mais prática, disponibilizamos um executável que baixa as dependências na sua máquina e gera os scripts automaticamente.

Você vai precisar gerar uma Chave de API para a integração, saiba como aqui: https://suporte.cobli.co/pt-BR/articles/5569498-como-gerar-chaves-para-consumir-as-apis-da-cobli

OBS: Este manual se refere a versão 0.0.4 do executável

Os dados que serão integrados por este executável são:

  • Dispositivos: dados do veículo e motoristas associado e da última localização do dispositivo;

  • Checklists: dados de todas as checklists cadastradas na frota;

  • Comprovantes: dados dos últimos 6 meses dos comprovantes cadastrados na frota;

  • Gastos: dados dos últimos 6 meses de gastos de combustível e manutenção da frota;

  • Incidentes: dados dos últimos 6 meses de incidentes da frota;

  • Performance: dados dos últimos 6 meses da performance do motorista e veículo.

Passo inicial: instalação do Power BI

Para seguir os passos adiante, é importante que tenha a ferramenta Power BI Desktop instalada na sua máquina. É importante que faça isso de um computador com sistema operacional Windows, devido aos requisitos do produto da Microsoft.

Procure por "Microsoft Power BI Desktop"neste link

Passo 1: faça o download do executável

Para isso, acesse o link https://github.com/Cobliteam/cobli-bi/releases/latest, você encontrará o arquivo "cobli-bi.zip", baixe-o em seu computador, após isso, extraia o arquivo clicando com o botão direito nele e selecionando a opção "Extrair aqui".

Passo 2: execute o arquivo

Nesse passo, você deve acessar a pasta "dist" da pasta que acabou de baixar, e executar o arquivo "main.exe", esse arquivo irá abrir uma nova janela e irá fazer o download de todas as dependências necessárias, esse processo pode demorar alguns minutos dependendo das dependências a serem instaladas, não feche a janela até que o processo seja concluído.

Depois de baixadas todas as dependências, uma nova janela será aberta, você deve informar o nome das frotas e as chaves APIs associadas a cada frota.

Caso possua mais de uma frota, clique no botão "Adicionar" e informe a outra frota e a outra chave API associada a essa frota, caso não possua, clique no botão "Gerar Script".

Por fim, uma nova aba será aberta com o conteúdo do script, copie todo o conteúdo, usaremos esse conteúdo na última etapa.

Passo 3: descobrir o local de instalação do Python

Agora que o executável instalou o Python, uma das dependências, em seu computador, precisamos descobrir o local exato onde ele está instalado, para isso, abra o terminal e digite o comando "where python":

Esse comando irá mostrar o local em que o python se encontra no seu computador. No exemplo acima, foi mostrado que o python se encontra em:

C:\Users\Matheus\AppData\Local\Microsoft\WindowsApps

Guarde esse caminho, pois usaremos na próxima etapa.

Passo 4: definir o local do Python no Power BI

Agora que temos o caminho do Python, abra o Power BI e vá em arquivo > opções, depois configurações > opções > scripts do Python. Em "Defina um diretório raiz para o Python", aperte o botão "Procurar" e selecione a pasta anotada no passo anterior, por fim, clique em "OK".

OBS: Essa etapa é necessária apenas se o Power BI não conseguir identificar o caminho do Python automaticamente.

Passo 5: importar script no Power BI

Acesse o Power BI e no menu superior, na página inicial, clique em "Obter Dados", depois clique em "Mais…" e selecione "Script do Python", você pode utilizar a barra de pesquisa ou clicar em "Outro".

Ao conectar com o Script do Python, uma nova janela será aberta para digitar o Script, basta copiar o conteúdo da etapa anterior (Passo 2), colar nessa nova janela e clicar em "OK". Esse processo pode demorar cerca de 5 minutos, não feche a janela até que o processo seja concluído.

E pronto! Seus dados da Cobli estão integrados e prontos para uso no PowerBI.

Obrigado,

Time Cobli

Encontrou sua resposta?