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 funciona como um servidor que habilitará para o clientes 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

<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>