Árvore de páginas

Versões comparadas

Chave

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

Índice


Índice
exclude.*ndice

Introdução


    Para que o TReports seja capaz de Smart View possa recuperar dados externos para utilização de e utilizar seus recursos, como por exemplo, a geração de relatórios retornando com informações de um determinado ProdutoERP TOTVS, é necessário que o sistema consiga se comunicar comunique com esse Produto, fazendo dele ERP, tornando-o um Provedor de Dados para as informações do Relatório.

    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.

os relatórios. Essa comunicação é estabelecida por meio de um Conector.

Um Conector pode estabelecer comunicação com dois tipos de provedores:

  • Provedor Nativo: Provedor de dados originário de um ERP TOTVS, que disponibiliza objetos de negócio previamente cadastrados.
  • Provedor SQL: Provedor de dados originário de um Banco de Dados ou ERP TOTVS, por meio de um provedor integrado. Nesse tipo de provedor, é necessário criar os objetos de negócio diretamente no Smart View.


info
Aviso
titleImportante

O cadastro e gerenciamento de Conectores é restrito ao usuário definido como Administrador do TReportsutilizado na configuração do Agent, na etapa do Provedor de Segurança (ver Configurações do Sistema (Versões 3.5 e Anteriores)). Para os demais usuários, o menu de Conectores não estará disponível.

Aviso
titleCLOUD

Clientes CLOUD não possuem o gerenciamento de Conectores. A configuração é realizada automaticamente no momento do provisionamento do Smart View. Além disso, em CLOUD não será disponibilizado Provedor Sql.

Aviso

Não é possível apagar um conector que possua objetos de negócios associados à recursos de quaisquer usuários.

Provedor Nativo

  • O endereço do Provedor deve ser informado para o cadastro e validação da conexão.

     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.

Dica

A integração dos Produtos para servirem como Provedores de Dados para o TReports é realizada conforme especificado na RFC010001.
Disponível em: https://arquitetura.totvs.io/architectural-records/RFCs/Framework-BH/RFC010001/

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.
Image Removed

No cadastro do Provedor Nativo, é necessário informar um nome para o Conector e a URL disponibilizada pelo ERP TOTVS. Após preencher essas informações, deve-se validar a conexão com o Provedor Nativo clicando no botão "Testar conexão". Com a confirmação de que o Conector está funcionando, clique em "Salvar" para concluir o cadastro.

A seguir, um exemplo de configuração de um Conector com Provedor Nativo:
Image Added

Image Added


Dica
titleDocumentações dos ERPs

Consulte a documentação específica do seu ERP para saber qual o endereço deve ser preenchido na configuração do conector:

Provedor SQL


Aviso

Desaconselhamos o acesso direto ao banco de dados e recomendamos a utilização do Provedor Nativo para acessar os Objetos de Negócio criados pela TOTVS ou desenvolvidos diretamente no ERP. Essa abordagem oferece maior segurança, respeitando as permissões definidas no ERP.

Acesse os links abaixo para saber como criar Objetos de Negócio no seu ERP:

Cadastro de Provedor SQL
Image Added

No cadastro de Provedor SQL é necessário primeiramente escolher o tipo de provedor a ser utilizado, podendo ser:

  • SQL Server;
  • PostgreSQL;
  • MySQL;
  • Oracle.


Nota
iconfalse

A opção de Provedor Integrado foi descontinuada na versão 3.3 do Smart View;

Em seguida, é necessário informar um nome para o Provedor de Dados e preencher os parâmetros de configuração, que variam conforme o tipo de provedor escolhido. Para cada tipo de provedor, são solicitados os parâmetros básicos de conexão. Caso seja necessário adicionar algum parâmetro adicional, clique no botão abaixo:
Image Added

Em seguida deve-se preencher os campos Nome e Valor do parâmetro:
Image Added


Caso um parâmetro não seja necessário, basta clicar no ícone de Lixeira à sua frente.

SQL Server

Para o Provedor de Dados SQL Server, os parâmetros de configuração básicos são:
Image Added


Após o preenchimento dos parâmetros, deve-se clicar em Testar conexão para validar a configuração. Caso a conexão esteja válida, deve-se clicar em Salvar antes de seguir para a etapa de configuração dos Objetos de Negócios.

PostgreSQL

Para o Provedor de Dados PostgreSQL, os parâmetros de configuração básicos são:
Image Added


Após o preenchimento dos parâmetros, deve-se clicar em Testar conexão para validar a configuração. Caso a conexão esteja válida, deve-se clicar em Salvar antes de seguir para a etapa de configuração dos Objetos de Negócios.

MySQL

Para o Provedor de Dados MySQL, os parâmetros de configuração básicos são:
Image Added


Após o preenchimento dos parâmetros, deve-se clicar em Testar conexão para validar a configuração. Caso a conexão esteja válida, deve-se clicar em Salvar antes de seguir para a etapa de configuração dos Objetos de Negócios.

Oracle

Para o Provedor de Dados Oracle, os parâmetros de configuração básicos são:
Image Added


Após preencher os parâmetros, clique em "Testar conexão" para validar a configuração. Se a conexão for validada com sucesso, clique em "Salvar" antes de prosseguir para a etapa de configuração dos Objetos de Negócio

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

.

Informações
iconfalse
Informações
iconfalse

Produto: Framework

Informações
iconfalse

Processo: Menu TReports - Conectores: Conectores

Informações
iconfalse

Versão:

Provedor Nativo - 1.1 ou Superiores

Provedor SQL - 1.3 ou Superiores

Informações
iconfalse
Informações
iconfalse

Status: Concluído

Informações
iconfalse

Data:  

Informações
iconfalse

Autores:

André Iago Vieira Gonçalves

Aline Cristina Braz de Oliveira

Carlos Philippe de Farias Marques

Cesar Henrique Silva Rodrigues_ 

Diogo Damiani Ferreira

Usuário desconhecido (fernando.souza)