Histórico da Página

Para que um item do menu seja aberto em um navegador separado, é necessário incluir o parâmetro openInBrowser na querystring da URL

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:

1. Configuração do Menu XML

No arquivo Menu.xml, a tag <ExternalURL> deve apontar para o diretório de customização do servidor:

• URL: http://ENDERECO_SERVIDOR/EducaMobile/Custom/

2. Criação do Arquivo de Redirecionamento

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.

3. Implementação da Lógica (Regra de Negócio)

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 Modified

4. Arquivo de exemplo

Disponibilizamos abaixo um arquivo de exemplo para que a instituição possa realizar o download e a customização, seguindo o padrão estabelecido.

 View file
name
index.html
height
250