Page tree
Skip to end of metadata
Go to start of metadata

Tempo aproximado para leitura: 03 min

01. OBJETIVO

Permitir a configuração do Protheus como provedor integrado dentro da aplicação TReports. O TReports é uma ferramenta para a geração de relatórios utilizando fontes de dados externas.
Para utilização do TReports, será necessário a configuração no servidor. Seguem os links dessa configuração:
Instalação do TReports
Portabilidade TReports

02. COMO FUNCIONA A INTEGRAÇÃO?

A integração será através do protocolo http/https com o TReports, utilizando REST para fazer as chamadas do serviços padrões definidos pelo próprio TReports, que os provedores integrados precisam implementar.
Portanto, o Protheus funcionará como um servidor que habilitará para os usuários criarem relatórios utilizando o TReports, e fornecerá os dados para estes relatórios.


03. CONFIGURAÇÃO

Para a configuração do Protheus é necessário preencher a empresa e filial nos parâmetros do cadastro de Provedores de Dados.

As informações de protocolo, host, porta e rota da seguinte forma: http://[host]:[porta]/[uriprotheus]/api/protheus/dbdataproviders/v1.

Exemplo de configuração:

PROTOCOLO=http

HOST=ip ou nome_da_maquina

PORTA=porta_do_rest_Protheus

ROTA=[uri_protheus]/api/protheus/dbdataproviders/v1



Os serviços disponíveis com a integração:

  • Configuração dos parâmetros de execução do TReports com o Protheus
  • Teste de conexão com os parâmetros preenchidos
  • Teste de query como fonte de dados para relatório
  • Recuperação dos campos de uma tabela física do Protheus
  • Recuperação da estrutura dos campos de uma query
  • Caminho de relacionamento entre duas tabelas físicas de negócio, por exemplo SB1990 e SB5990
  • Consulta das tabelas registradas no SX2 para uso como fonte de dados nos relatórios
  • Execução de relatórios no RM TReports com os dados sendo providos pelo Protheus


Endpoints Protheus

GET /api/protheus/dbdataproviders/v1/parameters => implementado
POST /api/protheus/dbdataproviders/v1/testconnection => implementado
POST /api/protheus/dbdataproviders/v1/testquery => implementado
POST /api/protheus/dbdataproviders/v1/schema/table => implementado
POST /api/protheus/dbdataproviders/v1/schemasql => implementado
POST /api/protheus/dbdataproviders/v1/relations => implementado
POST /api/protheus/dbdataproviders/v1/search/tables => implementado
POST /api/protheus/dbdataproviders/v1/data => implementado
POST /api/protheus/dbdataproviders/v1/paths => implementado


04. Informações adicionais

O EndPoint search/tables utilizado na pesquisa por tabelas, caso seja informado um conteúdo com até 3 caracteres será considerado uma pesquisa de nome de arquivo ex.: SB1, caso informado Produto, agora será possível retornar todas as tabelas que possuem o nome produto.



DISPONIBILIDADE

Disponível a partir da LIB versão 20190131