Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Expandir
title1° - Instalar e configurar o "Application Request Routing" (ARR)
Aviso

Caso tenha instalado e configurado o Application Request Routing (ARR) para o Novo Portal do professorProfessor, 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 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 Checkbox: Enable proxy e em seguida, clicar em aplicar.

Expandir
title2° - Instalar e configurar o URL Rewrite
false
Deck of Cards
startHidden
effectDuration0.1
historyfalse
idtemp
effectTypefade
Card
defaulttrue
labelInstalação
effectTypefade
Aviso

Caso tenha instalado o Rewrite para o Novo Portal do professorProfessor, 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"

Image Removed

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

Image Removed

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

Image Removed

site https://www.iis.net/downloads/microsoft/url-rewrite para realizar o download do módulo do rewrite para o iis, realizar o download conforme a versão do servidor.

Image Added

2. Após realizar o download, executar o instalador e seguir os passos até finalizar a instalação.


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


Card
labelConfiguração Rewrite
effectTypefade

O Portal Gestão Educacional Educacional utiliza três as seguintes regras para o rewrite, onde a :

  1. A primeira é utilizada para direcionamento de api's onde não é necessário passar o alias selecionado
, a
  1. A segunda é utilizada para as api's onde é necessário passar o alias selecionado
e a
  1. (apenas para versões inferiores a 2402)
  2. A terceira é utilizada para fazer a comunicação entre o portal e
o eduCONNECT
  1. o eduCONNECT com o HUB (tecnologia utilizada para realizar a troca de mensagens entre usuários do portal e o eduCONNECT).

Segue a configuração das três regras:

1

-

. URL

  • Alterar onde está escrito "informe_o_nome_da_maquina" para o nome da máquina onde o host está sendo executado.
  • Alterar onde está escrito "informe_o_host" para o número da porta onde está configurado a porta da api no host (parâmetro apiPort).

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

2

- API

. API - Esta regra se aplica para versões inferiores a 2402

  • Alterar onde está escrito "informe_o_nome_da_maquina" para o nome da máquina onde o host está sendo executado.
  • Alterar onde está escrito "informe_o_host" para o número da porta onde está configurado a porta da api no host (parâmetro apiPort).

            Exemplo: http http://hostServer01: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).


Se por acaso não existir essa regra configurada, ou no Portal Gestao Educacional ao abrir a tela de agente de atendimento e na mesma exibir um contador acima da lista de salas, favor verificar as configurações desta regra.

  • Clicar em Add Rule(s)
Image Added


  • Na janela que abrir, selecionar a opção blank rule que se encontra no template de regra Outbound rules


Image Added
  • Na tela que abrir preencher os campos conforme a seguir:
  • Preencher o campo name com o valor TOTVS_API_SignalR_Proxy
  • O campo Precondition selecionar JSON
  • Na aba Match preencher os campos conforme a seguir:
  • O campo Matching scope selecionar Response, os campos Match the content within e Custom tags não selecionar nada, permanecendo vazio
  • O campo Content selecionar Matches the Pattern
  • O campo Using selecionar Regular Expressions
  • O campo Pattern preencher com o seguinte valor: \"Url\":\"(.+?)\"
  • Marcar a opção Ignore Case 

Image Added

  • Na aba Conditions preencher os campos conforme a seguir:
  • O campo Logical grouping selecionar Match All
  • Clicar no botão Add

Image Added

  • Preencher o campo Condition input com o valor: {URL}
  • O campo Check if input String selecionar Matches the Pattern
  • Preencher o campo Pattern com o valor: aliasname\.(.*)/api/framework/v1/realtime/
  • Marcar a opção Ignore Case

Image Added


  • Na aba Action preencher os campos conforme a seguir:
  • O campo Action Type selecionar Rewrite
  • Preencher o campo Value com o valor: "Url":"/framehtml/web/app/edu/PortalGestaoEducacional/aliasname.{C:1}{R:1}"
  • Marcar a opção Stop processing of subsequent rules


