Contextualização
O TProvider é um provedor de dados que foi desenvolvido para integrar o TReports com as bases de dados de diferentes produtos TOTVS.
Após a configuração do TProvider as documentações das APIs podem ser encontradas no endereço:
http://$URL_TPROVIDER$:PORT/TProvider/swagger-ui.html#/
- Configuração do Servidor de Aplicação Tomcat 9
No site https://tomcat.apache.org/download-90.cgi → Selecione em "Download" o link "Tomcat 9" → Binary Distributions → Core → E a distribuição desejada.
Descompacte o arquivo em um diretório de sua escolha.
Para que o Tomcat funcione corretamente é necessário que esteja instala um "Java Developmente Kit" (JDK) na versão 8 ou superior.
Configurar o arquivo %TOMCAT_HOME%\conf\server.xml:- Número da porta TCP: O númera padrão da porta TCP para o Tomcat é 8080, mas qualquer número entre 1024 e 65535 pode ser escolhido para seu servidor.
- Apagar todos os arquivos da pasta %TOMCAT_HOME%\webapps e mover o arquivo “TProvider.war” para este diretório.
Utilização com Banco de dados Oracle
Incluir o jar ojdbc7.jar na pasta %TOMCAT_HOME%\lib.
Alterar o arquivo de configuração %TOMCAT_HOME%\conf\context.xml, incluindo a tag<Resource> conforme o exemplo em: TProvider.zip\TProvider\oracle.
Utilização com Banco de dados Microsoft SQL Server
Incluir o jar jtds-1.3.1.jar na pasta %TOMCAT_HOME%\lib.
Alterar o arquivo de configuração %TOMCAT_HOME%\conf\context.xml, incluindo a tag<Resource> conforme o exemplo em: TProvider.zip\TProvider\mssql.
Configuração de Usuário e Senha, no PIMS Multicultivos
O usuário e senha para autenticação do TProvider, encontram-se na tabela PRXPARAMETER, os parâmetros não são visíveis para o usuário no menu Configurações Gerais do PIMS Multicultivo, o identificador do parâmetro referente ao “Usuário” é 4703 e o identificador referente ao parâmetro “Senha” é 4704.
Regras de rede, firewall e hosts
Após a configuração dos passos acima, deve-se assegurar que o servidor, agentes e outros sistemas possam conectar-se um ao outro por meio de redes e firewalls.
O TProvider deve ter acesso a rede/firewall para todos os recursos da URL conforme segue abaixo:
- IP e/ou DNS (de acordo com configuração local);
- Porta (de acordo com configuração local);
- Rota (/TProvider/api/trep/v1/dbdataproviders);
- Swagger (TProvider/swagger-ui.html#/);
Mapeamento de hosts:
- Incluir no arquivo “C:\Windows\System32\drivers\etc\hosts” o relacionamento do IP Privado do TProvider ao seu respectivo hostname (DNS), conforme exemplos abaixo:
127.0.0.111 hom.tprovider.totvs.com.br
127.0.0.222 prod.tprovider.totvs.com.br- Caso o TReports esteja configurado em um servidor diferente do TProvider o arquivo hosts do deste outro servidor também deverá receber o mapeamento acima.
- Na Integração entre TProvider e TReports, caso estejam em servidores diferentes, ambos os hosts devem ser mapeados.
Configuração do Provedor Integrado no TReports.
Após acessar o menu “Provedores de dados” no TReports, clique no botão “Novo”;
Informe o “Código” e a “Descrição” e para o “Tipo do provedor” selecione Dados relacionais;
Em “Fonte de dados” selecione “Provedor Integrado”, após selecionar esta opção, novos campos serão habilitados, após para o campo “Protocolo” selecione “http”, para o “Host” informe o “IP” ou “DNS” e para “Porta” a porta para acessar o TProvider;
Para o campo “Rota” informe “/TProvider/api/trep/v1/dbdataproviders”, o “Tipo de autenticação” será o “Basic”;
Nos campos “Usuário” e “Senha” informe os valores configurados nos parâmetros 4703 e 4704 do passo anterior, após ter preenchido todos os campos clique em “Testar conexão”, uma notificação deverá aparecer informando “Conexão Ok”.
A documentação da Configuração de um Provedor de Dados para o TReports está disponível em: Provedor de Dados#1
