Histórico da Página

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-Retirar o comentário da tag MenuItem(caso exista) e informar o código da Tag, referente ao perfil: do Aluno e Professor.

Informações

Tag de permissão do Aluno: 808100537

Tag de permissão do professor: 808100572

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

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

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

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

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

Dica

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

Pelo link: https://jsonformatter.org/ e colar a informação no campo a esquerda da tela e clicar em: Format/Beautify.

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

Dica

title	Exemplo de uma 'Aplicação Externa'

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

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 20

Nova versão 21

Chave

01. PARAMETRIZAÇÃO

02. LOCALIZAR A SESSÃO DO USUÁRIO

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