Versões comparadas

Chave

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

Índice:


       

Índice
exclude.*ndice:

Requisitos de software para instalação do T-Reports

1) Sistema Operacional:

Informações

Windows 7 ou 10

ou

Server 2012 (ou superior)

2) Banco de Dados:

Informações

SQL Server 2014 (ou superior)

ou

Oracle 11 (ou superior).

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

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

Informações

Disponível em "https://www.microsoft.com/pt-br/download/details.aspx?id=56116"

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

Informações

Versão 64 bits "https://download.microsoft.com/download/3/7/1/37189942-C91D-46E9-907B-CF2B2DE584C7/dotnet-sdk-2.1.200-win-x64.exe"

Versão 32 bits "https://download.microsoft.com/download/3/7/1/37189942-C91D-46E9-907B-CF2B2DE584C7/dotnet-sdk-2.1.200-win-x86.exe"

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

Informações

Disponível em "http://go.microsoft.com/fwlink/?LinkId=798480"

Configuração do RAC

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

Portanto, vamos rodar o processo de "Migrator" para criação do banco de dados do RAC. Para isso, basta seguir os passos abaixo:

    a) - Descompacte o arquivo "TnfRac.zip" dentro do diretório "c:\TReports\Rac";

    b) - Abra o arquivo "appsettings.json" do diretório "c:\TReports\Rac\Migrator" e efetue as seguintes modificações:

       b.1) - No atributo "ConnectionStrings" informe a string de conexão conforme exemplo abaixo:

             "ConnectionStrings": {

               "Default": "Server=BHD050100275; TrustServerCertificate=True; database=TnfRac; User Id=sa;password=xxxx"

              },

Dica

O usuário e senha do banco precisará de permissão para criação de banco de dados do RAC.

Como sugestão informe o usuário e senha do "sa".

Informações

Nesse passo, o banco de dados a ser criado, no caso o banco "TnfRac" não poderá existir no servidor "BHD050100275".

Caso exista, apague o banco atual e recrie com as novas configurações.

       c) - No atributo "Clients" crie configurações para informar a máquina (ou as máquinas) que hospedarão o Front-end do TReports: 

         c.1) - No Atributo "ClientId" deverá ser informado um identificador único que será usando nas configurações dos BackEnds e FrontEnds;

         c.2) - No atributo "AccessTokenLifetime" informe o tempo de expiração de um accessToque;

Dica

Deve ser o tempo (em segundos) até que o login precise ser renovado.

         c.3) - No atributo "RedirectUris" informe os endereços que serão usados pelo retorno do Rac:

Dica

Retorno de callback após o login e renovação do accessToken após expiração.

Exemplos:

"http://localhost:7017/auth-callback.html", - endereço usado para realizar o login

"http://localhost:7017/auth-callback", - endereço usado para realizar o login

"http://localhost:7017/assets/silent-renew.html", - endereço usado na renovação do login

"http://localhost:7017/assets/silent-renew" - endereço usado na renovação do login

         c.4) -  No atributo "PostLogountRedirectUris" informe os endereços usados pelo Rac após o logout;

         c.5) - Nos outros atributos mantenham os valores defaults;                

Expandir
titleExemplo "ClientId = js_oidc"

Nessa configuração, foram informados endereços da máquina localHost e porta 7017.

Isso significa que o rac aceitará somente solicitações provenientes do endereço "http://localhost:7017";

 "Clients": [

                                   {

                                     "ClientId": "js_oidc",

                                     "ClientName": "JavaScript OIDC Client For Testing",

                                     "AllowedGrantTypes": [ "hybrid", "client_credentials" ],

                                     "RequireConsent": false,

                                     "AllowAccessTokensViaBrowser": "true",

                                     "AllowOfflineAccess": true,

                                     "AccessTokenLifetime": 300, // 5min em segundos

                                     "IdentityTokenLifetime": 250,

                                     "RedirectUris": [

                                       "http://localhost:7017/auth-callback.html",

                                       "http://localhost:7017/auth-callback",

                                       "http://localhost:7017/assets/silent-renew.html",

                                       "http://localhost:7017/assets/silent-renew"

                                     ],

                                     "PostLogoutRedirectUris": [ "http://localhost:7017/" ],

                                     "AllowedCorsOrigins": [ "http://localhost:7017" ],

                                     "ClientSecrets": [ { "Value": "K7gNU3sdo+OL0wNhqoVWhr3g6s1xYv72ol/pe/Unols=" } ], // Calculado com IdentityServer4.Models.HashExtensions.Sha256()

                                     "AllowedScopes": [ "openid", "profile", "email", "authorization_api", "backend_api" ]

                                   }]

Expandir
titleExemplo "ClientId = js_oidc_2777"

 Nessa configuração, foram informados endereços da máquina BHN050102777 e porta 7017.

Isso significa que o RAC aceitará somente solicitações provenientes do endereço "http://BHN050102777:7017";

Nesse caso o FrontEnd do Reports deve ser instalado em configurado na máquina BHN050102777.

                                "Clients": [

                                   {

                                     "ClientId": "js_oidc_bhd050100275",

                                     "ClientName": "JavaScript OIDC Client For Testing",

                                     "AllowedGrantTypes": [ "hybrid", "client_credentials" ],

                                     "RequireConsent": false,

                                     "AllowAccessTokensViaBrowser": "true",

                                     "AllowOfflineAccess": true,

                                     "AccessTokenLifetime": 300, // 5min em segundos

                                     "IdentityTokenLifetime": 250,

                                     "RedirectUris": [

                                       "http://bhd050100275:7017/auth-callback.html",

                                       "http://bhd050100275:7017/auth-callback",

                                       "http://bhd050100275:7017/assets/silent-renew.html",

                                       "http://bhd050100275:7017/assets/silent-renew"

                                     ],

                                     "PostLogoutRedirectUris": [ "http://bhd050100275:7017/" ],

                                     "AllowedCorsOrigins": [ "http://bhd050100275:7017" ],

                                     "ClientSecrets": [ { "Value": "K7gNU3sdo+OL0wNhqoVWhr3g6s1xYv72ol/pe/Unols=" } ], // Calculado com IdentityServer4.Models.HashExtensions.Sha256()

                                     "AllowedScopes": [ "openid", "profile", "email", "authorization_api", "backend_api" ]

                                   }]

    

    d) - Entre no comand prompt do windows e acesse o diretório "c:/TReports/Rac/Migrator";

    e) - Execute o comando "dotnet Tnf.Rac.EntityFrameworkCore.Migrator.dll";

        Obs: Esse comando rodará a ferramenta de criaçaõ automática do banco de dados do Rac.

Dica

Caso a mensagem "Continue to migration for this host database? (Y/N):" apareça, digite "Y" para concluir.

Expandir
titleExemplo

Image Removed

   f) - Após rodar o comando, verifique se o banco de dados foi criado no servidor de banco de dados;

         

Agora, vamos configurar o Host do Rac, para isso basta seguir os passos abaixo:

     a) - Descompacte o arquivo "HostRac.zip" dentro do diretório "c:\TReports\Rac\Host";

Abra o arquivo "appsettings.json" do diretório "c:\TReports\Rac\Host" e efetue as seguintes modificações:

       - No atributo "ConnectionStrings" informe a string de conexão conforme exemplo abaixo:

          "ConnectionStrings": {

             "Default": "Server=BHD050100275; TrustServerCertificate=True; database=TnfRac; User Id=sa;password=xxxx"

          },

Dica

O usuário e senha do banco precisará de permissão para criação de banco de dados do RAC.

Como sugestão informe o usuário e senha do "sa".

Informações

Essa string de conexão deve ser a mesma usada no passo anterior "Criação do banco de dados do RAC"

      b) - Entre no diretório "TReports/Rac/Host" e abra o arquivo "hosting";

             - Informe no atributo "urls" a string: "http://*:5000" (essa configuração identificará a porta de hospedagem do RAC);

