Os servidor web que hospedará a aplicação precisará atender aos seguintes pré-requisitos:

 IIS – Internet Information Services versão 7.0 ou superior.

 Framework .Net versão 4.0 ou superior;

 Biblioteca RM - Caso exista um servidor de aplicação, este deve ter instalada a Biblioteca RM. Caso contrário, se o servidor web for também o servidor de aplicação, a instalação da Biblioteca RM deve ser feita nesse servidor.

Após a instalação dos pré-requisitos, o instalador do TOTVS Educa Mobile compatível com a Biblioteca RM instalada deve ser executado.O instalador criará o diretório virtual no IIS e também a pasta da aplicação no diretório que foi escolhido.

Ao término da execução do instalador do TOTVS Educa Mobile, as configurações de Host RM, Alias e Visualização Mobile estarão com as opções padrão. Caso o cliente queira alterar essas configurações, dentro da pasta da aplicação existe um arquivo chamado “web.config.xml” onde essas configurações podem ser alteradas.

 Configurações de Host RM

Essas configurações são as mesmas existentes atualmente para o Portal Corpore.Net, ou seja, as chaves "Host" e "Port" ficam por padrão com os mesmos valores configurados para o Portal Corpore.Net.

 Alias para conexão com banco de dados

Nessa chave deve ser configurado o nome do Alias para conexão com o banco de dados que será utilizado pela aplicação TOTVS Educa Mobile.

 Ativação da visualização mobile pelo navegador

Essa é a chave que contém a configuração onde é definido se as funcionalidades do TOTVS Educa Mobile poderão ser acessadas no formato mobile pelo navegador de um computador e não somente pelo celular.

 Personalização de cores

Essa chave define o diretório onde se encontra a configuração de cores (tema) padrão do TOTVS Educa Mobile criada no ThemeRoller. No item "05 - Personalizando cores" abordaremos detalhadamente os procedimentos para personalizar as cores do aplicativo.

 Personalização de imagens

Dentro da pasta citada no item "Personalização de cores" sempre é criada a pasta "images". Nessa pasta exitem dois arquivos chamados "minha_empresa.png" e "aplicativo.png", respectivamente, listados a seguir:

Para personalizar essas imagens deve-se trocá-las, mantendo o mesmo nome e características de extensão e dimensões.

 Personalização do nome

       Essa chave permite alterar o nome do TOTVS Educa Mobile .O nome fica disponível na barra superior após efetuar o login.

Após alterar:

01. APLICAÇÃO EXTERNA

Existe a possibilidade de adicionar links para sites externos da instituição no menu principal do Educa Mobile. Basta alterar o arquivo Menu.XML (Localizado em <Diretório de instalação do ERP>\CorporeRM\EducaMobile\Areas\Educacional), inserindo um novo item de Menu conforme o quadro abaixo:

(...)
	<MenuItem>
     	<Tag>0</Tag>
     	<Caption>NOME DO MENU</Caption>
     	<Image>Areas/Educacional/Content/images/mn_AplicacaoExterna.png</Image>
     	<ExternalURL>LINK DA APLICAÇÃO EXTERNA</ExternalURL>
     	<TipoUser>A</TipoUser>
     	<SetContext>S</SetContext>
     	<Module>S</Module>
	</MenuItem>
(...)

Referência

• TAG - ID de segurança de perfil de acesso do RM. O valor zero não irá validar perfil de acesso por usuário neste item de menu. (Uso interno, valor padrão 0)
• CAPTION - Nome da funcionalidade a ser acessada
• IMAGE - caminho da imagem a ser vinculada a funcionalidade no menu
• EXTERNALURL - URL a ser redirecionada
• TIPOUSR - Menu disponível para A - aluno ou P - professor
• SETCONTEXT - S ou N se deverá abrir a seleção de contexto antes de redirecionar para URL Externa
• MODULE - Indicativo do módulo associado a funcionalidade (Uso interno, valor padrão S)

URL Segura (HTTPs)

A funcionalidade de Aplicação Externa incluí a página indicada dentro de uma TAG de IFrame do Educa Mobile.

Caso seja incluído uma URL segura (HTTPs), alguns browsers podem bloquear o acesso, apresentando o erro: "Refused to display 'https://www.URLEXTERNA.com/' in a frame because it set 'X-Frame-Options' to 'sameorigin'.".

A URL a ser adicionada deve atender os seguintes critérios:

• A URL segura, de destino, deve estar no mesmo domínio do Educa Mobile; ou
• O site referenciado deve permitir acesso do Educa Mobile via IFRAME. No servidor WEB deverá permitir que a URL receba requisições do Educa Mobile.

(...)
	<httpProtocol>
    	<customHeaders>
      		<add name="X-Frame-Options" value="ALLOW-FROM https://educamobile.instituicao.com.br" />
    	</customHeaders>
	</httpProtocol>
(...)

Exemplo de configuração do Web.Config no IIS do servidor WEB da aplicação destino

Caso não tenha acesso ao Servidor Web da URL, não será possível realizar a configuração acima, sendo assim não poderá utilizar este endereço como Aplicação Externa.

1º exemplo: adicionando a URL do Google (https://www.google.com.br) não será exibida no Educa Mobile, pois este link tem a origem de um servidor diferente e o browser irá bloquear.

2º exemplo: quero adicionar a URL do site de LMS da instituição no Educa Mobile. Devo disponibilizar o Educa Mobile no mesmo domínio ou permitir acesso a URL do Educa Mobile no servidor WEB da aplicação de LMS.

02. CONFIGURAR TEMPO DE SESSÃO DO TOTVS Educa Mobile