Páginas filhas
  • Manual Operacional da Customização – Integração Office365

Versões comparadas

Chave

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

Manual Operacional da Customização - Integração Office365Office 365


Projeto: FS008265 (A85329) - Integração SGE x O365

...

Esse manual tem a função de detalhar, de forma operacional, como ocorrerá a integração do Office365 e SGE. 


Expandir
titleParâmetros Office365Office 365

Pré-Requisitos / Parametrizações

Não se aplica.

Descrição do Processo


No TOTVS Educacional, por meio do menu Customização Sistema Indústria | Office 365 | Parâmetros Office365O365, o usuário poderá efetuar as parametrizações referente ao envio de e-mail automático. 


Image RemovedImage Added


O usuário deverá efetuar as seguintes parametrizações:

  • Enviar e-mail para alunos/professores já existentes na base de dados: O parâmetro será do tipo checkbox onde o usuário deverá selecionar o parâmetro para ativar o envio de e-mails.
  • Tipo de e-mail: O parâmetro terá duas opções de escolha, sendo elas HTML e TXT, a customização permitirá a seleção apenas de um parâmetro. 
  • Corpo do e-mail: Deverá ser informado o texto do e-mail a ser enviado.
  • Tags disponíveis: Usuário poderá utilizar as Tags disponíveis para personalizar o texto de e-mail a ser enviado.
  • E-mail remetente: Deverá informar o endereço de e-mail do remetente do e-mail. 
  • Assunto do e-mail: Deverá informar o assunto do e-mail que os alunos/professores receberão. 


Image Removed                                                                                                                       Image Added


Expandir
titleInclusão e-mail O365 Office 365 para Professores e Alunos

Pré-requisitos / Parametrizações

Para geração de e-mail Google Office365 é necessário que usuário esteja logado no sistema na coligada SENAI SESI e existir um cadastro para aluno ou professor.

  • Descrição do processo

O processo de criação do e-mail Google ocorre de forma automática. Para alunos, é realizada a criação da conta no momento em que é efetuada uma matrícula em Disciplinas com o status igual ao informado no parâmetro "Situação de matricula para inclusão".  Para o professor, a criação ocorre ao associar o professor a uma filial no cadastros de Filiais do Professor.  Após a execução você terá acesso, na aba campos complementares, ao e-mail Google gerado para o novo usuário.

Caso o aluno ou o professor não esteja ativo na coligada SESI, o sistema também irá atualizar as informações do e-mail do cadastrado principal no momento em que é feito a comunicação das credenciais da conta Google, seja de forma automática ou manual.

Serão disponibilizados quatro meios para que o professor e aluno tenham acesso ao novo e-mail Google, sendo elas:

    • Envio de e-mail

Para aqueles alunos e professores que já tiverem um e-mail principal informado no seu cadastro e o parâmetro de comunicação automática estiver ativo para a filial, será enviado uma mensagem contendo as informações de e-mail Google e senha inicial.

    • Portal do aluno e professor

No menu do portal do aluno ou professor será apresentado um novo item de menu, "Classroom Google", que informa o e-mail Google e senha inicial, caso o usuário não deseje que apresente mais a mensagem bastará clicar na opção “Não apresentar novamente”.

    • Solicitação direta na secretaria

O aluno ou professor poderá solicitar na secretaria o e-mail Google e senha, de acordo com as regras da secretaria de cada regional, o atendente para ter acessos a esses dados basta acessar o cadastro do aluno ou professor no sistema ir na aba campos complementares e informar os valores de E-mail Google e Senha inicial para o solicitante. Lembrando que a senha informada no sistema é a inicial caso o aluno ou professor tenham modificado a senha na plataforma do Google esse novo valor não será salvo no SGE.

    • Relatórios disponibilizados pelo Regional

O regional poderá disponibilizar relatórios contendo as informações de e-mail Google e senha inicial através de consultas a tabela de campo complementares da tabela SALUNOCOMPL nos campos EMAILGOOGLE e SENHAGOOGLE e na tabela SPROFESSORCOMPL nos campos EMAILGOOGLE e SENHAGOOGLE.

    • Processo de comunicação das credenciais Google

O Processo de comunicação disponibilizados nas telas de Aluno, Professor e Turma/Disciplina realiza o envio de uma mensagem contendo as informações de e-mail Google e senha inicial para aqueles professores e alunos que contem um e-mail informado no seu cadastro. Esse processo também é responsável por atualizar o campo principal de e-mail nos cadastros de professor e aluno.

  • Detalhamento do processo
    Ao acessar Totvs SGE, na aba de Currículo e Oferta clique em Aluno ou Professor.

Image Removed

No exemplo abaixo iremos demostrar o cadastro de um novo aluno, informe todos os dados necessários para o cadastro e clique em salvar.

Image Removed

Após informar todos os dados necessário para o cadastro do aluno e salvar o aluno, que já tenha matrícula em um curso da modalidade parametrizada na filial, a tela será apresentada já com as informações do novo e-mail Google.

Image Removed

Nota
titleImportante!

Caso o aluno não esteja ativo na coligada do SESI o e-mail do cadastro principal do aluno será o novo e-mail Google gerado pela integração e o e-mail previamente cadastrado será copiado para o campo complementar “E-mail Legado”, caso a comunicação automática esteja habilitada para a filial.

 Image Removed

Ao salvar o aluno que não é ativo na Coligada SESI, o sistema terá copiado o e-mail informado no campo E-mail para o campo complementar E-mail Legado, e vai substituir o e-mail que estava nesse campo pelo novo e-mail Google.

Image RemovedImage Removed

Se o aluno estiver ativo na coligada SESI, o sistema só irá salvar o novo e-mail Google no campo complementar “E-mail Google”.

do Office365 será encaminhado ao SGE por meio da WebApi Customizada do SGE. É necessário também que os campos complementares estejam criados corretamente e habilitados para utilização no nível de ensino desejado (campos SALUNOCOMPL.EMAILO365 e SPROFESSORCOMPL.EMAILO365).


Descrição do processo


Será realizado pela BigBrain (Empresa fornecedora do Office 365), uma consulta na base de dados do SGE para identificar novos registros de aluno ou professor. Após a identificação será gerado o e-mail O365 para os alunos e professores, o TOTVS Educacional (SGE) receberá um ou mais registros de endereço de e-mail do Office 365 for Education, os e-mails recebidos serão armazenados/atualizados no cadastro do aluno e do professor em campo complementar. Como último passo poderá ocorrer o envio do e-mail de notificação para o aluno/professor conforme descrito em "Envio de E-mail de Notificação Aluno/Professor".


Nota
titleNota
  • A criação do e-mail e de responsabilidade da BigBrain empresa responsável pelo Office 365, o SGE não influência na criação do e-mail e não altera o e-mail criado. 

  • O retorno do e-mail O365 do aluno/professor para o SGE, contém as seguintes informações:   

    Envio e-mail aluno: 

    CodColigada - CodFilial - RA - E-mail O365


    Envio e-mail professor: 

    CodColigada - CodFilial - CodProf - E-mail O365

  • A customização possui uma tratativa nos casos em existe o aluno ou professor cadastrados com códigos diferentes na coligada SESI e SENAI. Para garantir a correta atualização do e-mail no SGE, será utilizado o código da pessoa para filtrar qual aluno ou professor no SGE corresponde ao e-mail retornado pelo Office.

  • É de responsabilidade e controle da BigBrain consultar quais novos alunos e professores foram cadastrados na base de dados do SGE e não possuem e-mail O365 gerado no Office.

Com base nas informações encaminhadas o endereço de e-mail será atualizado para os alunos e professores. Para visualizar o e-mail do O365 o usuário deverá acessar o SGE | Currículo e Oferta | Aluno ou Professor. 


Image Added


      Image Added                   Image Added


Dica

Os campos complementares são gerados automaticamente através de script, mas precisam ser habilitados pelo usuário para utilização por nível de ensino. Para isso, siga o roteiro de ativação dos campos complementares.

Para armazenamento do e-mail Office 365 a customização realizará a atualização/armazenamento do e-mail do aluno/professor de acordo com os seguintes cenários e regras:

  • Aluno/Professor existente na Coligada SENAI e não existente na Coligada SESI: Caso seja identificado (através do CPF) que o novo registro do aluno/professor existe no SENAI, a customização receberá do Office 365 o endereço de e-mail e realizará o preenchimento do endereço de e-mail somente no campo complementar customizado no cadastro do aluno/professor.


  • Aluno/Professor não existente na Coligada SENAI: Caso seja identificado que o novo registro do aluno/professor não exista no SENAI, a customização receberá do Office 365 o endereço de e-mail e realizará o preenchimento do endereço de e-mail no campo complementar customizado no cadastro do aluno/professor e no campo principal de e-mail.


  • Aluno/Professor já existente na base com o e-mail principal preenchido: A customização receberá do Office 365 o endereço de e-mail e realizará o preenchimento do endereço somente no campo complementar customizado no cadastro do aluno/professor. 


  • Aluno/ Professor já existente na base com e-mail não preenchido: A customização receberá do Office 365 o endereço de e-mail e realizará o preenchimento do endereço no campo complementar customizado no cadastro do aluno/professor e no campo principal do e-mail. 


Envio de E-mail de Notificação Aluno/Professor

Apenas será realizado o envio de e-mail para os alunos e professores existentes na base de dados dos Regionais que possuem um endereço de e-mail (e-mail principal - PPESSOA.EMAIL) diferente do criado pela integração customizada entre o SGE x O365

Ao realizar o preenchimento do endereço de e-mail a customização verificará se o parâmetro referente ao envio de e-mail de notificação está parametrizado.  Image Added

Caso esteja, a customização enviará o e-mail de notificação para os alunos/professores que possuírem um e-mail já cadastrado no SGE.


Nota
titleImportante!
  • Ao realizar o preenchimento do endereço de e-mail Principal a customização realizará de forma automática o preenchimento/atualização do campo referente ao e-mail do usuário do aluno/professor.
  • O e-mail de notificação contendo as informações parametrizadas nos "Parâmetros O365" será enviado ao aluno/professor apenas quando o e-mail principal sofrer alterações, caso contrário não será realizado o envio de e-mail.
  • Para que seja possível realizar o envio de e-mail pelo RM (utilizando a customização ou não), será necessário que as parametrizações de envio de e-mail do RM estejam  parametrizada corretamente. Parametrização de Envio de E-mail RM
  • A customização não realizará nenhuma validação no cadastro dos alunos/professores referente aos dados de matrícula, período letivo, turmas entre outros
Nota
titleImportante!

Regra de ativo no SESI para o aluno: Caso o aluno esteja matriculado em alguma disciplina na coligada do SESI cujo o status de matricula seja o mesmo informado no parâmetro de "Situação de matrícula “Matriculado” no SESI" no momento de criação da conta Google o mesmo será considerado como ativo no SESI.

Regra de ativo no SESI para o professor: Caso o usuário do professor tenha acesso liberado em alguma filial do SESI no momento de criação da conta Google o mesmo será considerado como ativo no SESI
  • .

Histórico de Atualização do Documento

...

Autor

Versão

Data

Descrição das Alterações

Ana Paula Fernandes Moroço

1.0

11/02/2020

Documento inicial.

Daniel Lucas Pereira2.0

 

Alterações