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. |
...
| 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
| ||
| Expandir | title | 1- Pré-requisitos
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. warning | ||
|
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.
...
...
A partir da versão 12.1.2402
É possível utilizar as api's do host diretamente, sem o uso do módulo do URL Rewrite. Para isso deve expor o host para a web e informar o endereço do host nos arquivos de config dos portais.
Importante ficar atento a questões de segurança ao expor o host para a web. A forma como será utilizado fica a critério da instituição.
...
| effectDuration | 0.1 |
|---|---|
| id | temp |
| effectType | fade |
...
| label | Instalação |
|---|---|
| effectType | fade |
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
...
| label | Configuração Rewrite |
|---|---|
| effectType | fade |
Deve ser necessário configurar duas regras para o URL Rewrite:
- A 1º regra (regra comum para todas as versões) é utilizada para direcionamento de API onde não é necessário passar o alias selecionado;
- A 2º regra (apenas para versões anteriores à 12.1.2402) é utilizada para as API onde é necessário passar o alias selecionado.
| Aviso | ||
|---|---|---|
| ||
A configuração deve ser realizada exclusivamente nos portais: Portal Gestão Educacional / Portal da Biblioteca / Novo Portal do Professor em: Sites | Default Web Site | FrameHTML | Web | App |Edu | 'Pasta referente ao portal'. Caso a configuração não seja realizada no caminho especificado anteriormente, o portal do Aluno poderá ser impactado. |
| Aviso | ||
|---|---|---|
| ||
A ordem das regras deve ser respeitada. |
...
| title | Regra comum para todas as versões |
|---|
1. Acessar o IIS -> Ir no aplicativo que está sendo configurado (Portal Gestão Educacional / Portal da Biblioteca / Novo Portal do Professor) -> URL Rewrite
2. Dar um duplo click no ícone URL Rewrite e em seguida clicar em: Adicionar uma Rule do tipo Inboud Rule.
3. No campo "Name" informar um nome para a regra que está sendo criada
4. Na opção: Match URL, no campo: "Pattern" inserir as informação: api/(.*)
5. Na opção: "Actions", no campo: Rewrite URL informar o link: http://nome_da_maquina_do_host:porta/api/{R:1}
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
...
| title | Regra adicional necessário para versões anteriores a 12.1.2402 |
|---|
Para as versões anteriores à 12.1.2402 é necessário configurar uma nova regra.
| Aviso | ||
|---|---|---|
| ||
A porta utilizada deve ser a mesma que está configurada na chave "ApiPort" no arquivo de host RM.Host.Service.exe.config. |
1. Acessar o IIS -> Ir no aplicativo que está sendo configurado (Portal Gestão Educacional / Portal da Biblioteca / Novo Portal do Professor) -> URL Rewrite
2. Dar um duplo click no ícone URL Rewrite e em seguida clicar em: Adicionar uma Rule do tipo Inboud Rule.
3. No campo "Name" informar um nome para a regra que está sendo criada
4. Na opção: Match URL, no campo: "Pattern" inserir as informação: aliasname\.(.*)/api/(.*)
5. Na opção: "Actions", no campo: Rewrite URL informar o link: http://{R:1}.nome_da_maquina_do_host:porta/api/{R:2}
6. Marcar a opção: "Stop processing of subsequent rules"
...
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). Informações | | Reiniciar o IIS |
Após realizar as configurações é necessário reiniciar o IIS |
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
...
| 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 |
...
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.
...
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.
...
| 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\
...
Para os 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