ūüĒ¶ Nova solu√ß√£o de relat√≥rios por API dispon√≠vel!

  • 26 July 2022
  • 6 replies
  • 883 views
ūüĒ¶ Nova solu√ß√£o de relat√≥rios por API dispon√≠vel!
Userlevel 3

Ol√°, Comunidade Pipefy,

 

Temos uma ótima notícia: agora, você pode integrar o Pipefy com sua ferramenta de relatórios, como PowerBI ou DataStudio, por meio de API! Veja como:

 

Com Relat√≥rios, voc√™ pode filtrar dados dos seus processos em tempo real, organiz√°-los em colunas e export√°-los em formato de uma planilha de Excel para analisar as informa√ß√Ķes que deseja.

 

Se sua equipe precisa exportar relatórios com frequência e em um determinado período de tempo, você pode automatizar esse processo!

 

Configure uma rotina de API Scheduler para automatizar a extração do relatório utilizando uma mutation. O relatório será exportado no período de tempo que você determinar no seu scheduler.

 

Para fazer a extração do relatório são necessárias duas chamadas, a primeira é uma mutation que obterá na resposta um ID para ser utilizado na extração, e a segunda, é uma query, que utilizará a resposta obtida na primeira para obter a URL de download do relatório.

 

A chamada inicial é como segue, nela devem ser informados o ID do Pipe onde o relatório está salvo e o ID do relatório já formatado com todas as colunas e filtros que deseja visualizar na planilha extraída. Ambos os IDs podem ser obtidos na URL da página.


 

mutation {

  exportPipeReport(input: { pipeId: 1, pipeReportId: 1}) {

    pipeReportExport {

      id

    }

  }

}

 

A resposta desta chamada conterá um ID numérico. Utilizando desse ID obtido na chamada anterior, você poderá rodar a seguinte query:

 

{

  pipeReportExport(id: 20) {

    fileURL

    state

    startedAt

    requestedBy {

      id

    }

  }

}


 

A resposta da chamada conterá a URL (fileURL) que você pode acessar para fazer o download do relatório, na sua plataforma de integração.

 

√Č importante ressaltar que a constru√ß√£o do relat√≥rio para exporta√ß√£o pode demorar um pouco dependendo do volume de informa√ß√Ķes. Fique atento e, se necess√°rio, deixe um per√≠odo de tempo para o download. No momento que o relat√≥rio estiver formatado para a exporta√ß√£o a informa√ß√£o ‚Äústate‚ÄĚ deve retornar como ‚Äúdone‚ÄĚ.

 

Tudo feito, basta fazer a carga em sua ferramenta de BI ou enviar para algum email como anexo!


Atualização!

Rate Limits

Essa feature possui Rate Limits, uma t√©cnica comum para garantir seguran√ßa, confiabilidade e uma experi√™ncia consistente ao¬†desenvolvedor, limitando o n√ļmero de solicita√ß√Ķes em um intervalo de tempo.

Para exporta√ß√£o de relat√≥rios via API, o rate limit √© de 25 solicita√ß√Ķes em 24 horas, para cada pipe.
Caso atinga esse limite, deve-se aguardar 24 horas a partir do momento em que a √ļltima solicita√ß√£o foi feita. Qualquer solicita√ß√£o nesse intervalo de tempo n√£o ser√° processada e conter√° uma mensagem de rate limit atingido exibida em "erros" no payload de resposta.


6 replies

Userlevel 1

Boa tarde!
você teria um exemplo com o script completo e o passo a passo para integrar no Powerbi ou DataStudio?

Userlevel 3
Badge +1

Como faço para obter o histórico das fases ? Entendo que estes dados não estão via relatório, certo? e, portanto, não consigo extrair via estas APIs...

Userlevel 1

Boa tarde!
você teria um exemplo com o script completo e o passo a passo para integrar no Powerbi ou DataStudio?

Boa tarde! No caso essas chamadas tem a função de obter o relatório automaticamente por API. Uma vez o relatório extraído você pode alimentar, com os dados do relatório, uma tabela utilizada para a consulta de dados pela sua ferramenta de BI. Você também pode salvar na pasta com o mesmo nome da tabela utilizada para a consulta e substituindo a anterior, assim a ferramenta de BI já retornará os novos valores para as colunas.

Userlevel 3
Badge +1

Boa tarde!
você teria um exemplo com o script completo e o passo a passo para integrar no Powerbi ou DataStudio?

Boa tarde! No caso essas chamadas tem a função de obter o relatório automaticamente por API. Uma vez o relatório extraído você pode alimentar, com os dados do relatório, uma tabela utilizada para a consulta de dados pela sua ferramenta de BI. Você também pode salvar na pasta com o mesmo nome da tabela utilizada para a consulta e substituindo a anterior, assim a ferramenta de BI já retornará os novos valores para as colunas.

Entendi, Guilherme. Fiz o teste usando o GraphiQL. Aqui, então, é apenas para automatizar o que já fazemos manualmente abrindo Relatórios no Pipe e exportando-o.

O nome do relatório vem sempre com a data. Tem como já vir sempre com o mesmo nome? Ou teria de fazê-lo manualmente? Ter sempre o mesmo nome facilita a integração.

Userlevel 3
Badge +1

Boa tarde!
você teria um exemplo com o script completo e o passo a passo para integrar no Powerbi ou DataStudio?

Boa tarde! No caso essas chamadas tem a função de obter o relatório automaticamente por API. Uma vez o relatório extraído você pode alimentar, com os dados do relatório, uma tabela utilizada para a consulta de dados pela sua ferramenta de BI. Você também pode salvar na pasta com o mesmo nome da tabela utilizada para a consulta e substituindo a anterior, assim a ferramenta de BI já retornará os novos valores para as colunas.

Entendi, Guilherme. Fiz o teste usando o GraphiQL. Aqui, então, é apenas para automatizar o que já fazemos manualmente abrindo Relatórios no Pipe e exportando-o.

O nome do relatório vem sempre com a data. Tem como já vir sempre com o mesmo nome? Ou teria de fazê-lo manualmente? Ter sempre o mesmo nome facilita a integração.

Encontrei este artigo sobre como fazer direto no pwbi https://www.linkedin.com/pulse/connect-powerbi-graphql-endpoint-amir-khan/

Userlevel 1

Boa tarde!
você teria um exemplo com o script completo e o passo a passo para integrar no Powerbi ou DataStudio?

Boa tarde! No caso essas chamadas tem a função de obter o relatório automaticamente por API. Uma vez o relatório extraído você pode alimentar, com os dados do relatório, uma tabela utilizada para a consulta de dados pela sua ferramenta de BI. Você também pode salvar na pasta com o mesmo nome da tabela utilizada para a consulta e substituindo a anterior, assim a ferramenta de BI já retornará os novos valores para as colunas.

Entendi, Guilherme. Fiz o teste usando o GraphiQL. Aqui, então, é apenas para automatizar o que já fazemos manualmente abrindo Relatórios no Pipe e exportando-o.

O nome do relatório vem sempre com a data. Tem como já vir sempre com o mesmo nome? Ou teria de fazê-lo manualmente? Ter sempre o mesmo nome facilita a integração.

Exato! A ideia é automatizar a extração de relatórios do processo. Por padrão ele mantém a data ao lado do nome do relatório, mas dependendo da ferramenta que você estiver usando para automatizar a extração você poderá alterar o nome do arquivo ao salvar na pasta destino.

Reply