Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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

Para realizar essa parametrizaçãoutilizar este recurso, é necessário realizar algumas as parametrizações abaixo:

01. PARAMETRIZAÇÃO

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

1- Localizar o item referente Localizar os seguintes itens referentes a Aplicação Externa para o Login de usuários do tipo Aluno e Professor.

Image Removed

Image Removed

2- Retirar o comentário do item 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

Referente ao acesso ao menu: URL's Externas

...

/ou Professor, retirando os comentários das tags MenuItem, conforme abaixo:

Item de menu referente ao acesso de alunos:

Image AddedImage Added

Item de menu referente ao acesso de professores:

Image AddedImage Added


2- Definir as permissões de acesso a estes itens de menu: Cada item de menu é exibido para o usuário logado no Educa Mobile conforme a sua permissão existente no Perfil do usuário correspondente ao seu usuário. Para que estas permissões não sejam validadas para a exibição de um item de menu, e todos os usuários tenham acesso ao item independente das suas permissões, basta deixar o conteúdo da tag <Tag>0</Tag> com o valor 0 no seu conteúdo. O valor 0 indica que não será feito nenhuma validação de permissão para este item.

Para exibir este item de menu conforme permissões do item "URL's externas" no cadastro de Perfil, defina os seguintes valores (que são valores fixos referente ao código do respectivo perfil:

ID de segurança do item "URL's externas" para aluno: 808100537

Image Added

ID de segurança do item "URL's externas" para o professor: 808100572

Image Added

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 o usuário logado no Educa Mobile. 

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

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 as as devidas permissões no cadastro de perfil de aluno e professor, caso especificado no item 2:

Aluno: Educacional | Educacional (Portal) | Acadêmico | URL's externas
Image Added

Professor: Educacional | Educacional (Portal) | Professor | URL's externas
Image Added

7- Especificar a URL da aplicação externa, ou a URL da página intermediária na tag ExternalURL, conforme exemplo abaixo:

Menu Professor:

Image Added


Menu Aluno:

Image Added


Nota
titleRegras de validação

Nos casos em que for utilizado o WebService 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, conforme imagem abaixo. 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.

Image Added



8- Acessar o IIS, clicar com o botão direito do mouse em Default Web Site, e clicar em adicionar aplicativo.


Image Added 


Nesta janela informa no campo Alias o nome da sua aplicação e no caminho físico informar o local onde está a pasta da aplicação externa.


Image Added


Após informar os passos acima a sua aplicação vai ficar no mesmo Site do IIS onde o Educa Mobile foi instalado conforme print abaixo:


Image Added



...

4- Na linha: Image Removed

Alterar a URL para o Portal desejado e salvar.

02. LOCALIZAR A SESSÃO DO USUÁRIO

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


Image RemovedImage Added

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 contexto do usuário (logado) em formato JSON.

Aluno

Professor

Dica

Para formar formatar 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.

Dica
titleExemplo 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>