Linha RM

Atalhos

Páginas filhas
  • 1.0 - Pré-requisitos

Versões comparadas

Versão antiga 40

changes.mady.by.user Samuel Rodrigues Carvalho Araujo

Gravado em

comparado com

Nova versão 41

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 quatro  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 regra é utilizada para fazer a comunicação entre o Portal Gestão Educacional e o app Meu eduCONNECT e a quarta é utilizada para fazer a comunicação entre o portal e o HUB (tecnologia utilizada para realizar a troca de mensagens entre usuários do portal e o eduCONNECT) .Segue a configuração das quatro regras:

1- URL

  • Alterar apenas no nome da máquina (onde está executando o host server) e a porta da API.

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

2- API

  • Alterar apenas no nome da máquina (onde está executando o host server) e a porta da API.

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