Histórico da Página

O portal do professor está disponível a partir da versão 12.1.31.

O portal do professor faz uso de api's para buscar e armazenar informações, o controle destas APIs é feito pelo host. Para que o portal funcione 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.

É necessário instalar o URL Rewrite e o ARR (Application Request Routing) no IIS.

Deck of Cards

id	1
effectType	fade

Card

effectDuration	0.1
label	1 - Instalar Application Request Routing (ARR)
effectType	fade

Fazer o download do ARR no link https://www.microsoft.com/en-us/download/details.aspx?id=47333.

Fazer a instalação no mesmo servidor do Portal do Professor e ao final da instalação deve ser habilitado o proxy do ARR.

Image Added

Card

effectDuration	0.1
label	2- Instalação e Configuração do URL Rewrite
effectType	fade

Deck of Cards

id	2

Card

label	Instalação do URL Rewrite
effectType	fade

1. Acessar o IIS (como administrador) | Clicar na opção: "Obter Novos Componentes Web Plataform"

Image Added

2. Em seguida, será habilitado uma tela, onde serão carregados as plataformas Web.

Image Added

3. Pesquisar por “URL Rewrite” e clicar na opção: Add:

Image Added

4. Após a Instalação, será criado um ícone: “URL Rewrite” no IIS

Image Added

Card

effectDuration	0.1
label	Configuração do URL Rewrite
effectType	fade

É necessário configurar duas regras para o rewrite, onde a primeira é utilizada para direcionamento de api's onde não é necessário passar o alias selecionado e a segunda é utilizada para as api's onde é necessário passar o alias selecionado. Segue a configuração das duas regras:

1º Regra:

1. Acessar o IIS -> Ir no aplicativo do Portal do professor-> URL Rewrite

Image Added

2. Dar um duplo click no ícone URL Rewrite e em seguida clicar em: Adicionar uma Rule do tipo Inboud Rule.

Image Added

Inserir as informações:

3. No campo "Name" informar um nome para a regra que está sendo criada

Image Added

4. Na opção: Match URL, no campo: "Pattern" inserir as informação: aliasname\.(.*)/api/(.*)

Image Added

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"

Image Added

2º Regra:

1. Acessar o IIS -> Ir no aplicativo do Portal do professor-> URL Rewrite

Image Added

2. Dar um duplo click no ícone URL Rewrite e em seguida clicar em: Adicionar uma Rule do tipo Inboud Rule.

Image Added

Inserir as informações:

3. No campo "Name" informar um nome para a regra que está sendo criada

Image Added

4. Na opção: Match URL, no campo: "Pattern" inserir as informação: api/(.*)

Image Added

5. Na opção: "Actions", no campo: Rewrite URL informar o link: http://nome_da_maquina_do_host:porta/api/{R:1}

Image Added

Aviso

title	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 devem ser respeitada.

Card

effectDuration	0.1
label	3- Configuração do Hosts
effectType	fade

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: Totvs\RM.Net\Bin da versão e inserir as chaves:

Aviso

title	Atenção

Para a opção "SubDomainMask", o nome da máquina deve ser inserido todo utilizando letras minúsculas. O texto [ALIAS] não deve ser alterado, deve ser inserido o texto desta forma, o que deve ser alterado é o "nomeDaMaquinaDoHost". Exemplo: a máquina do host possui o nome de ServerXYZ, desta forma, deve ser inserido o texto [ALIAS].serverxyz.

Card

label	4- Configuração do Portal

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, acessar o arquivo config.js que está disponível no caminho padrão do instalador do novo Portal do Professor. “C:\totvs\CorporeRM\FrameHTML\Web\App\Edu\PortalDoProfessor\config”.

No arquivo, as seguintes configurações são possíveis:

1- O item "apiServer" deve ser configurado de acordo com a abordagem escolhida no item pré-requisito, deve ser informado o endereço que está configurado as APIs.

2- O item "basePath" deve ser configurado com o mesmo caminho relativo utilizado no portal.

3- O item "defaultAlias" deve ser configurado com o alias padrão utilizado para fazer o acesso a base de dados, este alias deve existir no arquivo alias.dat.

4- O item "imgBannersLogin" são os banners que são exibidos na tela de login do portal, para alterar, adicionar/remover itens, basta adicionar um novo item ou remover um item da lista, a imagem deve ser adicionada no caminho "C:\totvs\CorporeRM\FrameHTML\Web\App\Edu\PortalDoProfessor\assets\img\banners-login", o nome adicionado na lista deve ser o mesmo nome da imagem adicionada neste caminho.

Image Added

O item "basePath" deve ser o mesmo caminho relativo utilizado no portal.

Image Added

O item "imgBannersLogin" está configurado com 3 imagens, o que fará com que na tela de login, sejam exibidas em forma de carrossel estas imagens.

Image Added

Card

label	5 - Configuração dos Hosts

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:

Acessar o arquivo de host do windows (geralmente se encontra em C:\Windows\System32\drivers\etc\hosts)

Para cada alias cadastrado no rm, deve existir um registro no arquivo de host. Deve ser inserido um registro no mesmo padrão que foi informado no arquivo de configuração do host (ver a configuração do Rewrite, na aba configuração do config), onde deve ser inserido no seguinte padrão: Nome_Do_Alias.Nome_Da_Maquina_Do_Host todo em minúsculo.

Exemplo: Como exemplo, existem dois alias cadastrados no rm, 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
- 127.0.0.1 corporermoracle.serverxyz
Image Added

Para a máquina SERVERZYX:
- 127.0.0.1 corporerm.serverzyx
- 127.0.0.1 corporermoracle.serverzyx

Image Added

Card

label	5- Configuração das Bases de Dados

O acesso a base de dados é feita através da utilização dos alias. O portal busca os alias que estão cadastrados no rm.exe, caso possua apenas um alias cadastrado, o combo para selecionar os alias não é exibido e o alias é automaticamente selecionado.

Image Added

Card

effectDuration	0.1
label	6- URL do Novo portal do Professor
effectType	fade

Após as configurações, acessar o novo portal através do link: http://Local_de_Instalação/FrameHTML/web/app/Edu/PortalDoProfessor/

Image Added

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 2

Nova versão 3

Chave

Inserir as informações:

Inserir as informações: