O manual a seguir visa detalhar a integração de alguns módulos da solução SGE com o Portal SESI Educação, facilitando assim a gestão e acesso aos participantes (alunos, professores, funcionários).
|
Para utilização da Integração com o Portal SESI Educação é necessário observar alguns pontos:
Observação importante: Somente informações relacionadas aos segmentos preenchidos na parametrização serão integrados. |
|
|
Esta parametrização é realizada por coligada (SESI – Departamento Regional) e nível de ensino do SGE – Módulo Educacional (Educação Básica) e as informações preenchidas são armazenadas em tabela customizada. Os parâmetros estão agrupados em abas/guias. A seguir apresentamos os parâmetros necessários para a integração e seus significados:
|
|
|
|
Pré-Requisitos / ParametrizaçõesParametrização da Integração e Parametrização De/Para. Descrição do ProcessoProcesso para realizar o reenvio de erros ocorridos na integração. Detalhamento do ProcessoO Registro dos usuários são criados apenas no SGE e ao realizar uma alteração nos dados eles são enviados ao Portal SESI Educação, no modelo síncrono, afim de manter os dados dos dois sistemas sincronizados.
|
Pré-Requisitos / ParametrizaçõesRealizar a parametrização da Integração. Descrição do ProcessoProcesso customizado que realiza a exportação de determinados registros para o Portal SESI Educação. Detalhamento do Processo
Conforme imagem abaixo: |
Uma visão customizada foi criada para que seja possível verificar os dados enviados/recebidos durante as integrações realizadas nos requisitos posteriores.
|
Pré-Requisitos / ParametrizaçõesParametrização da Integração e Parametrização De/Para. Descrição do ProcessoProcesso para realizar o reenvio de erros ocorridos na integração. Detalhamento do ProcessoDurante a exportação dos dados do SGE para o Portal SESI Educação, podem ocorrer erros de validações, por exemplo, impedindo o registro de ser integrado corretamente. Por esse motivo, toda a tentativa de exportação é salva no log customizado para posterior conferência/reenvio.
|
Pré-Requisitos / ParametrizaçõesNenhum. Descrição do ProcessoWebService customizado para realizar a integração dos Usuários. Detalhamento do ProcessoFoi desenvolvido um webservice customizado para realização de alteração de e-mail e senha dos usuários, recebendo como parâmetro o código do usuário, a nova senha e e-mail. O método está disponível para visualização no swagger. Observação: a senha deverá ser informada na codificação Base64, conforme exemplos abaixo: URL com os parâmetros adicionados: http://localhost:8080/rm/api/TOTVSCustomizacao/Usuario/SincronizarUsuario?codUsuario=lucianom&novaSenha=dG90dnM%3D&[email protected] Envio da requisição via Postman: O Método HTTP utilizado é o PUT. Quando a sincronização de usuário for realizada com sucesso, o campo "Sucess" será retornado como "true", e quando ocorrer um erro, será retornado como "false", e o campo "Message" irá detalhar o erro ocorrido, conforme no exemplo abaixo: A Autenticação a ser utilizada é Basic utilizando usuário e senha do RM com devidas permissões para realização das ações:
|
Pré-Requisitos / ParametrizaçõesNenhum. Descrição do ProcessoAuto Login no Portal SGE de forma transparente aos usuários. Detalhamento do ProcessoPara que a transição do Portal SESI Educação para o Portal SGE ocorra de maneira transparente, é preciso que um recurso de auto login esteja disponível, conforme detalhado abaixo:
Essa opção fara com que ao deslogar do Portal SGE o usuário seja direcionado à página inicial do Portal SESI Educação. Segue abaixo exemplo de formulário enviando uma requisição HTTP POST para realizar o login no novo Portal SGE: <form name="controller.formLogin" method="POST" action="http://localhost/Corpore.net/Source/EDU-EDUCACIONAL/Public/EduPortalAlunoLogin.aspx?AutoLoginType=ExternalLogin"> |
|
Pré-Requisitos / ParametrizaçõesRealizar a parametrização da Integração. Descrição do ProcessoForam desenvolvidos entrypoints que serão executados durante alteração de cadastro de aluno e de matrícula, para exportação dos registros para o Portal SESI Educação. Serão exportados dados de professores e funcionários nos momentos de alterações cadastrais ou associação do professor à turma, do funcionário à comissão coordenadora ou direção da filial. Detalhamento do ProcessoQuando o usuário executar algum dos processos abaixo, o processo de integração será executado de forma síncrona, para o(s) registro(s) selecionado(s).
|
Pré-Requisitos / ParametrizaçõesO código das competências (disciplinas) enviadas pelo Web Service deverão corresponder ao código das disciplinas cadastradas no SGE. Este cadastro é feito manualmente pelos usuários que devem ter atenção para que os dados sejam registrados igualmente entre os sistemas. Além disso, é necessário que o aluno esteja com apenas uma Matrícula no Período Letivo com situação de matrícula igual a "Reconhecimento de Saberes". As disciplinas FIC e quaisquer outras que estejam cadastradas com status "Matriculado" não são modificadas.
Descrição do ProcessoO Portal SESI aciona um método customizado capaz de receber dados sobre do aluno e as disciplinas que o aluno já cursou. No momento que o Web Service for acionado a customização identifica para o código do usuário enviado a Matrícula do Período Letivo do aluno com status Reconhecimento de Saberes. O status Reconhecimento de Saberes é determinado pela informação contida no campo Status de Reconhecimento de Saberes dos parâmetros customizados.
Detalhamento do ProcessoO Web Service será acionado pelo Portal SESI para alterar o status das matrículas em disciplinas e matrículas no período letivo para alunos com o status "Reconhecimento de Saberes". Para identificar a Matrícula do Período Letivo do aluno a ser alterada, o processo busca as matriculas em disciplinas com status Reconhecimento de Saberes (parametrizado no Req. 01), ou seja, verifica em qual Matrícula do Período Letivo existe uma competência (disciplina) que esteja com status de Reconhecimento de Saberes.
Ao término do processo de importação dos dados via Web Service a situação de Matrícula no Período Letivo será alterada de Reconhecimento de Saberes para Matriculado de acordo com o que foi definido no campo "Status de Matriculado" dos parâmetros automaticamente. 0 = Competência não reconhecida;
|
Pré-Requisitos / ParametrizaçõesNenhum. Descrição do ProcessoFoi desenvolvido um webservice com a finalidade da troca de senha dos usuários. Detalhamento do ProcessoFoi desenvolvido um webservice customizado que realizará a troca de senha dos usuários, recebendo como parâmetro o código do usuário e a nova senha. O método está disponível para visualização no swagger. Observação: a senha deverá ser informada na codificação Base64, conforme exemplos abaixo: URL com os parâmetros adicionados: http://localhost:8080/rm/api/TOTVSCustomizacao/Usuario/SincronizarSenhaUsuario?codUsuario=lucianom&novaSenha=dG90dnM%3D Envio da requisição via Postman: O Método HTTP utilizado é o PUT. Quando a alteração de senha for realizada com sucesso, o campo "Sucess" será retornado como "true", e quando ocorrer um erro, será retornado como "false", e o campo "Message" irá detalhar o erro ocorrido, conforme no exemplo abaixo: |
Manual disponibilizado pela equipe da Educar Brasil com a relação dos dados a serem configurados para realização do de-para entre o SGE e o Portal SESI. IMPORTANTE: O regional deverá confirmar com a equipe da Educar Brasil se não houve alguma mudança/ atualização nas informações disponibilizadas no manual. |
|
|