Histórico da Página

1.

Acessar o

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.

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

Após a Instalação, será criado um ícone:

 “URL Rewrite” no IIS

Image Modified

O Portal Gestão

Educacional utiliza

as seguintes regras para o rewrite

:

1. A primeira é utilizada para direcionamento de api's onde não é necessário passar o alias selecionado

2. A segunda é utilizada para as api's onde é necessário passar o alias selecionado

1. (apenas para versões inferiores a 2402)
2. A terceira é utilizada para fazer a comunicação entre o portal e 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://{R:1}.

hostServer01:8052/api/{R:2}

Image Removed

Image Added

2

. 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://

hostServer01:8052/api/{R:1}

Image Removed

Image Added

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).

Image Modified

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

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" /

>

<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" />

Se utilizar

o rm.host,

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.

Image Modified

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). 

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 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 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 http://EndereçodoServidorWeb/EducaMobile/api/framework/v1/menus/dd6626a5aa1e3c2c2ad79198824f67a4?$filter=

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.

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" />