Páginas filhas
  • 1- Configuração básica do portal do gestão educacional

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Informações
iconfalse
Deck of Cards
effectDuration0.2
id1
effectTypefade
Card
label1º - Instalar e configurar o Application Request Routing (ARR)

1° - Instalar e configurar o "Application Request Routing" (ARR)

Aviso

Caso tenha instalado e configurado o Application Request Routing (ARR) para o Novo Portal do professor, não é necessário realizar esse processo.

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

1- Acessar o IIS, selecionar a Guia principal e dar um duplo click sobre o ícone: Application Request Routing (ARR)

Será habilitado a opção: Ações | Abrir Proxy

Será habilitado algumas opções, e clicar no link: Proxy | Server Proxy Settings

Marcar o Checkbbx: Enable proxy e em seguida, clicar em aplicar.


Card
label2º - Instalar e configurar o URL Rewrite

2° - Instalar e configurar o URL Rewrite

Deck of Cards
effectDuration0.1
idtemp
effectTypefade
Card
labelInstalação
effectTypefade
Aviso

Caso tenha instalado o Rewrite para o Novo Portal do professor, não é necessário realizar esse processo.
Será necessário realizar apenas a configuração para o Portal Gestão Educacional (Ir para a Aba: Configuração Rewrite).

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

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

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

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


Card
labelConfiguração Rewrite
effectTypefade

O Portal Gestão Educacional utilizam três  regras para o rewrite, onde a primeira é utilizada para direcionamento de api's onde não é necessário passar o alias selecionado, a segunda é utilizada para as api's onde é necessário passar o alias selecionado e a terceira regra, onde é utilizando a comunicação entre o Portal Gestão Educacional e o app Meu eduCONNECT .Segue a configuração das três regras:

1- URL

  • Alterar apenas no nome da máquina (onde está executando o host server) e a porta da API.

                        Exemplo: http://{R:1}.192.168.98.34:8052/api/{R:2}

2- API

  • Alterar apenas no nome da máquina (onde está executando o host server) e a porta da API.

            Exemplo: http://192.168.98.34:8052/api/{R:1}

3- HUB

Nessa configuração, não é necessário alterar NENHUMA informação. A mesma já está preparada para atender o objetivo ( atualização automática das mensagens recebidas no Portal Gestão Educacional).


Aviso
titleAtençã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 deverão ser respeitadas.

Card
labelConfiguração do config
effectTypefade
  • 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:

      <add key="EnableRealtime" value="true" />  "Essa chave irá habilitar a comunicação com o HUB, por default está marcado como False, e ALTERAR para True"

       <add key="ApiPort" value="porta_definida_no_rewrite (IIS)" />

      <add key="DefaultDB" value="informe_aqui_o_nome_do_alias" />

      <add key="SubDomainMask" value="[ALIAS].nome_da_máquina_do_host" />


Aviso
titleAtençã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.

Nota
iconfalse

Em servidor publicado, na TAG: "SubDomainMask" utilizar o DNS.

Aviso
iconfalse

Se utilizar do rm.host, atentar para executa-lo como administrador.

Se utilizar o host.service, o usuário associado ao serviço tem que ter permissão para acessar a porta da API definida no URL Rewrite.



Card
labelConfiguração Rewrite TOTVS Educa Mobile (exibição das Salas no App)
Deck of Cards
idURL Rewrite
Card
effectDuration0.1
labelConfiguração do URL Rewrite
effectTypefade

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


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

Inserir as informações:

3. No campo "Name" informar o endereço:  TOTVS_API_ReverseProxyInboundRule


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


5. Na opção: "Conditions", clicar no botão: Add. e inserir a informação:

{REQUEST_URI}  /api/(.*)


6. Na opção: "Actions", no campo: Rewrite URL informar o link: http://localhost:8052/{R:1}


Importante:

  • A URL a ser utilizada é a do servidor onde encontra-se instalado o Host, como exemplo, utilizamos o endereço http://IPdoServidorHost:8052/{R:1
    • Em alguns casos o servidor do Host é dirente do servidor Web, então neste caso, deve-se utilizar o endereço do servidor do Host. 
  • Verificar a porta configurada na tag ApiPort do arquivo de configuração do Host, como exemplo, utilizamos a porta 8052.
  • Em alguns cliente a parte da URL {R:1} é substituido por {C:0}


Verificar qual é a parte da URL {R:1} ou {C:0}


Utilizar o endereço http://EndereçodoServidorWeb/EducaMobile/api/framework/v1/menus/dd6626a5aa1e3c2c2ad79198824f67a4?$filter=tagMenu eq '808100759'&companyId=1



7. Em seguida, clicar no botão: Aplicar

Será apresentado a mensagem: As alterações foram salvas com êxito.


Card
effectDuration0.1
labelConfiguração do Config
effectTypefade
  • 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" />
<add key="DefaultDB" value="CorporeRM" />

Aviso
iconfalse

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.