Linha RM

Atalhos

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

Versões comparadas

Versão antiga 44

changes.mady.by.user Samuel Rodrigues Carvalho Araujo

Gravado em

comparado com

Nova versão 45

changes.mady.by.user Samuel Rodrigues Carvalho Araujo

Gravado em

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 Checkbox: 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 utiliza 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 é 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}

2- API

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


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


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