Páginas filhas
  • 04.3 - Criar menus personalizados para integrar e acessar outras aplicações externas

Versões comparadas

Chave

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

...

Expandir
titleExecutar 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
titleAdicionar um tag 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


//

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

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

{
    if (xhr.status

===

200)

{

{
        //

Concatena

a

URL

de

destino

com

os

dados

de

contexto

(ex:

CodColigada)

const urlFinal =


        const urlFinal = `${urlDestino}&codcoligada=${xhr.response.Contexto.CodColigada}`;

        //

Verifica

se

o

acesso

é

via

aplicativo

Meu

eduCONNECT if

eduCONNECT
        if (window.NavigationChannel)

{ // Comando para o app abrir o navegador externo nativo

{
            // Para o  caso do app
            window.NavigationChannel.postMessage(urlFinal);

} else { // Abertura padrão para navegadores web


        } else {
            // Para o caso do TOTVS Educa Mobile
            window.open(urlFinal,

'_blank');

} } };


        }
    }
};
xhr.send();


Image Added


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.



Informações
titleConfiguração de Links Externos com Envio envio de Contextocontexto

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:

HTML
View file
nameindex.html
height250