...
Informações | |||
---|---|---|---|
| |||
|
...
Informações | |||
---|---|---|---|
| |||
|
...
Informações | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Informações | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Toggle Cloak |
---|
O 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.
A funcionalidade é acionada no SGE a partir da alteração dos dados do usuário no cadastro de Usuários, no "Trocar Senha" da aba ambiente e no trocar senha por meio do Portal SGE. A customização intercepta a alteração, verifica a entidade que pertence o registro e realiza o processo de integração das informações. Ao final, um Log é inserido na tabela customizada informando o status da operação.Observação: Caso ocorra um erro durante a integração, um registro é inserido no Log e o cadastro/alteração de senha do RM ocorre normalmente, sem que qualquer mensagem de erro seja exibida.
AlunoSGE {
A prioridade de envio do código da turma para o Portal SESI sempre é o campo complementar “Turma Sesi Educação”. Apenas quando ele não está preenchido a customização envia o Código da Turma (STURMA.CODTURMA). Detalhamento do ProcessoA exportação de alunos possui a particularidade de exportar não apenas os dados básicos dos alunos, mas também outros dados, como curso (nível de ensino, segmento), turma, turno, série/habilitação (série) – e dados sobre seus responsáveis acadêmicos que estão vinculados ao cadastro do aluno.
Alteração na Integração de Aluno – Integrar somente Matrículas sem Resultado Final e de Períodos Letivos não encerrados A integração de Aluno envia somente alunos com Matrículas (SMATRICPL) que ainda não possuem o Resultado Final (SMATRICPL.CODSTATUSRES) preenchido e que pertençam a Período Letivo (SPLETIVO) que não estão encerrados, desconsiderando os demais. [Novo!] Alteração na Integração de Aluno - Considerar Somente a matrícula mais recente (DTMATRICULA) de turma que já tenham iniciado A Integração de Aluno considera somente a matrícula no Período Letivo mais recente, considerando assim a que tiver a maior Data de Matricula no período Letivo dentre os cursos parametrizados para integrar (em parâmetros Cursos/Segmentos) e que a turma já tenha iniciado (Data Inicial da turma menor ou igual hoje). Identificado a matrícula mais recente do Aluno, são verificadas as demais consistências para esta matrícula, bem como a verificação se a turma desta matrícula está vigente - Considerando como vigente a turma que a data corrente compreender entre a Data Inicial e Final da Turma. [Novo!] Alteração na Integração de Aluno - Desconsiderar matrículas com situação de matrícula indicada para "Não enviar ao Portal SESI" A Integração de Aluno considera somente as matrículas cuja o status não corresponder a uma das situações de matrícula parametrizadas com o checkbox "Não enviar ao Portal SESI" marcado. De modo que se a matrícula mais recente for uma com uma destas situações de matrícula o sistema irá procurar a próxima mais recente para enviar ao Portal SESI.
Importante: Para que o aluno seja exportado o mesmo deve ter um usuário cadastrado no SGE. Importante: Ao instalar a customização no ambiente de produção é necessário executar o processo de geração de usuário selecionando todos os alunos para que os mesmos realizem a troca de senhas ao fazer login no sistema. Pré-Requisitos / Parametrizações
Detalhamento do ProcessoA integração (ou exportação) de professores tem como base os registros de professores geridos pelo cadastro de professor "SGE – Módulo Educacional | Currículo e Oferta | Aluno e Professor | Professores" mantidos nas tabelas SPROFESSOR/PPESSOA (dados do professor e dados pessoais do professor) e, como é necessário exportar as disciplinas dos professores, um relacionamento é realizado através da funcionalidade "Turmas/Disciplinas do professor" (SGE – Módulo Educacional | Ofertas | Turmas/Disciplinas | <anexo> Professores) para recuperar suas disciplinas. Somente são exportados Professores cujas as Turmas pertençam a Períodos Letivos não encerrados.
Para que o professor seja exportado, é necessário validar se:
Pré-Requisitos / Parametrizações
Detalhamento do ProcessoO termo 'funcionários' se refere às pessoas designadas a determinadas funções no SGE – Módulo Educacional (secretários escolares, membros da comissão coordenadora e diretores escolares). Tais registros de 'funcionários' do SGE – Módulo Educacional são pessoas (PPESSOA) associados às funções através dos Menus:
Comissão Coordenadora: Os membros da Comissão coordenadora devem estar cadastrados conforme abaixo: Ao incluir uma pessoa no anexo de Comissão coordenadora, será necessário informar a função dessa pessoa na Comissão. Para esses membros temos as cinco funções:
Diretores e secretários: O cadastro dos Diretores e secretários, serão consultados com base nos dados informados em: SGE - Módulo Fiscal | Filiais | Dados Educacionais | Diretores por Filial. Neste módulo são cadastrados os diretores e secretários.
Pré-Requisitos / ParametrizaçõesRealizar a parametrização da Integração; Para realizar a Inativação de Alunos o Parâmetro "Data Referência" deverá ser preenchido. Detalhamento do ProcessoA Inativação dos usuários de Alunos no Portal SESI Educação ocorre a partir da execução do Processo de Exportação de Inativação de Alunos. Este processo envia os usuários de Alunos a serem inativados no Portal SESI Educação dado o Fim da Vigência da Turma ou Status de resultado final preenchido. - É considerado somente a matrícula em Período Letivo mais recente (ultimo período letivo que tenha turma iniciada) para os Cursos/Segmentos parametrizados; - Não são enviadas inativação referente a matrículas em Filial inativa, sem o Código Integrador preenchido ou que tenha sido realizada antes da "Data Referência" (configurada em parâmetros); O Processo pode ser agendado em ambientes de 3 camadas: Importante: Os alunos que forem enviados para inativação, serão enviados apenas uma vez com sucesso para a matrícula, somente caso ocorra erro na inativação do Aluno que o mesmo será enviado novamente na próxima execução do processo. O Reenvio desta exportação se dá na própria execução do processo, não sendo possível enviar unitariamente. Pré-Requisitos / ParametrizaçõesDiferente da Inativação de Alunos, a Inativação de Funcionários não possui um processo automatizado, necessitando ser feito manualmente pelo usuário. Essa inativação é feita através do gatilho (plugin) existente no cadastro de usuários. Detalhamento do ProcessoA Inativação dos usuários de Funcionários no Portal SESI Educação ocorre a partir da inativação do usuário no cadastro do SGE. Ao acessar o cadastro de um usuário que esteja integrado e ativo no Portal Sesi, desmarcando a flag Ativo será enviado o comando de inativação do usuário ao Portal Sesi Educação. Pré-Requisitos / ParametrizaçõesDa mesma forma que a Inativação de Funcionários, a exclusão de Professores não possui um processo automatizado, necessitando ser feito manualmente pelo usuário. Essa exclusão é feita através do gatilho (plugin) existente no cadastro de usuários. Detalhamento do ProcessoA exclusão dos usuários de Professores no Portal SESI Educação ocorre a partir da inativação do usuário no cadastro do SGE. Para Excluir um professor do Portal SESI, acesse o cadastro do Professor e clique no Usuário, em seguida, desmarque a opção “Ativo” e clique em Salvar para desativar. Logo após, edite alguma informação do cadastro do professor e clique em Salvar para a customização disparar o gatilho para a exclusão do usuário no Portal SESI: Caso o professor que deseja excluir ministrava disciplinas que pertencem a um período letivo que esteja com a opção “Período letivo encerrado” marcada, o gatilho da customização não será disparado e não irá gerar log. |
Informações | |||
---|---|---|---|
| |||
|
Informações | |||
---|---|---|---|
| |||
|
Informações | |||
---|---|---|---|
| |||
|
Informações | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|
Informações | |||
---|---|---|---|
| |||
| |||
Informações | |||
| |||
|
Informações | ||
---|---|---|
| ||
| ||
Informações | ||
|
Toggle Cloak |
---|
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:
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:
Tabela com códigos de erros do WebServiceToken Inválido
01
Usuário não encontrado
02
E-mail inválido
03
Inconsistências DataServer RM
04
Erro desconhecido
05
Erro ao conectar no RM
06
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:
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:
icon | false |
---|
Toggle Cloak |
---|
Foram desenvolvidos entry-points 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.
Quando 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).
icon | false |
---|
Toggle Cloak |
---|
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.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: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.
Código
Status
MAT-C1
1
MAT-C2
0
MAT-C3
1
MAT-C4
1
CNT-C1
0
CHT-C1
1
Informações | |||
---|---|---|---|
| |||
|
|
Informações | |||
---|---|---|---|
| |||
|
Informações | |||
---|---|---|---|
| |||
|
Informações | |||
---|---|---|---|
| |||
| |||
Informações | |||
|
Toggle Cloak |
---|
icon | false |
---|
Toggle Cloak |
---|
Cloak |
---|
Foram exportados alunos matriculados em períodos letivos passados - Verificar se os períodos letivos passados estão encerrados. Não aparece o anexo Instituição do MEC no anexo Dados Educacionais do cadastro de filiais - Configurar os parâmetros do Censo para utilizar a Instituição do MEC por filial conforme a documentação Aluno fica com status Inativo no portal Sesi após exportação pelo SGE - Alterar o status do usuário do aluno para Ativo no SGE e reenviar os dados para portal Sesi. Erro 500 ao testar API de integração - Solicitar ao cliente alterar a tag CustomErros para Off no web.config e reiniciar o site IIS - Realizar uma nova request e verificar a mensagem de erro retornada. - Se houver erro de autenticação verificar se o alias configurado no web.config está correto. - Verificar se a tag owin:AutomaticAppStartup está com o valor "true". Processo da customização apresenta erro de execução sem mensagem de retorno. - Verificar pelo monitor de processos qual é o servidor que está executando o processos. A customização deve estar instalada nesse servidor. Diretor associado a filial não aparece na lista lookup no Cadastro de Perfis do Portal Sesi - O cadastro diretor deve ser realizado através do anexo Dados Educacionais/Instituição do MEC no menu Diretores por instituição disponível no cadastro de Filiais. Caso seja pelo menu Censo do módulo Educacional não será realizada a associação entre pessoa e filial e não listado no lookup. Mensagem - String or Binary Data Would Be Truncated ao exportar aluno - O problema foi corrigido a partir da versão 12.1.32.119 da customização (download no link https://tdn.totvs.com/x/Nv3qK) - Se o banco for SQL Server e estiver na versão 2019 ou superior solicitar ao cliente rodar o seguinte comando na base de dados: DBCC TRACEON(460,-1). Após a execução do comando pelo cliente, realizar o reenvio do registro para integração e analisar o erro com a mensagem retornada. - Verificar se existe bloqueio na rede (firewall) para a acesso o Quick E-Mail Verification (Aba Validação de E-Mail no parâmetros da integração) - Verificar junto com o suporte de CNI se o token de integração para validação de e-mail é válido. Usuário não informado - 601 Autenticação Inválida - Verificar com o pessoal da Educar Brasil se os dados de acesso ao Portal Sesi estão corretos (Usuario, Token, URL) |