Índice:


       

Objetivo:


       O objetivo deste documento é trazer uma visão de como funciona tela de Provedor de Dados.

Introdução:


       Um determinado "Provedor de Dados" deve ser criado para permitir que o TReports se comunique com uma determinada fonte de dados. Todas as informações a serem mostradas em um determinado relatório serão recuperadas de um determinado provedor de dados. Atualmente a ferramenta disponibiliza as opções: Dados Relacionais e API Padrão TOTVS.

       Em uma empresa, diversos provedores de dados poderão ser cadastrados, buscando dados em locais completamente diferentes.

       Em um único relatório, dados poderão ser recuperados de provedores de dados diferentes.

       Ex: Meu relatório pode ser gerado em minha empresa porém as informações desse relatório podem estar localizadas na nuvem.

Como criar:


       Para criar um novo Provedor de Dados, basta clicar em "+ Novo" e informar os campos abaixo:

Código do provedor: Informe o código do Provedor de Dados, deve ser um código único, é por ele que o Provedor de Dados será identificado.

Descrição: Informe uma descrição.

Tipo do provedor:  Dados Relacionais.

Fonte de Dados: Selecione se a fonte de dados será um "Provedor banco de dados" ou "Provedor integrado".

Dados Relacionais:

    Com essa opção selecionada, o mecanismo de execução do TReports enviará para um determinado provedor uma série de sentenças SQL (de acordo com o relatório criado).

    Essas sentenças SQL serão executadas nesses provedores que são responsáveis em chamar uma determinada Fonte de Dados.

    Atualmente o TReports tem a capacidade de trabalhar com os seguinte banco de dados relacionais: Oracle, Sql Server, MySql, Postgre, Firebird e DB2.

    Apesar de suportar os bancos citados acima, o TReports foi homologado somente em SQL e ORACLE.

    Selecione o tipo de banco de dados desejado e note que os parâmetros do banco são buscados automaticamente.

    É possível adicionar ou remover um parâmetro, desde que o mesmo não seja do tipo senha.

    Para isso, basta clicar nos botões azuis de "Adicionar" ou "Excluir".

    Preencha as informações do Banco de Dados clicando em "Editar" e informando o "Valor".

    Exemplo prático abaixo:


    O Provedor Integrado é um provedor remoto. Nesse caso, a extração dos dados nesse provedor passará por todo o mecanismo de segurança do ERP.

    Abaixo, será dado o exemplo do ERP RM. Porém, outros provedores de dados específicos de outros ERPS poderão ser criados. Para isso, basta seguir uma especificação de criação de provedores.

    Para mais detalhes de como criar um Provedor Integrado, acesse a página Provedor Integrado.

    É necessário que o Host.exe esteja em execução e o arquivo de configuração do Host tenha os parâmetros HTTPPORT e DEFAULTDB devidamente preenchidos.

    Informe se o protocolo é http ou https

    Nome da máquina que está rodando o RM.Host.exe

    Informe a porta em que os serviços estão registrados.

    Exemplo: 8051

    Exemplo:

    Default: api/trep/v1/dbdataproviders 
    Protheus: api/protheus/dbdataproviders/v1

    Basic: Neste tipo de autenticação é necessário informar o Usuário e Senha do RM.

    OAuth: Neste tipo de autenticação não é necessário informar o Usuário e Senha do RM, ele é buscado automaticamente pelo usuário que está logado no TReports.

    Exemplo prático abaixo:

    Buscar parâmetros

    Deve ser utilizado para recuperar as informações de conexão com uma determinada fonte de dados.

    Utilize o botão "Testar conexão" para testar sua conexão.

           Para criar um novo Provedor de Dados API PAdrão TOTVS, basta clicar em "+ Novo" e informar os campos abaixo:

    Código do provedor: Informe o código do Provedor de Dados, deve ser um código único, é por ele que o Provedor de Dados será identificado.

    Descrição: Informe uma descrição.

    Tipo do provedor:  Api Padrão TOTVS.

    Fonte de Dados: Api Git.

    Complemento da RotaNome do diretório virtual. Ex.: Nome do diretório virtual do iis.

    Protocolo: Selecione se o protocolo é HTTP ou HTTPS.

    Host: Nome da máquina.

    Porta: Você informa a porta do seu protocolo. Porém vem marcado por default porta 80 quando selecionado http e porta 443 quando selecionado https.

    Tipo de Autenticação: Informações de segurança.

       - Basic: Chamada da API.
       - OpenID: Autenticação onde solicita o access token de um service provider. 
    Ex.: rac google service provider. 

    Exemplo prático abaixo:


    Na elaboração de um relatório, etapa de Conexões, quando selecionado o tipo API, não será possível incluir/utilizar outro tipo de conexão.

    Produto: Framework

    Versão: 12.1.22 ou Superiores

    Processo: Provedor de Dados