Histórico da Página
Expandir | ||
---|---|---|
| ||
Realizar o download do ARR no link https://www.microsoft.com/en-us/download/details.aspx?id=47333. 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 Checkbox: Enable proxy e em seguida, clicar em aplicar |
...
title | 2° - Instalar e configurar o URL Rewrite |
---|
...
effectDuration | 0.1 |
---|---|
id | temp |
effectType | fade |
...
default | true |
---|---|
label | Instalação |
effectType | fade |
Aviso |
---|
Caso tenha instalado o Rewrite para o Novo Portal do Professor, não é necessário realizar esse processo. |
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.
2. Após realizar o download, executar o instalador e seguir os passos até finalizar a instalação.
3. Após a Instalação, será criado um ícone: “URL Rewrite” no IIS
...
label | Configuração Rewrite |
---|---|
effectType | fade |
O
...
portal
...
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}
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}
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)
...
- Na janela que abrir, selecionar a opção blank rule que se encontra no template de regra Outbound rules
...
- 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
- Na aba Conditions preencher os campos conforme a seguir:
- O campo Logical grouping selecionar Match All
- Clicar no botão Add
- 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
- 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
- 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})
Aviso | ||
---|---|---|
| ||
|
...
label | Configuração do config |
---|---|
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:
<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" />
...
title | Atenção |
---|
Para a opção "EnableRealtime"
...
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 "nome_da_máquina_do_host".
Exemplo: se a máquina do host possui o nome ServerXYZ, desta forma o texto deve ser inserido como [ALIAS].serverxyz
Nota | ||
---|---|---|
| ||
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 off-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 é exibida a contagem e as mensagens são enviadas e aparecem de forma imediata. |
Nota | ||
---|---|---|
| ||
Em servidor publicado, na TAG: "SubDomainMask" utilizar o DNS. |
Aviso |
---|
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. |
...
label | Configuração Rewrite TOTVS Educa Mobile (exibição das Salas no App) |
---|---|
effectType | fade |
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).
...
title | Configuração do URL Rewrite |
---|
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 a informaçã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 é 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}
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.
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" /> |
...
icon | false |
---|
...
do portal gestão educacional deve ser configurado seguindo os passos da documentação: Configuração dos novos portais