Histórico da Página

Toggle Cloak

Parametrizações

Pré-Requisitos / Parametrizações

O SGE – Módulo Educacional possui valores para as suas tabelas, campos, cadastros, tipos que não condizem com os valores atuais cadastrados no Portal SESI Educação. Como estamos tratando de uma integração é necessário efetuar a troca por valores equivalentes aos do Portal SESI Educação, antes de acionar o serviço que efetiva a integração. 
Em vista desta situação, foi criada uma funcionalidade que permite o mapeamento e equivalência dos valores do SGE – Módulo Educacional para os valores utilizados pelo Portal SESI Educação. A funcionalidade 

'Cadastro de DE/PARA' foi disponibilizada como um cadastro (ao invés de fixo, hardcore) de maneira a permitir que eventuais novos valores possam ser mapeados (criar o relacionamento, equivalência entre os sistemas) e/ou alterados sem a necessidade de novas codificações. 
No SGE – Módulo Educacional, menu customização, disponibilizaremos o Cadastro DE/PARA e neste, o usuário (usualmente o administrador do sistema/integração) irá selecionar o registro (SGE – Módulo Educacional) a que se refere e informar o valor equivalente no sistema destino (Portal SESI Educação).

Detalhamento do Processo

Acesse o SGE – Módulo Educacional, através do menu "Customização / DE/PARA da integração". É exibida uma tela de visão com as opções de inclusão, exclusão e edição.

Image RemovedImage Added

Através desse módulo é possível realizar o cadastro de De/PARA. Ao incluir um novo registro é exibida uma tela contendo os três campos para identificação.

Image RemovedImage Added.

Deve ser selecionado o tipo de Entidade (Cadastro), que pode ser: Curso/Segmento, Disciplina ou Habilitação/Série.

• Curso/Segmento: são exibidos no campo "Valor do SGE – Módulo Educacional" os cursos disponíveis;
• Disciplina: são exibidos no campo "Valor do SGE – Módulo Educacional" as disciplinas disponíveis;
• Habilitação/Série: são exibidos no campo "Valor do SGE – Módulo Educacional" as habilitações disponíveis.
• Área - Grupo de Complemento: são exibidos no campo "Valor do SGE – Módulo Educacional" aos grupos de complemento disponíveis.

No campo "Valor no Portal SESI Educação" deve ser informado o valor a ser enviado quando for executada a integração. 
Exemplo:
No SGE – Módulo Educacional o Nome da Habilitação é "Ferramentas da Qualidade", porém esse código não é válido para o Portal SESI. Neste caso deve informado um valor válido conforme manual do WebService de Integração disponibilizado pela equipe do EducarBrasil. 
Conforme manual de Integração do WebService os valores válidos são:
Para Segmento:

Então um De/Para é cadastrado:
Image RemovedImage Added

ATENÇÃO: O cadastro dos códigos digitáveis devem ser digitados exatamente iguais aos códigos das tabelas de códigos válidos, considerando assim maiúsculas/minúsculas e caracteres especiais.

Então um De/Para é cadastrado:
Image RemovedImage Added

Para Disciplinas:

Então um De/Para é cadastrado:
Image RemovedImage Added

Para Área - Grupo de Complemento: 

Então um De/Para é Cadastrado:

Image RemovedImage Added

Pré-Requisitos / Parametrizações

Realizar a parametrização da Integração.

Dscrição do Processo

Funcionalidade no Job de integração para realizar a exportação de Funcionários. 

Para envio dos dados do funcionário os campos abaixo são de preenchimento obrigatório:

Detalhamento do Processo

O termo 'funcionários' se refere às pessoas designadas a determinadas funções no SGE – Módulo Educacional (secretários escolares, coordenadores, diretores escolares, entre outros). Tais registros de 'funcionários' do SGE – Módulo Educacional são pessoas (PPESSOA) associados às funções através das funcionalidades 'Filial | Dados Educacionais | <anexo> Diretores por Filial e 'SGE – Módulo Educacional | Currículo e Oferta | Estrutura Curricular | Matrizes curriculares | <anexo> Matriz aplicada | <anexo> Comissão Coordenadora'. 

Importante: Para que os "Funcionários" seja exportado o mesmo deve ter um usuário vinculado ao seu cadastro de pessoa no SGE. 
Image Removed
Image Added

A localização de Diretores e secretários serão localizados com base nos dados cadastrados no SGE - Módulo Fiscal | Filiais | Dados Educacionais | Diretores por Filial. Neste módulo são cadastrados os diretores e secretários.Image Removed

Image Added

Os campos obrigatórios, parametrizações e e-mail são validados e, se estiverem corretos, são o enviados para o Portal EducarBrasil, e seu retorno será gravado na tabela de Log.

Pré-Requisitos / Parametrizações

Realizar a parametrização da Integração.

Descrição do Processo

Processo customizado que realiza a exportação de determinados registros para o Portal SESI Educação.

Detalhamento do Processo

Foi criado um processo customizado no SGE – Módulo Educacional para realizar a integração entre o SGE e o Portal SESI Educação. O processo pode ser acionado via menu ou agendado para executar com periodicidade definida.

A interface do processo contém a lista das possíveis entidades a serem integradas dispostas em controles que permitam ao usuário selecionar/marcar quais registros deseja processar/integrar na execução do processo. São elas:

• Alunos (e responsáveis pelos alunos);
• Professores (Docentes);
• Funcionários (Diretores Escolares, Secretários Escolares, Orientadores, Coordenadores);
• Reenvio de dados.

Conforme imagem abaixo:

Image RemovedImage Added

Pré-Requisitos / Parametrizações

Nenhum.

Descrição do Processo

WebService customizado para realizar a integração dos Usuários.

Detalhamento do Processo

Foi 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:

Image RemovedImage Added

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:

Image RemovedImage Added

A Autenticação a ser utilizada é Basic utilizando usuário e senha do RM com devidas permissões para realização das ações:

Image RemovedImage Added

Tabela com códigos de erros do WebService

Pré-Requisitos / Parametrizações

O 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.

Só serão alteradas as informações caso o aluno possua matrícula referente a disciplina, caso contrário não será feita nenhuma alteração e nem gravará nada no log.

Descrição do Processo

O 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.

Em seguida, para cada código de Competência (Disciplina) enviada a customização realizar a alteração do status de matrícula de acordo com a parametrização definida pelo Regional.

Caso ocorra erro na modificação do status de qualquer competência (disciplina) de um Aluno a customização não conclui a alteração do status para todas as demais competências (disciplinas) do Aluno, bem como também não altera a situação de matrícula no período letivo. 
OBSERVAÇÃO: Detalhes técnicos para o correto funcionamento do Web Service podem ser consultados no documento "Manual de Customização RM - WEB API - FS007972".

Detalhamento do Processo

O 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.

Os dados trafegados são:

• Código do Usuário;
• Lista de Competências (disciplinas) informando 0 ou 1 para cada uma delas, sendo que se enviado igual a 1, o status da competência (disciplina) será alterado de acordo com o que foi parametrizado no campo "Status de Competências reconhecidas" na aba Reconhecimento de saberes dos parâmetros customizados. Se enviado igual a 0, o status da competência (disciplina) será alterado de acordo com o que foi parametrizado no campo "Status de Competências não reconhecidas" na aba Reconhecimento de saberes dos parâmetros customizados.
  
  

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. 
Para cada disciplina, deverá ser informado um status correspondente a 1 ou 0.

0 = Competência não reconhecida;
1 = Competência reconhecida.

Exemplo: 
Código de Usuário: 012.345.678
Lista de Competências (disciplinas):

Image RemovedImage Added

Parametros Customizados - Aba Reconhecimento de saberes 
Caso seja executado o processo para o aluno acima e ele esteja matriculado em todas as disciplinas enviadas pelo Web Service, ele ficará com as seguintes situações de matrícula nas disciplinas, considerando as parametrizações do exemplo:

• MAT-C1: Competência Certificada
• MAT-C2: Pré-Matriculado
• MAT-C3: Competência Certificada
• MAT-C4: Competência Certificada
• CNT-C1: Pré-Matriculado
• CHT-C1: Competência Certificada

O log do processo pode ser consultado na tabela ZLOGRECSABERPORTAL.

Pré-Requisitos / Parametrizações

Nenhum.

Descrição do Processo

Foi desenvolvido um webservice com a finalidade da troca de senha dos usuários.

Detalhamento do Processo

Foi 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:

Image RemovedImage Added

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:

Image RemovedImage Added