Histórico da Página
Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Índice:
Í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
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 | ||
---|---|---|
| ||
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" ] }] |
title | Exemplo "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 | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
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 indicado: https://tdn.totvs.com/x/WRKwJQ. Caso precise mais informações, favor consultar o suporte TOTVS. |
Informações | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|
Informações | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|