Com este recurso, a instituição pode criar menus personalizados para integrar e acessar outras aplicações externas pelo Meu eduCONNECT/ TOTVS Educa Mobile.
| Aviso |
|---|
A TOTVS não se responsabiliza por alterações em arquivos decorrentes de customizações realizadas pelo cliente. Portanto, é indispensável que, antes de cada atualização de patch ou versão, o cliente realize o backup de suas modificações e as reaplique após o processo, uma vez que o conteúdo original pode ser sobrescrito. |
| Informações |
|---|
|
As customizações dos conteúdos escritos devem ser realizadas em cada servidor web existente. |
| Expandir |
|---|
| title | Acesso ao arquivo de configuração do menu |
|---|
|
Acessar o arquivo "Educamobile\Areas\Educacional\Menu.xml", no diretório onde está instalado o TOTVS Educa Mobile. Para customizar o menu do TOTVS Educa Mobile, utilize a estrutura XML abaixo. O sistema disponibiliza um modelo de menu comentado para que a própria instituição realize seus ajustes a partir desse exemplo.  Image Added
|
| Expandir |
|---|
| title | Detalhamento das Tags de configuração |
|---|
|
Cada campo possui uma função específica para a renderização e o comportamento do link no aplicativo: <Tag> Define o valor padrão "0" para novos itens customizados.
<Caption> Define o nome (rótulo) que será exibido para o usuário no menu do aplicativo. No exemplo: "Aplicação Externa (Professor)".
<Image>Indica o caminho do ícone que será exibido ao lado do nome do menu. Deve apontar para o diretório de imagens do portal.
<ExternalURL>O endereço (URL) completo da aplicação externa que será aberta ao clicar no menu.
<TipoUser>Define qual perfil terá visibilidade deste item.
<SetContext>(S/N) Define o valor padrão "S" para novos itens customizados.
<Module>(S/N) Define o valor padrão "S" para novos itens customizados.
|
| Expandir |
|---|
| title | Executar a abertura em um navegador externo |
|---|
|
Por padrão, o Meu eduCONNECT e o TOTVS Educa Mobile redirecionam o acesso para URLs internas do portal e do aplicativo. Caso a instituição deseje que o link seja aberto externamente no navegador do dispositivo, é necessário observar as seguintes considerações:
| Informações |
|---|
| title | Incluir o parâmetro na URL de destino dentro do arquivo Menu.xml |
|---|
| Para que um item do menu seja aberto em um navegador separado, é necessário incluir o parâmetro openInBrowser na querystring da URL  Image Added
|
| Informações |
|---|
| title | Configuração de Links Externos com envio de contexto |
|---|
| Para abrir links em um navegador externo mantendo o envio de parâmetros de contexto (como a Coligada), a instituição deve seguir os passos abaixo:
No arquivo Menu.xml, a tag <ExternalURL> deve apontar para o diretório de customização do servidor: No servidor, acesse a pasta Educamobile\Custom e crie um arquivo chamado index.html. Este arquivo será responsável por capturar os dados da sessão e redirecionar o usuário. O script abaixo deve ser inserido no arquivo index.html. Ele realiza a ponte entre o TOTVS Educa Mobile e a sua aplicação externa:
// 1. Captura os parâmetros da URL atual (como o host)
const params = new URLSearchParams(window.location.search);
const host = params.get('h'); // 2. Define a URL de destino desejada (incluindo a tag para abrir no navegador)
const urlDestino = "https://www.totvs.com/?openInBrowser"; // 3. Consulta a API do Educa Mobile para recuperar os dados da sessão do usuário
const xhr = new XMLHttpRequest();
xhr.open('GET', 'http://ENDERECO_SERVIDOR/EducaMobile/EduSessao/GetSession');
xhr.responseType = 'json'; xhr.onload = function () {
if (xhr.status === 200) {
// Concatena a URL de destino com os dados de contexto (ex: CodColigada)
const urlFinal = `${urlDestino}&codcoligada=${xhr.response.Contexto.CodColigada}`; // Verifica se o acesso é via aplicativo Meu eduCONNECT
if (window.NavigationChannel) {
// Para o caso do app
window.NavigationChannel.postMessage(urlFinal);
} else {
// Para o caso do TOTVS Educa Mobile
window.open(urlFinal, '_blank');
}
}
};
xhr.send();
 Image Added
Disponibilizamos abaixo um arquivo de exemplo para que a instituição possa realizar o download e a customização, seguindo o padrão estabelecido.
|
|
