Essa funcionalidade tem como objetivo fornecer as informações do contexto do Educa Mobile, para que seja possível  realizar algumas integrações e fornecer à aplicação "de outro site" que será chamada por dentro do Educa Mobile.

Para realizar essa parametrização, é necessário realizar algumas parametrizações:

01. PARAMETRIZAÇÃO

É necessário habilitar o menu: Aplicação Externa dentro do arquivo XML ( do TOTVS Educa Mobile) em: C:\TOTVS\CorporeRM\EducaMobile\Areas\Educacional - abrir o arquivo Menu.xml

1- Localizar ou cadastrar os seguintes itens referentes a Aplicação Externa para o Login de Aluno e Professor.


2- Feito o procedimento para o Item 1, retirar o comentário da tag MenuItem(caso exista).

3- Será necessário definir a TAG de permissão se é referente a aluno ou professor. Esta definição é feita através do Item Tag

Tag de permissão do Aluno: 808100537

Tag de permissão do professor: 808100572

4- A TAG chamada "SetContext" especifica se antes do redirecionamento para o endereço especificado na Tag "ExternalURL" será aberto a tela de seleção de contexto. 

  1. Para especificar que o contexto deve ser aberto antes do redirecionamento, a TAG "SetContext" deve conter o valor "S". A tela de seleção de Contexto só será aberta se o aluno ou professor ainda não estiver selecionado nenhum contexto anteriormente, e as variáveis e sessions internas do EducaMobile ainda não estiverem preenchidas. 
  2. Se o valor da TAG SetContexto conter qualquer valor diferente de "S" ou até mesmo não existir, não será exibido a tela de seleção de contexto antes do redirecionamento. Se o contexto do aluno ou professor já tiver sido selecionado antes da utilização deste item de Menu, o contexto não será alterado ou apagado.

5- O Tipo de Usuário deverá ser especificado corretamente através da TAG "TipoUser" como sendo "A" para Aluno e "P" para Professor. O contexto que será exibido para o usuário será baseado nesta informação. Esta Tag é obrigatória conforme os outros itens de Menu.

6- Conceder a permissão no item de Menu: URL's Externas

7- Na linha:

Colocar a URL da aplicação externa ou a URL da página intermediária, conforme a utilização abaixo.
Caso for utilizar o método "GetSession" para recuperar a sessão do usuário, a aplicação que fará a requisição deve estar no mesmo Site do IIS onde o Educa Mobile foi instalado. Caso seja outra tecnologia ou servidor web, sugerimos fazer uma página intermediária para fazer a requisição de coleta da sessão e depois redirecionar para a aplicação externa.

02. LOCALIZAR A SESSÃO DO USUÁRIO

Acessar o arquivo Web.config em C:\TOTVS\CorporeRM\EducaMobile e incluir o portal (desejado) na Tag: <add key="DomainAccessSession" value="insira_aqui_a_URL_do_portal" />

03. EXEMPLO - LOCALIZAÇÃO DOS DADOS DOS USUÁRIOS

Ao logar no portal TOTVS Educa Mobile e clicar no menu correspondente a Aplicação Externa, será apresentado a informação do Contexto do usuário (logado) em formato JSON.

Aluno

Professor

Para formar os dados no formato legível, poderá formatar de duas formas:

  • Pelo POSTMAN: Acessar o Postaman, clicar em raw, em seguida selecionar a formatação JSON e clicar em Beautify.

<?xml version="1.0" encoding="UTF-8"?>
<HTML>
<title></title>
 <head></head>
 <body>
  <h1>GetSession</h1>
  <label id="lb"></label>  
  <script lang="javascript">
    var xhr = new XMLHttpRequest();
    xhr.open('GET', 'http://DOMININIO/EducaMobile/EduSessao/GetSession');
    xhr.responseType = 'json';
    xhr.onload = function() {
      if (xhr.status === 200) {
          var jsonString = JSON.stringify(xhr.response);
        document.getElementById("lb").innerHTML  = jsonString;
      }
    };
    xhr.send();
  </script>   
 </body>
</HTML>