Histórico da Página
A parametrização básica do TOTVS eduCONNECT é realizada a partir dos parâmetros do sistema TOTVS Gestão Educacional. O primeiro passo para que a parametrização seja concluída com sucesso é a definição de um usuário que será utilizado na parametrização do TOTVS eduCONNECT e que tenha permissão ao item "Permite autenticar no eduCONNECT nos parâmetros do sistema".
Como foi informado no item 1, o TOTVS eduCONNECT traz consigo uma integração nativa com o TOTVS Educa Mobile e o usuário citado anteriormente é utilizado para validar a conexão entre TOTVS Educa Mobile e TOTVS eduCONNECT.
Observe a seguir, a tela onde é apresentado o item de permissão mencionado:
Serviços Globais | Segurança| Perfis | 'Sistema' Educacional | Acesso a Menus | Educacional | eduCONNECT| Permite autenticar no eduCONNECT nos parâmetros do sistema
A parametrização que possibilita a sincronização do eduCONNECT com o TOTVS Educacional, está disponível no menu 'Sistema' Educacional | Configurações | Parâmetros| eduCONNECT
02.1 - Integração do aplicativo TOTVS eduCONNECT com o TOTVS Educa Mobile.
Ativar integração com o eduCONNECT: ativa a integração entre TOTVS eduCONNECT, TOTVS Educa Mobile.
Código da Instituição: identificador único fornecido pela TOTVS mediante a aquisição do TOTVS eduCONNECT.
| Dica | ||
|---|---|---|
| ||
Para a definição de quantos códigos de instituição serão necessários, podemos pensar na seguinte pergunta: os contextos (filiais e níveis de ensino) são bastante distintos uns dos outros, chegando a ter identidade visual diferente como cores, banners e/ou logotipo? Nesses casos, sugerimos a criação e configuração de contas diferentes (códigos de instituição), para que sejam tratados como se fossem aplicativos diferentes, possibilitando que cada conjunto de coligada, filial e nível de ensino tenha suas configurações. Para mais detalhes sobre como adquirir seu código de instituição e provisionamento de conta, entre em contato com seu A.R. |
URL de conexão com o eduCONNECT: é o endereço do servidor responsável por gerenciar os serviços e integração do eduCONNECT com o TOTVS Educacional e TOTVS Educa Mobile. Esta URL é emita pela TOTVS.
Usuário e senha para autenticação: nesses campos é necessário informar as credenciais do usuário atribuído ao perfil criado no início dessa seção (que deve ter a permissão ao item "Permite autenticar no eduCONNECT nos parâmetros do sistema"). Esses dados, em conjunto com o "Código da Instituição" constituem uma chave de segurança que garante que apenas a instituição à qual foi destinada aquele código poderá utilizar essa integração. Após informar as credenciais do usuário, é necessário clicar no botão "Autenticar" e aguardar a validação. Caso não ocorra nenhum erro, a mensagem "Token inválido. Favor autenticar novamente" será trocada para "Status: Autenticado!".
Gerar QRCode de configuração do eduCONNECT: este botão só será habilitado com os campos Código da Instituição e URL de conexão com o eduCONNECT preenchidos. O QRCode será gerado com a parametrização definida. Essa funcionalidade pode ser utilizada de várias formas, como por exemplo na divulgação do aplicativo, pois através do TOTVS eduCONNECT os usuários podem realizar a leitura desse QRCode e configurar automaticamente seu aplicativo com os padrões da instituição, sem a necessidade de digitar nenhuma informação de configuração. Para isso basta que o usuário do eduCONNECT acione a função QRCode disponível na tela de login do aplicativo. Essa função irá acionar a câmera para leitura do QRCode disponibilizado pela instituição e automaticamente será carregada toda parametrização de servidor, URL de conexão, tema e login com o Facebook.
02.2 - Configurando o login com Facebook no TOTVS eduCONNECT
Para maiores informações de como parametrizar essa funcionalidade, ler a documentação abaixo:
Nessa etapa pode ser configurado o login no aplicativo TOTVS eduCONNECT através do Facebook. Para habilitar essa configuração é necessário marcar a opção "Adicionar botão de login com o Facebook no app
...
O Facebook para desenvolvedores permite medir, entender e otimizar as interações das pessoas. Inicialmente o eduCONNECT usará o perfil público, lista de amigos e endereço de e-mail caso o aluno permita para que seja utilizando em futuras implementações para ajudar na comunicação e adição de novos recursos na plataforma .
Para realizar a configuração do acesso único ao eduCONNECT via Facebook, serão necessárias as seguintes ações abaixo:
1º- Acesse o website aos desenvolvedores do Facebook (http://developers.facebook.com).
Atenção: será necessário que a instituição tenha um cadastro válido na plataforma do Facebook;
2º- Acesse o menu “Meus Aplicativos” em seguida o item “Adicionar um novo aplicativo”;
...
".
No campo "Aplicativo do Facebook" deve ser informado o aplicativo do Facebook configurado previamente.
Para maiores informações sobre como configurar um aplicativo para login com Facebook no TOTVS eduCONNECT, clique aqui.
02.3 - Personalizando o TOTVS eduCONNECT
Nessa etapa as informações como nome do aplicativo, cores e imagens poderão ser personalizadas.
No campo "Nome do app" deve ser informado o nome que aparecerá no aplicativo quando o usuário estiver logado ou quando o usuário realizar a leitura de um QRCode de configuração.
Nos campos de cores ("Cor da fonte do nome e do menu lateral" e "Cor do menu e da barra superior") são configuradas as cores do aplicativo.
O campo "Logo da instituição" é onde pode ser parametrizada a imagem que serão exibida na tela de login do TOTVS eduCONNECT.
03.3 - Configurando a URL do TOTVS Educa Mobile acessível pela internet.
| Informações | ||
|---|---|---|
| ||
Esta opção de configuração está disponível no TOTVS eduCONNECT a partir da release 12.1.19. |
Durante o processo de aquisição do TOTVS eduCONNECT, a TOTVS solicita ao cliente algumas informações e dentre elas, a URL do TOTVS Educa Mobile. Essa URL compõe a configuração e identidade do aplicativo TOTVS eduCONNECT juntamente com o "Código da Instituição" com objetivo de fazer um vínculo único entre o aplicativo e o TOTVS Educa Mobile. Com objetivo de dar mais liberdade independência ao cliente no que diz respeito à configuração do aplicativo, foi criada a opção que permite a alteração dessa URL pré-configurada, porém, é pré-requisito para essa alteração que as credenciais de um usuário com permissão de autenticação no TOTVS Educa Mobile sejam informadas.
| Dica | ||
|---|---|---|
| ||
Para que a URL possa ser alterada, tanto a nova URL quanto a URL antiga precisam estar ativas e disponíveis. |
| Nota | ||
|---|---|---|
|
3º- Crie um novo aplicativo Facebook, informando o “Nome de exibição” (Nome do aplicativo) e um “E-mail de contato” com o responsável pelo aplicativo. Para efeitos de explicação poderemos usar para os campos os valores “Portal do Aluno Login Facebook”;
4º- Ao criar o aplicativo, será exibido todos os serviços que o Facebook disponibiliza para acesso externo via aplicativo. Em nosso exemplo iremos escolher “Login do Facebook” e em seguida clique em “Começar”.
5º- Será exibido as configurações do login do Facebook. Nesta etapa, deve ser realizado as configurações de OAuth do cliente conforme imagem:
6º- Clique no menu lateral na opção “Configurações”. Nessa seção, é possível definir configurações adicionais como Logo da empresa, URL da política de privacidade, URL de Termos de Serviço e etc (que são opcionais para o funcionamento do serviço desejado, mas recomendável que a instituição faça seu preenchimento).
7º- Uma vez definida todas as configurações necessárias para funcionamento do aplicativo de Login via Facebook, precisaremos de alguns dados para fazermos a ligação do aplicativo com o sistema RM. Para isso, acesse o menu “Painel”, onde estão as informações necessárias para fazer essa integração. Anote os dados destacados conforme a imagem abaixo;
8º- Acesse o RM, em seguida vá na aba “Gestão”, localize o grupo “Comunicação” e em seguida clique no menu “Aplicativos Externos”. Caso o mesmo não esteja disponível, será necessário aplicar permissão para o usuário nas configurações de perfis de acesso do sistema de Serviços Globais;
9º- Crie um novo registro na visão de aplicativos externos. Neste registro deverão ser incluídas todas as informações destacadas no passo 7. Atenção, no campo “Provedor do Aplicativo” deveremos selecionar o valor “1 - Facebook”.
10º- Ao cadastrar todas as configurações no aplicativo como também no sistema RM, deveremos ativar a exibição do botão, acessando Configurações |Parâmetros|EduCONNECT|eduCONNECT 2/3.
Nesta etapa, basta marcar "Adicionar botão de login com o Facebook do app" e informar o aplicativo do Facebook criado no passo anterior.
11º- Por último, será necessário publicar o aplicativos Facebook para habilitar seu funcionamento ser tornar público. Acesse o menu “Revisão do Aplicativo”, e ative “sim” para o item “Tornar [NOME DO APLICATIVO] público?”.
Ao avançar etapa (eduCONNECT 3/4) é possível configurar o visual do aplicativo
O usuário irá informar qual o nome do aplicativo. A imagem, cores de menu superior e lateral também devem ser definidos nessa etapa de parametrização.
Na etapa (eduCONNECT 4/4) pode ser alterada a URL do Educa Mobile acessível pela internet.
Para informar uma nova URL o usuário e senha devem ser autenticados na etapa eduCONNECT 1/4.
...
| |
Caso você possua restrições que limitem os acessos aos servidores em sua rede ou você é cliente TOTVS Cloud, atenção às recomendações abaixo: |
...
|
...
Caso exista alguma restrição de acesso ao servidor, é necessário liberar as requisições da URL do eduCONNECT (aba eduCONNECT 1). |
...
|
...
onde é executado o serviço de host deve ter acesso às URLs abaixo para conseguir fazer as requisições que a solução necessita: |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas