Histórico da Página
| Expandir | ||
|---|---|---|
| ||
|
| Aviso | ||
|---|---|---|
| ||
A partir da versão 12.1.28 a instalação dos novos portais foram modificadas para que os mesmos sejam utilizados na mesma porta dos portais Corpore.Net, sendo assim, as URL's que são disponibilizadas para seus clientes devem ser modificadas. Novo padrão de URL:
Os passos abaixo devem ser seguidos para uma utilização correta dos portais. |
| Nota | ||
|---|---|---|
| ||
Caso o sistema operacional do servidor web onde o novo portal do aluno ficará hospedado seja o Windows Server 2008 R2, é necessário que o Hotfix (relacionado ao roteamento das APIs) citado no link a seguir esteja instalado, além das atualizações do Windows. |
...
Para permitir esta integração entre os portais, é necessário realizar a configuração abaixo onde é informado o caminho de instalação de ambos os portais.
...
01. CONFIGURAR A URL DO PORTAL CORPORE.NET
Deve ser especificado o endereço do Corpore.NET em: Totvs Gestão Educacional | Ambiente | Parâmetros | Parâmetros Globais | Gerais | URL de acesso ao Portal RM
No campo: URL de acesso ao Portal RM informar o endereço: http://SERVIDOR/NOMEAPLICATIVO_CORPORE.NET/ (Exemplo: http://servidor/corpore.net/)
...
02. CONFIGURAR A URL DO PORTAL FrameHTML
Deve ser especificado o endereço da FrameHTML em: Totvs Gestão Educacional | Ambiente | Parâmetros | Parâmetros Globais | FrameHTML
...
A configuração acima é utilizada principalmente quando há apenas um único servidor de instalação para o Corpore.NET ou um outro para o novo portal do aluno.
| Aviso | ||||
|---|---|---|---|---|
| ||||
Quando existem mais de um servidor WEB e se utilizam de um Load Balancing, existe a necessidade de que cada servidor web com a instalação do Corpore.NET responda diretamente para um servidor específico que esteja instalado o novo Portal do Aluno para a comunicação adequada no processo de login. Normalmente, a instalação de ambos os portais é feita no mesmo servidor, mas em várias máquinas diferentes. Desta forma, cada uma das instalações em cada servidor deve apontar para o Corpore.NET e FrameHTML referente ao seu servidor específico. Para atender esta demanda, foi criado uma nova chave em cada um dos Web.Config dos portais. Um no Web.Config da FrameHTML referente ao novo portal do aluno, e outra chave no web.config contido no ambiente do Corpore.NET. Web. |
...
Config do portal FrameHTMLEste arquivo estará na raiz da pasta de instalação da FrameHTML. |
...
A chave abaixo |
...
estará comentada no arquivo, para isso deve retirar o comentário HTML da chave e especificar o endereço do portal Corpore.NET. <add key="UrlCorpore" value="http://servidor/Corpore.Net" /> Web. |
...
Config do portal Corpore.NETO arquivo está localizado na raiz pasta ..\Corpore.Net\Source\Edu-Educacional\Public\Web.config, e deverá |
...
conter o endereço do portal FrameHTML. <add key="UrlFrameHTML" value="http://servidor/FrameHTML" /> ATENÇÃO: Ao utilizar esta configuração através dos arquivos de Web.Config dos portais, não serão mais utilizados as configurações definidas nos parâmetros do sistema, e sim de forma exclusiva o caminho parametrizado nos arquivos Web.Config. |
| Aviso | ||
|---|---|---|
Config Global para o Portal Corpore.NetPara o cenário que utiliza a configuração config global, é necessário realizar as alterações no arquivo do config global, pois quando está usando este recurso, ele sobrescreve todas as informaçõesdo web.config do portal Corpore.NET. Saiba mais sobre Config Global Adicionar a seguinte tag <add key="NomePastaInstalacaoPortalEducacional" value="web" /> O endereço da FrameHTML em Totvs Gestão Educacional | Ambiente | Parâmetros | Parâmetros Globais | FrameHTML no campo "Defina o endereço da FrameHTML" não acrescentar a informação "/web" no final do endereço
|
03. INSTALAÇÃO DO REWRITE E DO ARR (APPLICATION REQUEST ROUTING)
Como requisito para o funcionamento do portal é necessário instalar o URL Rewrite e ARR (Application Request Routing) no IIS.
ARR (Application Request Routing)
A instalação deve ser realizada no servidor do portal desejado.
Link para download do ARR: https://www.microsoft.com/en-us/download/details.aspx?id=47333
| Aviso | ||
|---|---|---|
| ||
A instalação deve ser realizada apenas uma vez para cada IIS. |
Após finalizar a instalação ARR (Application Request Routing), deverá ser habilitado a propriedade "Enable proxy"
A instalação deve ser realizada no servidor do portal desejado.
Link para download do URL Rewrite: https://www.iis.net/downloads/microsoft/url-rewrite
Após a Instalação, será criado um ícone: “URL Rewrite” no IIS
Após configurar o servidor, é necessário configurar o arquivo de configuração do Host do RM. Para isso, acesse o arquivo RM.Host.Service.exe.config que está disponível no caminho padrão do instalador do RM.exe.
Inserir as chaves as chaves abaixo:
<add key="ApiPort" value="porta_definida_no_rewrite (IIS)" />
<add key="DefaultDB" value="informe_aqui_o_nome_do_alias" />
O usuário associado ao serviço tem que ter permissão para acessar a porta da API definida no URL Rewrite.
| Nota |
|---|
Caso ocorra algum problema ao acessar a página da tela de pagamentos, conferir se o servidor com a porta da API foi configurada nos parâmetros do Rewrite do PORTAL DO ALUNO: Documentação de referência: https://tdn.totvs.com/x/1-zAI |
Configuração do tempo de timeout do portal
O portal permite que a instituição realize a configuração do Time out da forma que desejar.
| Dica |
|---|
Algumas funcionalidades tenha um comportamento adequado sugerimos que o tempo seja de 240 segundo (4 minutos). |
1. Acessar o IIS -> Ir na pasta "Default Web Site"
2. Selecione a opção "Configurações Avançadas"
3. Preencha com tempo desejado em "Tempo Limite de Conexão (segundos)"
4. Acessar o IIS -> Ir no pasta do servidor -> Application Request Routing Cache
5. Clicar em: Server Proxy Settings
6. Preencha com tempo desejado em "Time-out (seconds)"
7. Em seguida, clicar no botão: Aplicar
| Informações | ||
|---|---|---|
| ||
Após realizar as configurações, é necessário reiniciar o IIS |
04. ACESSO AO PORTAL EDUCACIONAL (PORTAL DO ALUNO)
Após estas configurações, acessar o novo portal através do link: http://LOCAL_DE_INSTALAÇÃO/FrameHTML/web/app/edu/portaleducacional/login
Caso a instituição deseje utilizar os novos portais como nas versões antigas, utilizando a porta 8080, acesse o link para realizar os ajustes: https://tdn.totvs.com/x/eLmnI
| Aviso | ||
|---|---|---|
| ||
O novo Portal do Aluno depende do recurso de manipulação URL’s sem extensão definida esteja disponível no IIS (utilizado para funcionamento dos serviços REST). Contudo, identificamos que algumas versões do IIS não vem com suporte a tal recurso instalado por padrão, impossibilitando o funcionamento da aplicação. Caso tenha algum problema de funcionamento após sua instalação, a Microsoft lançou um hotfix para atualização do IIS para habilitar tal recurso. Link para download: https://support.microsoft.com/en-us/help/980368/a-update-is-available-that-enables-certain-iis-7.0-or-iis-7.5-handlers | ||
| Dica |
♣ Configuração de acesso do usuário Banco de dados para acessar o novo portal do aluno
05. CONFIGURAR O ACESSO DO USUÁRIO BANCO DE DADOS PARA ACESSAR O NOVO PORTAL DO ALUNO
Após a instalação do novo portal, certificar se o usuário/senha TOTVSPortal de acesso ao banco de dados está de acordo com o mesmo usuário/senha do banco de dados configurado no servidor. A verificação é realizada em:
...
Selecionar o usuário: TOTVSEdu e verificar se o usuário/senha está de acordo com o usuário/senha de acesso ao banco de dados.
♣ Configuração do Alias default para acessar o portal
Por padrão, o Alias deafult CorporeRM vem definido no web.config. Para alterar, acessar o passo abaixo.
1º- Após a instalação do portal, acessar o caminho: Local_de_Instalação | FrameHTML | Web.Config localizar a tag: <add..key="ServiceAlias" value="CorporeRM" /> e alterar par ao nome desejado.
06. LISTAR O ALIAS NO NOVO PORTAL
Ao acessar a tela de login do novo portal, serão listados todos os alias cadastrados no Gerenciamento de Alias (salvos no arquivo "Alias.dat") e listados para o usuário em ordem alfabética.
Exemplo: No ambiente possui dois alias cadastrados, sendo:
- CorporeRM_Alias01
- CorporeRM_BaseTeste
Ao acessar o Login do novo portal do aluno, o primeiro alias da lista será automaticamente selecionado:
- CorporeRM_Alias01
| Aviso | ||
|---|---|---|
| ||
A tela de Login do novo Portal do Aluno não utiliza o parâmetro ServiceAlias definida no arquivo Web.Config da pasta FrameHTML. |
07. OCULTAR DROPDOWN DE SELEÇÃO DE ALIAS
1) Acessar a pasta: ...\FrameHTML\web\app\Edu\PortalEducacional\js\
2) Localizar o arquivo edu-constantes.global.config.js
3) Editar o arquivo e localizar a variável EDU_CONST_GLOBAL_EXIBIR_ALIAS=true e alterar para: EDU_CONST_GLOBAL_EXIBIR_ALIAS=false
Desta forma o portal apresentará a tela de login sem a opção de seleção de alias.
| Aviso | ||
|---|---|---|
| ||
Quando o novo portal do aluno está parametrizado para não exibir a seleção de alias, o portal do aluno irá utilizar o primeiro alias da lista cadastrada no Gerenciamento de Alias, sendo o primeiro item após realizado uma ordenação por ordem alfabética. |
Para os 2º-Principalmente para clientes que utilizam a Biblioteca em 3 camadas, atente-se para a configuração da tag <add key="Host" value="localhost" />, certificando que a mesma aponta para os servidores corretos.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas