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

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

Image Removed

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

Image Removed

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

Image Removed

Marcar o Checkbox: Enable proxy e em seguida, clicar em aplicar

Image Removed

...

title2° - Instalar e configurar o URL Rewrite

...

effectDuration0.1
idtemp
effectTypefade

...

defaulttrue
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 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 Removed

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

Image Removed

...

labelConfiguração Rewrite
effectTypefade

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

          Exemplohttp://{R:1}.hostServer01:8052/api/{R:2}

Image Removed

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

            Exemplohttp://hostServer01:8052/api/{R:1}

Image Removed

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 Removed

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 

Image Removed

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

Image Removed

  • 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 Removed

  • 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 Removed

  • 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 Removed

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
    2. RM.Host.exe.config, se utilizar o Host local
  2. A ordem das regras deverá ser respeitada.

...

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

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

...

titleAtenção

Para a opção "EnableRealtime"

...

Para a opção "SubDomainMask":

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

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.Image Removed

...

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

...

titleConfiguração do URL Rewrite

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

Image Removed

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

Image Removed

Image Removed

Inserir as informações:

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

Image Removed

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

Image Removed

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}

Image Removed

Image Removed

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

Image Removed

Image Removed

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

Image Removed

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

Painel
titleConfiguração do Config

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

...

iconfalse

...

do portal gestão educacional deve ser configurado seguindo os passos da documentação: Configuração dos novos portais