Í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".
Informações |
---|
title | Provedor banco de dadosDados Relacionais:
Deck of Cards |
---|
id | Fonte de Dados Relacionais |
---|
|
Card |
---|
id | 1 |
---|
label | Provedor 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 : Expandir |
---|
| Este método tem como finalidade realizar a exclusão de um registro contido na base de dados. |
Expandir |
---|
| Este método tem como finalidade realizar a exclusão de um registro contido na base de dados. |
Expandir |
---|
| Este método tem como finalidade realizar a exclusão de um registro contido na base de dados. |
Expandir |
---|
| Este método tem como finalidade realizar a exclusão de um registro contido na base de dados. |
Expandir |
---|
| Este método tem como finalidade realizar a exclusão de um registro contido na base de dados. |
Expandir |
---|
| Este método tem como finalidade realizar a exclusão de um registro contido na base de dados. |
| Card |
---|
| Este serviço disponibiliza métodos para manipulação de processos existentes no RM. Alguns exemplos que podem ser citados: Baixa de lançamentos; Associação de Objetos ao Contrato; Envio de Documentos Eletrônicos; etc. Métodos disponíveis: Expandir |
---|
| Este método tem como finalidade realizar a exclusão de um registro contido na base de dados. |
|
Informações |
---|
|
Deck of Cards |
---|
|
Card |
---|
|
Card |
---|
|
Card |
---|
|
Informações |
---|
title | Provedor de banco de dados relacional |
---|
|
O mecanismo de execução do reports 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 Reports tem a capacidade de trabalhar com os seguinte banco de dados relacionais: Oracle, Sqlserver, PostGree, MySql, Firebird. Provedor de dados Default: Foi criado no reports um provedor de dados default que poderá ser utilizado por qualquer ERP da Totvs ou concorrente. Provedor de dados específico: Foi criado um provedor especifico para o ERP RM. Para utilizar esse provedor, basta informar no campo "Endereço base do provedor de dados" o endereço do Host do RM. Ex: http://nome_da_maquina:8051/dbdataproviders. Nesse caso, a extração dos dados nesse provedor passará por todo o mecanismo de segurança do ERP RM. 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. |
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.
Buscar 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. Essas informações poderão ser alteradas pelo usuário na tela de provedor.
Parâmetros do Provedor:
ServerName: Informe o servidor.
DataBaseName: Informe o nome da base da dados.
UserId: Informe o usuário.
Password: Informe a senha.
Informações |
---|
Utilize o botão verde "Teste de conexão com o provedor" para testar sua conexão. |
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
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 Added |
Card |
---|
id | 2 |
---|
label | Provedor 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 |
---|
| Informe se o protocolo é http ou https |
Expandir |
---|
| Nome da máquina que está rodando o RM.Host.exe |
Expandir |
---|
| Informe a porta em que os serviços estão registrados. Exemplo: 8051 |
Expandir |
---|
| Exemplo: Default: api/trep/v1/dbdataproviders Protheus: api/protheus/dbdataproviders/v1 |
Expandir |
---|
title | Tipo 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 |
---|
| 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 |
---|
| 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 Rota: Nome 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 |
---|
| 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 |
---|
id | 4 |
---|
label | Carol (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 |
---|
| 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.
|
|