Image Added

  • O caminho preenchido no campo value deve ser o mesmo onde está configurado o portal gestao educacional, para o valor informado acima por exemplo, o pge está configurado no caminho framehtml/web/app/edu/PortalGestaoEducacional, o valor que vem depois do caminho, permanece fixo, sem alteração (/aliasname.{C:1}{R:1})

Image Added


Aviso
titleAtenção
  1. A porta utilizada deve ser a mesma que está configurada na chave "ApiPort" no arquivo de host (para mais detalhes ver a aba Configurações do config)
    1. RM.Host.Service.exe.config, se utilizar o Host Service
e
    1. RM.Host.exe.config, se utilizar o Host local
). Ver a aba Configurações do config.  
  1. A ordem das regras
deverão
  1. deverá ser
respeitadas
  1. respeitada.
Card
labelConfiguração do config
effectTypefade

Acessar o RM.Host.Service.exe.config (Se se o cliente utilizar o Host Service) ou  ou RM.Host.exe.config (Se se o cliente utilizar o Host local)   na Pasta: 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 <add key="ApiPort" value="porta_definida_no_rewrite (IIS)" />

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

  • Para versões inferiores a 2402 é necessário adicionar a seguinte chave também

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


Aviso
titleAtenção

Para a opção "EnableRealtime"

  1. Essa chave irá habilitar a comunicação com o HUB, por default está marcado como "false",ALTERAR para "true"

Para a opção "SubDomainMask", o :

  1. O nome da máquina deve ser inserido todo utilizando letras minúsculas.
  2. O texto [ALIAS] não deve ser alterado, deve ser inserido o texto desta forma, o que deve ser alterado é o "
nomeDaMaquinaDoHost
  1. nome_da_máquina_do_host".

Exemplo: se a máquina do host possui o nome de ServerXYZ, desta forma , o texto deve ser inserido o texto como [ALIAS].serverxyz.

Nota
titleParâmetro EnableRealtime

Caso o parâmetro EnableRealtime esteja como "false" no arquivo de configuração do host, a funcionalidade do agente de atendimento do portal e no eduCONNECT irão funcionar normalmente, mas de forma offlineoff-line, isso significa que no portal, irá aparecer um contador informando que após o término da contagem, as mensagens serão atualizadas. O envio de mensagem não será de forma imediata, a mensagem será enviada mas somente irá aparecer no portal após o fim da contagem de atualização. Diferentemente de quando o parâmetro está com "true", que não é exibido exibida a contagem e as mensagens são enviadas e aparecem de forma imediata.

Nota
iconfalse

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

Aviso
iconfalse

Se utilizar do o rm.host, atentar para executa-lo este tem que ser executado 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)
effectTypefade

Essa configuração é necessária para que as salas sejam exibidas no menu: Mensagens | Sala de Atendimento.
Para mais detalhes do processo, acessar a documentação: Parametrização da Sala de Atendimento no App: Meu eduCONNECT. ( Menu: 07 da Documentação). 

effectType

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

Image Modified

2. Dar um duplo click no ícone URL Rewrite e em seguida clicar em: Adicionar

uma Rule do tipo 

uma Rule do tipo Inboud Rule

.

Image Modified

Image Modified

Inserir as informações:

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

Image Modified

4. Na opção: Match URL, no campo

:

"Pattern"

inserir

 inserir a informação: (.*)

Image Modified

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

{REQUEST_URI}  /api/(.*)

Image Modified

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 é diferente 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} é substituído por {C:0}

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

Image Modified

Image Modified

Utilizar o

endereço 

endereço http://EndereçodoServidorWeb/EducaMobile/api/framework/v1/menus/dd6626a5aa1e3c2c2ad79198824f67a4?$filter=

tagMenu eq

tagMenu eq '808100759'&companyId=1

Image Modified


Image Modified

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

Image Modified

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

card
Painel
Deck of Cards
idURL Rewrite
Card
effectDuration0.1
label
title
Configuração do URL Rewrite
fade
fade
Painel
effectDuration0.1
label
title
Configuração do Config
effectType

Acessar o RM.Host.Service.exe.config (

Se

se o cliente utilizar o Host Service)

ou 

ou RM.Host.exe.config (

Se

se o cliente utilizar o Host local)

 

na

Pasta:

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.