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 do que é e de como funciona tela de Cadastro de Provedor de Dados.

Introdução:


       Um determinado "Provedor de Dados" deve ser criado para permitir o Reports Core comunicar 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    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 e será , é por ele que o Provedor de Dados será identificado.

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

Tipo do provedor:  Por enquanto a ferramenta só disponibiliza a opção "Dados relacionais"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
idFonte de Dados Relacionais
Card
id1
labelProvedor banco de dados

Com essa opção selecionada, o mecanismo de execução do T-Reports 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 T-Reports TReports tem a capacidade de trabalhar com os seguinte banco de dados relacionais: Oracle, Sql Server, PostGreeMySql, MySqlPostgre, 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 clique em "Buscar Parâmetros".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 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

Dica
titleBuscar parâmetros

Deve ser utilizado para recuperar as informações de conexão com uma determinada fonte de dados. Essas informações poderão ser configuradas no “Arquivo de Configuração” do serviço web de hospedagem do provedor.

Expandir
titleSql Server

Exemplo prático abaixo:

Image Removed

Protocolo

Informe se o protocolo é http ou https

Expandir
titleOracleHost

Nome da máquina que está rodando o RM.Host.exeEste método tem como finalidade realizar a exclusão de um registro contido na base de dados.

Expandir
titleMySqlPorta

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

Este método tem como finalidade realizar a exclusão de um registro contido na base de dados.

Expandir
titlePostgre

Este método tem como finalidade realizar a exclusão de um registro contido na base de dados.

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

Este método tem como finalidade realizar a exclusão de um registro contido na base de dados.

Expandir
titleDB2

Este método tem como finalidade realizar a exclusão de um registro contido na base de dados.

O Provedor Integrado....

Card
id23
labelProvedor integrado
Expandir
titleProtocolo
Expandir
titleHost
Expandir
titlePorta
Expandir
titleRota
Expandir
titleTipo de autenticação
Dica

Utilize o botão verde "Teste de conexão com o provedor" para testar sua conexão.

Endereço base do provedor de dados: Usado para informar um endereço web base contendo o endereço de localização de um determinado provedor. Esse provedor pode estar localizado em qualquer lugar da Web inclusive em uma máquina na núvem.

Caso não seja informado nenhum valor nesse campo, o provedor será o provedor local.

Dica

Para mais detalhes de como configurar a base de dados do TOTVS Reports, acesse a página BACKEND.

Exemplo prático abaixo:

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

Image Added


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.011.XX22 ou Superiores

Informações
iconfalse

Processo: Cadastro Provedor de Dados

Informações
iconfalse
Informações
iconfalse

Status: Pendente Concluído

Informações
iconfalse

Data: 08 14/1205/20172019

Informações
iconfalse

Autores:

Aline Cristina Braz De Oliveira

Erlon Cesar Lima De Freitas

Flavio Henrique Pereira Campelo

Gustavo Naves De Castro

Philippe Fernandes Lima Gonçalves

SARAH ROLAND CAMPOS LISBOALorena Roberta de Paiva Braga

Wesley Avelino De Carvalho