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

#HtmlFragment()