Índice:

Requisitos de software para instalação do TReports

1) Sistema Operacional:

2) Banco de Dados:

3) - IIS configurado na máquina (instalação padrão).

4) - Instale a versão do .Net Framework 4.7.1

5) - Instale a última versão do sdk do .Net core (a versão runtime 2.1 ou superior

6) - Instale a última versão do DotNetCore.2.1.2.RC2-WindowsHosting

Configuração do RAC

É necessário configurar o RAC para garantir a segurança do TReports. Ele será responsável por validar os acessos á página.

Crie os subdiretórios “TReports” , “TRac” em um diretório raiz. Exemplo:

\\raiz\TReports;

\\raiz\TRac;

1) O arquivo “appsettings.Migrator” localizado no diretório “ raiz\TRac\” será atualizado da seguinte forma:

                a) No atributo “DefaultConnectionString” será gravado o tipo de banco de dados (SQL ou Oracle)

                b) No atributo “ConnectionStrings/SqlServer” ou “ConnectionStrings/Oracle” será gravado a string de conexão de acordo com o tipo de banco de dados.       

                Altere o atributo Server para o nome da máquina e o usuário e senha do banco que tenha permissão para criar a base.

Exemplo:

 "DefaultConnectionString": "SqlServer",

  "ConnectionStrings": {

    "SqlServer": "Server=localhost; TrustServerCertificate=True; database=TnfRacDB; User Id=sa;password=xxxx",

    "Sqlite": "",

    "Oracle": ""

  }, 

                c) No atributo “ServerUrl” será gravado a url de hospedagem do TRac:

Exemplo: "http://localhost:80/totvs.rac/”

2) O arquivo “appsettings.Production” localizado no diretório “ ..\TRac” será atualizado da seguinte forma:

                a) Coloque as mesmas informações do banco informadas no passo anterior.

Exemplo:

 "DefaultConnectionString": "SqlServer",

  "ConnectionStrings": {

    "SqlServer": "Server=localhost; TrustServerCertificate=True; database=TnfRacDB; User Id=sa;password=xxxx",

    "Sqlite": "",

    "Oracle": ""

  }, 

3) Rodar o processo de migrator do Rac. Esse processo criará o banco de dados. Basta executar o arquivo “Tnf.Rac.EntityFrameworkCore.Migrator.exe” localizado no diretório \\TRac;

Configuração do TReports

1) O arquivo “hosting” localizado no diretório “ ..\TReports” será atualizado da seguinte forma:

Exemplo:

{ "urls": "http://*:80/treports" }

2) O arquivo “racSettings” localizado no diretório “ ..\TReports” será atualizado da seguinte forma:

                a) No atributo “AuthorityEndpoint” será gravado o endereço de autenticação do Rac

                Obs: mesmo endereço gravado no item “auth/ Authority“ do FrontEnd

                Ex: “http://treports.nomedohost/totvs.rac /;

                b) No atributo “AuthorizationEndpoint” deve repetir o mesmo valor;

                c) No atributo “ClientId” será gravado o valor "'js_oidc_treports".

                Obs: as outras informações não serão alteradas.

                Exemplo:

                {

                  "ApiName": "authorization_api",

                  "AuthorityEndpoint": "http://treports.localhost/totvs.rac",

                  "AuthorizationEndpoint": "http://treports.localhost/totvs.rac ",

                  "ClientId": "js_oidc_treports",

                  "ClientSecret": "treports",

                  "RequireHttpsMetadata": false,

                  "Scope": "authorization_api"

                }

3) O arquivo “appsettings” localizado no diretório “ ..\TReports” será atualizado da seguinte forma:

                a) No atributo “DefaultConnectionString” será gravado o tipo de banco de dados (SQL ou Oracle)

                b) No atributo “ConnectionStrings/SqlServer” ou “ConnectionStrings/Oracle” será gravado a string de conexão de acordo com o tipo de banco de dados.       

                Altere o atributo Server para o nome da máquina e o usuário e senha do banco que tenha permissão para criar a base.

                Exemplo:

                "DefaultConnectionString": "SqlServer",

                  "ConnectionStrings": {

                                               "SqlServer": "Server=localhost; TrustServerCertificate=True; database=TRFDb; User Id=sa;password=xxxx",

                                               "Oracle": "”

                  },

