Índice
Introdução
Para que o TReports seja capaz de recuperar dados externos para utilização de seus recursos, como por exemplo, a geração de relatórios retornando informações de um determinado Produto, é necessário que o sistema consiga se comunicar com esse Produto, fazendo dele um Provedor de Dados para as informações do Relatório. Essa comunicação é feita através de um Conector.
A comunicação e busca de dados que será realizada pelo TReports necessita de uma conexão entre o TReports e o Provedor. Dessa forma, o Conector servirá como o cadastro que indica a qual Provedor o TReports irá se comunicar para retornar os dados.Um conector pode estabelecer comunicação com dois tipos de provedores:
- Provedor Nativo - Provedor de dados oriundo de ERP Totvs que disponibiliza objetos de negócio previamente cadastrados no Produto;
- Provedor SQL - Provedor de dados oriundo de um Banco de Dados ou ERP Totvs via provedor integrado. Nesse tipo de provedor é necessário a criação dos objetos de negócios no próprio TReports.
Informações |
---|
O cadastro e gerenciamento de Conectores é restrito ao usuário definido como Administrador do TReports. |
Provedor Nativo
- O endereço do Provedor deve ser informado para o cadastro e validação da conexão.
No cadastro do Provedor Nativo é necessário informar um nome para o Conector e a URL disponibilizada pelo Produto. Após o preenchimento das informações, deve-se validar a conexão com o Provedor Nativo através do botão "Testar conexão". Após confirmação de que o Conector está funcionando, clicar em "Salvar" para concluir o cadastro.
Abaixo um exemplo de configuração de Conector com Provedor Nativo:
Image Added
O Conector do tipo Provedor Nativo permite que os dados fornecidos para geração de relatórios, assim como o gerenciamento desses dados, sejam feitos pelo próprio Produto.
Provedor Sql
- O nome do Provedor deve ser informado juntamente com os parâmetros de configuração para o cadastro e validação da conexão.
Para adicionar um novo parâmetro basta clicar no botão de mais '+', informar nome e valor, depois é preciso clicar novamente no botão de mais '+' para adiciona-lo ou no botão de excluir para deleta-lo.
![](/download/attachments/633538858/image2021-11-9_13-41-42.png?version=1&modificationDate=1636476103203&api=v2)
Os bancos de dados disponiveis são: Oracle, MySQL, PostgreSQL e SQLServer, também é possivel utilizar Provedor Integrado.
Objetos de Negócio
Para que um Relatório retorne os dados de um Conector, é necessário que essas informações sejam buscadas de um Objeto de Negócio.
Ao contrário do Provedor Nativo onde os Objetos de Negócio são previamente definidos, para o Provedor Sql os Objetos de Negócio serão cadastrados diretamente na aplicação.
- O nome, descrição e as áreas desejadas são totalmente customizáveis, além disso, é necessario uma consulta SQL para informar os dados que o objeto de negócio fornecerá. Para salvar todas as infomações é necessário fazer a pré-visualização dos dados.