Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice:


       

Índice
exclude.*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:

Deck of Cards
idDados Relacionais
Card
id1
labelProvedor banco de dados

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.

Aviso

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.

Informações

É 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:Image Removed

Image Added
Card
id2
labelProvedor integrado

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.

Informações

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

Dica

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

Expandir
titleProtocolo

Informe se o protocolo é http ou https

Expandir
titleHost

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

Expandir
titlePorta

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

Exemplo: 8051

Expandir
titleRota

Exemplo:

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

Expandir
titleTipo de autenticação

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:

Image RemovedImage Added

Dica
titleBuscar parâmetros

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

Dica

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

Card
id3
labelAPI Padrão Totvs

       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:

Image RemovedImage Added


Aviso
iconfalse

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.

Card
id4
labelCarol (Tempo real)

       Para criar um novo Provedor de Dados Carol - Tempo Real, 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:  Carol

Fonte de Dados: Carol  (Tempo Real)

Devem ser preenchidos os seguintes parâmetros:

ApiURL: Rota para alcançar os métodos da Api da Carol.

ConnectorId: Identificador do connector Carol que irá ser utilizado

ApiKey: Chave para acesso ao connector. (deve ser gerada na aplicação Carol)


Exemplo prático abaixo:



Aviso
iconfalse

Neste momento, o data provider do tipo Carol só está disponível para utilização em Dashboards.

Ao utilizar um Data Provider Carol numa fonte de dados do Dashboard, será necessário configurar a consulta Carol que deseja ser executada.


O TReports trabalha somente com os dados das agregações e subagregações utilizdas na consulta Carol. as inforações de chaves agrupadas (TERM, DATE_HISTOGRAM) e valores calculado de cada agrupamento (COUNT, MAXIMUM, MINIMUM,...) são disponibilizado para uso no dashboard.


Informações
iconfalse
Informações
iconfalse

Produto: Framework

Informações
iconfalse

Versão: 12.1.22 ou Superiores

Informações
iconfalse

Processo: Provedor de Dados

Informações
iconfalse
Informações
iconfalse

Status: Concluído

Informações
iconfalse

Data: 14/05/2019

Informações
iconfalse

Autores:

Aline Cristina Braz De Oliveira

Erlon Cesar Lima De Freitas

Flavio Henrique Pereira Campelo

Gustavo Naves De Castro

Lorena Roberta de Paiva Braga

Wesley Avelino De Carvalho