Histórico da Página
...
title | 1.0 - Pré-requisitos |
---|
...
Os portais Portal Gestão Educacional / Portal da Biblioteca / Novo Portal do Professor,
...
fazem o uso de
...
API para buscar e armazenar informações, o controle destas APIs é feito pelo host. Para que os portais funcionem corretamente, é necessário expor as APIs para web, desta maneira, é necessário o uso do módulo URL Rewrite do IIS para que este módulo filtre as solicitações e encaminhe para o host as solicitações que sejam para a API.
Expandir | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Como requisito para o funcionamento dos portais é É necessário instalar o URL Rewrite e o ARR (Application Request Routing) no IIS.
|
Expandir | ||||
---|---|---|---|---|
| ||||
Após configurar o servidor conforme o item: 1- Pré-requisitos, é 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:
| Atenção | |||
A porta utilizada deve ser a mesma que está configurada na chave "ApiPort" no arquivo de host (RM.Host.Service.exe.config, se utilizar o Host Service e RM.Host.exe.config, se utilizar o Host local). Ver a aba Configurações do config. A ordem das regras deve ser respeitada. | ||||
Card | ||||
|
Aviso | ||||
---|---|---|---|---|
| Para versões
| |||
Inserir é necessário adicionara chave abaixo: <add key="SubDomainMask" value="[ALIAS].nome_da_máquina_do_host" /> Aviso | | |||
|
Aviso | ||||
---|---|---|---|---|
| ||||
Em servidor publicado, na TAG: "SubDomainMask" utilizar o DNS. | ||||
Aviso | ||||
|
Expandir | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Painel | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Após configurar o servidor conforme o item: 1- Pré-requisitos, é necessário configurar o arquivo de configuração no portal. Para isso, acesse o arquivo config.json que está disponível no caminho padrão do instalador do Portal. “C:\totvs\CorporeRM\FrameHTML\Web\App\Edu\"Pasta referente ao portal" \config\”.
No arquivo, as seguintes configurações são possíveis:
|
Painel | ||
---|---|---|
| ||
Acessar o RM.Host.Service.exe.config (se o cliente utilizar o Host Service) ou RM.Host.exe.config (se o cliente utilizar o Host local) na pasta "Bin" da versão e inserir as chaves: <add key="ApiPort" value="Porta definida no Host" /> |
Aviso | ||
---|---|---|
| ||
Para que a comunicação entre o Portal Gestão Educacional e o App: Meu eduCONNECT possa ocorrer normalmente, é necessário que a porta da API configuração do Rewrite do Portal Gestão Educacional e do TOTVS Educa Mobile estejam na mesma porta. |
title | 2.0 - Configuração Portal |
---|
Portal Gestão Educacional / Portal da Biblioteca / Novo Portal do Professor
01. CONFIGURAÇÃO
Após configurar o servidor conforme o item de pré-requisito, é necessário configurar o arquivo de configuração no Portal do Professor. Para isso, acesse o arquivo config.json que está disponível no caminho padrão do instalador do Portal do Professor. “C:\totvs\CorporeRM\FrameHTML\Web\App\Edu\"Selecione a pasta referente ao portal" \config\”.
No arquivo, as seguintes configurações são possíveis:
|
Parâmetro apiServer
Deve ser configurado com o mesmo endereço utilizado para acessar o portal. Essa configuração é utilizada para realizar o redirecionamento para a API que será feito pelo módulo URL Rewrite do IIS.
O endereço parametrizado, deve conter o endereço público do portal. Exemplo: http://instituicao.br/FrameHTML/web/app/edu/portalXXXX.
IMPORTANTE!!!
A partir da versão 12.1.2402
Este parâmetro poderá ficar vazio, pois o portal irá preenche-lo com o mesmo endereço configurado para acessar o portal automaticamente; além disso, será possível configurar este parâmetro com um endereço diferente do utilizado para acessar o portal. Para isto, o host deve estar configurado para acesso externo, ou seja, o host deve estar exposto para internet.
Desta maneira o valor a ser preenchido neste parâmetro, deve ser o endereço no qual o host está sendo exposto.
Exemplo:
Vamos supor que o portal está sendo acessado pelo seguinte endereço https://portalTotvs.com.brInformações | ||
---|---|---|
| ||
Essa configuração é utilizada para realizar o redirecionamento para a API que será feito pelo URL Rewrite do IIS. Deve ser configurado com o endereço público do portal conforme o exemplo a seguir:.
*EndereçoDaInstituição* refere-se ao DNS da Instituição de ensino.
|
|
|
|
|
Informações | ||
---|---|---|
| ||
Deve ser configurado |
Obs: A imagem abaixo foi retirando como exemplo, o Novo portal do professor, porém, o caminho para acesso é o mesmo para os demais portais: Portal Gestão Educacional / Portal da Biblioteca / Novo Portal do Professor.
com o caminho relativo do portal.
|
Parâmetro defaultAlias
Informações | ||
---|---|---|
| ||
Esta configuração não define qual o alias que será utilizado para acessar o portal, apenas seleciona automaticamente o alias na caixa de seleção na tela de login quando possui mais de um alias cadastrado. |
Deve ser configurado com o alias padrão utilizado para fazer o acesso |
à base de dados. Este alias, deve estar cadastrado |
no arquivo alias.dat. |
Informações | ||
---|---|---|
| ||
Deve |
ser configurado o endereço público do portal Corpore.NET, para que as funcionalidades ainda não migradas |
do portal do professor, sejam redirecionadas para o Corpore.NET. |
Quando o ambiente possuir mais de um servidor WEB contendo uma instalação do Portal do Professor |
e Corpore.NET, seja possível cada servidor redirecionar para o Corpore.NET |
do seu próprio servidor. Ou, em casos que o endereço do Corpore.NET parametrizado no RM esteja sendo utilizado para outras finalidades, apontando para um ambiente específico.
|
Esta parametrização também pode ser feita no RM 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://instituicao.br/corpore.net/)
|
|
Isso se deve para quando o ambiente possuir mais de um servidor WEB contendo uma instalação do Portal do Professor e Corpore.NET, seja possível cada servidor redirecionar para o Corpore.NET do seu próprio servidor. Ou, em casos que o endereço do Corpore.NET parametrizado no RM esteja sendo utilizado para outras finalidades, apontando para um ambiente específico.
Parâmetro imgBannersLogin
São
|
Informações | ||
---|---|---|
| ||
Deve ser configurado os banners que são exibidos na tela de login do portal. Para alterar as imagens, basta adicionar ou remover imagens |
desejadas no diretório do portal e no arquivo config.json.
|
|
|
Informações | ||
---|---|---|
| ||
Deve ser configurado o portal para o Multi-Tenancy. Para mais informação Configurando o RM Multi Tenancy (Multi Alias)
|
Por padrão este parâmetro vem configurado com 3 imagens, o que fará com que na tela de login sejam exibidas em forma de carrossel estas imagens.
Atenção!
|
|
02. CONFIGURAÇÃO PARA MULTI -TENANCY
Otimizado o sistema para que seja possível configurar o Novo portal do professor para o Multi-Tenancy.
Para realizar a configuração, realizar os passos:
- Acessar o IIS | Sites | Default Web Site | Associações
O IIS, irá abrir uma janela para que seja informado o(s) alias e o(s) domínio(s).
Informe o alias.seu_site conforme a imagem abaixo.
Após realizar a configuração, reiniciar o IIS
Para mais informação sobre o Multitenant, clique aqui.
Expandir | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
Essa configuração é utilizada para a requisição da API que chega no IIS, ela é filtrada pelo URL Rewrite e é redirecionada para o host, mas como a requisição vem do IIS, o mesmo não consegue encontrar o endereço do host, desta forma, a configuração que é feita no arquivo de host do Windows, irá informar para o IIS qual a máquina do host.
| |||||||||
Expandir | |||||||||
| |||||||||
Esta configuração é necessária ser realizada em todas as máquinas que o IIS (internet information service) estiver configurado. Isto é necessário porque quando a requisição da api chega no iis, ela é filtrada pelo módulo do Rewrite e é redirecionada para o host, mas como a requisição vem do IIS, o mesmo não consegue encontrar o endereço do host, desta forma, a configuração que é feita no arquivo de host do Windows, irá informar para o IIS qual a máquina do host. A seguir segue o passo a passo da configuração:
Exemplos: Como exemplo, existem
Exemplo 1: Como exemplo, existem dois alias cadastrados no RM.exe, um com o nome de CorporeRM e outro com o nome de CorporeRMOracle, e existe duas máquinas rodando o IIS e nestas maquinas rodam o host, uma com o nome de ServerXYZ e outra com o nome de SERVERZYX, desta forma, no arquivo de host da máquina ServerXYZ, ficaria da seguinte maneira: - 127.0.0.1 corporerm.serverxyz Para a máquina SERVERZYX: Exemplo 2: Como exemplo, existe dois alias cadastrados no rm, um com o nome de CorporeRM e outro com o nome de CorporeRMOraclede CorporeRMOracle, e existe duas máquinas rodando o IIS e nestas maquinas rodamuma máquina rodando o host, uma comas máquinas rodando o IIS tem os nomes de ServerXYZ e outra com o nome de SERVERZYX, e a máquina de host tem o nome de ServerXYZ e outra com o nome de SERVERZYXhostxyz e o IP 10.0.0.52, desta forma, no arquivo de host da máquina ServerXYZ, ficaria da seguinte maneira: - 127 10.0.0.1 52 corporerm.serverxyz Para a máquina SERVERZYX:
- 10.0.0.52 corporerm.serverxyz Para a máquina SERVERZYX: |
Expandir | |||||||
---|---|---|---|---|---|---|---|
| |||||||
O portal permite que a instituição realize a configuração do Time out da forma que desejar.
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 | |||||||
Expandir | |||||||
| |||||||
Portal Gestão Educacional / Portal da Biblioteca / Novo Portal do ProfessorApós as configurações, acessar o novo portal através do link: http://Local_de_Instalação/FrameHTML/web/app/Edu/PortalDoXXXX/ Obs: A imagem abaixo foi retirando como exemplo, o novo portal do professor, porém, o caminho para acesso, é o mesmo para os demais portais: Portal Gestão Educacional / Portal da Biblioteca / Novo Portal do Professor. |