4) O arquivo “appSettings” localizado no diretório “raiz\TReports\wwwroot\assets” será atualizado da seguinte forma:

                a)basePath: “/treports/”

                b)apiHost: 'http://' + window.location.host + '/treports/',

                c)“auth: {

                                 Authority: “http://treports.nomedohost/totvs.rac/;                                ..

                }

                d)“auth: {

                                               clientId:  ‘js_oidc_treports’

                }

5) O arquivo “index.html” localizado no diretório “raiz\TReports\wwwroot” será atualizado da seguinte forma:

                a)<base href="/treports /">

Passo a passo da instalação

A seguir será apresentado a passo a passo para instalação do TReports:

Deck of Cards
id Fonte de Dados
Card id 1 label 1° Passo É necessário aceitar os termos de contrato antes de prosseguir com a instalação. Image Added Card id 2 label 2° Passo É necessário informar o diretório onde o TReports será instalado. Image Added Card id 3 label 3° Passo É necessário selecionar os componeres a serem instalados. Instalação completa do TReports e do RAC: O TReports e o RAC serão instalados na máquina e não será necessário realizar nenhuma configuração adicional. Instalar somente o TReports e utilizar um RAC existente: Como o TReports é dependente do RAC para funcionar, é necessário que já exista um RAC instalado na máquina ou em outra máquina, que deve ser informado nas próximas telas. Além disso, é necessário tem cadastrado no RAC, um tenant, produto e client com as URLs de redirecionamento apontando corretamente para o TReports. Instalar somente o RAC: Somente o RAC será instalado na máquina, com as configurações corretas para futura integração com o TReports. Dica Recomendamos a instalação completa no TReports e RAC Image Added Card id 4 label 4° Passo É necessário escolher o tipo de banco de dados que hospedará o TReports: Atualmente temos disponíveis somente SQL Server e Oracle. Servidor: Informe o nome da máquina ou IP. Nome ou Instância: Para SQLServer é necessário informar um nome para a base, que será criada com o nome escolhido. Já para Oracle é necessário informar uma instância já existente, pois o instalador criará somente as tabelas. Usuário: Usuário com permissão para criação de bases de dados. Senha: Informe a senha. Image Added Card id 5 label 5° Passo Para a geração de relatórios é necessário configurar um Servidor de Licenças válido. Dessa forma, informe o servidor e a porta de seu Servidor de Licenças. Essas informações podem ser alteradas futuramente na tela de "Configurações" do TReports. Image Added Card id 6 label 6° Passo É necessário escolher o tipo de banco de dados que hospedará o RAC: Atualmente temos disponíveis somente SQL Server e Oracle. Servidor: Informe o nome da máquina ou IP. Nome ou Instância: Para SQLServer é necessário informar um nome para a base, que será criada com o nome escolhido. Já para Oracle é necessário informar uma instância já existente, pois o instalador criará somente as tabelas. Usuário: Usuário com permissão para criação de bases de dados. Senha: Informe a senha. Image Added Card id 7 label 7° Passo Certifique-se que as informações estão corretas e prossiga com a instalação. Ao final, clique em concluir para que o TReports e o RAC sejam abertos no seu navegador para as futuras configurações. Image Added Card id 8 label 8° Passo Certifique-se que o banco de dados do RAC e do TReports foram criados corretamente em seu banco de dados. Certifique-se também que os aplicativos no IIS foram criados corretamente no Default Web Site. Para acessar os mesmos, basta clicar em "Procurar", a direita da tela. Image Added Image Added Dica A seguir, continue lendo nossa documentação sobre configuração do RAC.

Configuração do RAC:

A seguir será apresentado a passo a passo p