Configuração do T-ReportsBackEnd

       1) - Descompacte o arquivo BackEnd.zip dentro do diretório "c:\TReports\BackEnd";

       2) - Abra o arquivo "appsettings.json" e efetue as seguintes modificações:

       a) - No atributo "ConnectionStrings" informe a string de conexão contendo a localização do banco de dados do repositório do T-Reports:

             "ConnectionStrings": {

               "Default": "Server=BHD050100275; TrustServerCertificate=True; database=TReportsDB; User Id=sa;password=xxxx"

             },

Dica

O usuário e senha do banco precisará de permissão para criação de banco de dados de repositório do TReports

Como sugestão informe o usuário e senha do "sa".

          Atualmente somente o SqlServer poderá ser usando como repositório do T-Reports;

Informações

Se o banco de dados "TReportsDB" não existir, ao hospedar o backEnd esse banco será criado automaticamente;

      b) - No atributo "BackgroudJobSettings", no parêmetro "DelayTime", informe a quantidade em "minutos" para leitura da tabela de "agendamento de execução de jobs" (default será 1 minuto). Mantenham os valores defaults para os outros parâmetros; 

3) - Abra o arquivo "Hosting.json" e informe o endereço "urls": "http://*:4999" de hospedagem do backEnd;

4) - Abra o arquivo "racsettings.json" e no atributo "AuthorityEndpoint" informe o endereço de hospedagem do rac, conforme exemplo abaixo:

                {             

                  "AuthorityEndpoint": "http://localhost:5000/",

                  "ApiName": "backend_api",

                  "RequireHttpsMetadata": false,

                  "CacheAuthentications": false,

                  "CacheAuthenticationDuration": 10

                }

Configuração do T-ReportsFrontEnd

1) - Descompacte o arquivo FrontEnd.zip dentro do diretório "c:\TReports\FrontEnd";

2) - No diretório "c:\TReports\FrontEnd\config", abra o arquivo "appsettings.js" e efetue as seguintes modificações:

       a)       Informe no atributo "apiHost' o endereço base de hospedagem Backend na porta 4999;

Exemplo: 'http://localhost:4999/'

       b)       Informe o tenant da aplicação;

Exemplo: tenant: 'poa'

       c)       Informe no atributo "authority" o endereço de hospedagem do RAC definido na Configuração do Host do RAC acima.

Exemplo: 'http://localhost:5000/'

       d)       Informe o identificador do client criado no passo "c.1" da Configuração do RAC.

Exemplo: client_id: 'js_oidc';  

Dica

Tudo certo!

Agora só falta configurar os tipos de hospedagem. Para isso, basta acessar a página: Tipos de hospedagem.

http://go.microsoft.com/fwlink/?LinkId=798480 

Informação


Aviso
titleNova Versão do TReports

Essa versão do TReports será em breve descontinuada.

Para poder usufruir das suas funcionalidades, acesse a documentação da nova versão e realize a instalação conforme indicadohttps://tdn.totvs.com/x/WRKwJQ.

Caso precise mais informações, favor consultar o suporte TOTVS.



Informações
iconfalse
Informações
iconfalse

Produto: Framework

Informações
iconfalse

Versão: 12.011.XX22 ou superior

Informações
iconfalse

Processo: Configuração Ambiente Instalação TReports

Informações
iconfalse
Informações
iconfalse

Status: Finalizado

Informações
iconfalse

Data: /05 

Informações
iconfalse

Autores:

Erlon Cesar Lima De Freitas

Aline Cristina Braz de Oliveira

Carlos Philippe de Farias Marques

Diogo Damiani FerreiraFlavio Henrique Pereira Campelo

Gustavo Naves De Castro

Philippe Fernandes Lima Gonçalves

SARAH ROLAND CAMPOS LISBOATIAGO ANDRADE GOMES SILVEIRA

Wesley Avelino De Carvalho