Tempo aproximado para leitura: 03 min

01. OBJETIVO

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

02. COMO FUNCIONA A INTEGRAÇÃO?

A integração será através do protocolo http/https com o Smart View, utilizando REST para fazer as chamadas do serviços padrões definidos pelo próprio Smart View, que os provedores integrados precisam implementar.
Portanto, o Protheus funcionará como um servidor que habilitará para os usuários criarem relatórios utilizando o Smart View, 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: https://[host]:[porta]/[uriprotheus]/api/protheus/dbdataproviders/v1.

Exemplo de configuração:

PROTOCOLO=https

HOST=ip ou dns do servidor

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 Smart View 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 Smart View 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.