Histórico da Página

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

Image RemovedImage Added

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.

<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>