Á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


       Após a instalação do TReports Agent, deve-se efetuar os passos de configuração inicial do TReports (por padrão através do endereço

Estado
subtletrue
colourBlue
titlehttp://localhost:7019
) sendo eles:

  • Informação de dados do Provedor de Segurança, para integração com ERP TOTVS e gerenciador de identidade;
  • Dados de integração como License Server;
  • Dados do SGDB à ser usado , ou opção por utilizar um banco embarcado como para armazenar os metadados do TReports como Armazenamento de Dados (Provedor de Dados até a V2.2.2)     


Informações
titleProdutos Integrados ao TReports

Informações mais detalhadas sobre a integração com os ERP's TOTVS podem ser consultadas conforme a página do produto.

Provedor de Segurança


      Nesta etapa é configurado o Provedor de Segurança de autenticação dos usuários para acesso ao TReports. Deve primeiramente ser dado um nome ao provedor e em seguida devem ser informados, conforme detalhado na documentação do Provedor de Segurança do ERP TOTVS utilizado. Atualmente, o Agent possui duas formas de configuração, sendo:

  • Descoberta Automática - apenas uma URL precisa ser informada;
  • Descoberta Manual - necessário o preenchimento das URLs de criação de token, JWKS e base de API.

Verifique na documentação do seu ERP qual o modelo de descoberta de Provedor de Segurança é suportada.


Deck of Cards
idProvedor de Segurança
Card
defaulttrue
labelDescoberta Automática
titleDescoberta Automática

Caso o ERP suporte a Descoberta Automática, os campos devem ser preenchidos conforme demonstrado abaixo:

CampoValor
Nome do provedorNome do provedor de segurança a ser exibido no TReports. (Ex.: CorporeRM ou Protheus)
Endereço de descobertaURL de
criação do token;Endereço Jwks;
descoberta automática do ERP 

Em Recuperar emissor deve ser preenchido um usuário e senha cadastrado no ERP que servirá como administrador do TReports.

Card
labelDescoberta Manual
titleDescoberta Manual

Caso o Agent esteja numa versão sem suporte à Descoberta Automática, a configuração deve ser feita conforme demonstrado abaixo:

CampoValor
Nome do provedorNome do provedor de segurança a ser exibido no TReports. (Ex.: CorporeRM ou Protheus)
Endereço de criação do tokenURL de criação de token do ERP

Endereço Jwks

URL de JWKS do ERP
Endereço base da Api
;

       Para o Provedor de Segurança com descoberta automática, conforme detalhado na RFC010002, deverá ser informado o Endereço de descoberta;

       Após as informações terem sido preenchidas, o emissor deverá ser recuperado informando os dados de login do usuário administrador.

Image Removed
URL base de API do ERP

Em Recuperar emissor deve ser preenchido um usuário e senha cadastrado no ERP que servirá como administrador do TReports.

       Após feito o login do usuário administrador, os campos Nome do usuário administradorNome do emissor serão automaticamente preenchidos, concluindo a configuração do Provedor de Segurança. Deve-se então avançar para a próxima etapa.

Servidor de Licença


       Nesta etapa é configurado o Servidor de Licença do TReports. Devem ser informados os campos abaixo:
  • IP do Servidor: Informe o IP do servidor utilizado como License Server.
  • Porta: Informe a porta cadastrada no seu License Server.
  • CNPJ:  Informe o CNPJ da sua empresa.
Informações

O campo CNPJ pode ser preenchido formatado (XX.XXX.XXX/XXXX-X) ou direto (XXXXXXXXXXXXX).

Seu preenchimento não é obrigatório para verificar o License Server, porém será necessário para realizar o consumo de licença em alguns tipos de contratos.

       Depois que a configuração estiver concluída, verifique a disponibilidade do seu servidor clicando no botão.



Informações
titleInformações

Para mais detalhes de como funciona o License Server, acesse a página License Server.

Armazenamento de Dados


Nota
titleProvedor de Dados

Até a versão 2.2.2 do Treports Agent, essa etapa era denominada de Provedor de Dados. Ela foi alterada para melhorar o entendimento.

       Na etapa de configuração do Provedor Armazenamento de Dados será definido qual banco de dados será utilizado para armazenar os metadados do TReports, sendo possível escolher entre os tipos SQLite, PostgreSQL e SQL Server.

       Quando selecionado o provedor SQLite, não é necessário realizar nenhum tipo de configuração ou instalação adicional, por se tratar de um banco embarcado ao TReports. Para realizar um backup, é necessário copiar os arquivos da pasta "db" na raiz da pasta onde o TReports foi instalado "{pasta-de-instalação}\db\".

Nota
titleProvedor de Dados SQLite

A opção de provedor de dados como SQLite deve ser utilizada para fins de testes e experimentação, pois possui capacidade e performance limitada

       Para os provedores do tipo PostgreSQLSQL Server, deve ser configurada a conexão a um servidor de banco de dados. Assim que todas as informações forem preenchidas é possível validar a conexão caso seja um banco de dados já existente. Caso o banco de dados informado não exista no servidor, será criado um banco de dados para o TReports com o nome informado no campo "Initial Catalog, preenchendo as seguintes informações:

  • Data Source - endereço do SGBD;
  • Initial Catalog - nome da base a ser utilizada;
  • User ID - Id do usuário;
  • Password - senha do usuário.

É possível, caso necessário, incluir mais parâmetros na string de conexão através do botão "Adicionar parâmetro".

Nota

O usuário de conexão ao servidor deve possuir permissão para criação de bases e tabelas.

       As etapas abaixo ilustram uma conexão feita com um provedor de dados do tipo SQL Server.

                 Preencha os dados de conexão com o servidor de banco de dados e clique em testar conexão.Image Removed         Image Removed     

Assim que todas as informações forem preenchidas, deve-se validar a conexão através do botão "Testar conexão". Nessa validação é exibido um relatório que exibe se:

  • Foi possível conectar ao SGBD com o usuário/senha informado;
  • A base de dados informada existe. Caso não exista, é verificado se o usuário possui permissão para criar;
  • O usuário pode criar e editar tabelas da base informada;

Exemplo:

Image Added

Caso alguma das verificações falhe, o item verificado é exibido em vermelho e não será possível concluir a configuração.

Em alguns casos os itens são exibidos em amarelo, como forma de alerta, indicando que o Agent não pode verificar a permissão. Nesse cenário será possível concluir a configuração.

Exemplo:

Image Added


                  Assim que a conexão for validada, clique em "Concluir". 

Fim da configuração

       Após configurar o Provedor de Dados, será apresentado a tela final de configuração, clique em "Abrir o TReports":

Imagem do fim da configuração do TReports

Informações
iconfalse
titlePróxima Etapa

Para iniciar o uso da ferramenta configure um conector. Link para mais informações Configurando Conectores.

Informações
iconfalse
Informações
iconfalse

Produto: Framework

Informações
iconfalse

Processo: Configuração TReports Agent

Informações
iconfalse
Informações
iconfalse

Status: Finalizado

Informações
iconfalse

Data:  

Informações
iconfalse

Autores:

Adriano Diniz Agrizzi

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)

Isabelle Oliveira Silva

Wemerson Marcelo Martins Guimarães