Í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


subtle	true
colour	Blue
title	http://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 para armazenar os metadados do TReports como Armazenamento de Dados (Provedor de Dados até a V2.2.2)

Informações

title	Produtos 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

id	Provedor de Segurança

Card

default	true
label	Descoberta Automática
title	Descoberta Automática

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

Campo	Valor
Nome do provedor	Nome do provedor de segurança a ser exibido no TReports. (Ex.: CorporeRM ou Protheus)
Endereço de descoberta	URL de 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.

Caso o ERP não suporte a Descoberta Automática, deve-se clicar no link destacado abaixo:

Card

label	Descoberta Manual
title	Descoberta Manual

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

Campo	Valor
Nome do provedor	Nome do provedor de segurança a ser exibido no TReports. (Ex.: CorporeRM ou Protheus)
Endereço de criação do token	URL de criação de token do ERP
Endereço Jwks	URL de JWKS do ERP
Endereço base da Api	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 administrador e Nome 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

title	Informações

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

Armazenamento de Dados

Nota

title	Provedor 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 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

title	Provedor 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 PostgreSQL e SQL Server, deve ser configurada a conexão a um servidor de banco de dados, 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.

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:

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:

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

Fim da configuração

Após configurar o Armazenamento de Dados, será apresentado a tela final de configuração, clique em "Abrir o TReports" para iniciar o uso do TReports ou em "Ir ao Diagnóstico" para verificar as configurações de instalação do TReports:

Imagem do fim da configuração do TReports