Histórico da Página

...

Informações

icon	false

Toggle Cloak

Validações Cadastrais [Novo!]

Cloak

false

Caracteres especiais Turma SESI Educação

Ao salvar um novo cadastro de Turma, são realizadas as seguintes validações:

Caso o campo complementar TURMASESIEDUCACAO não esteja preenchido é validado caracteres especiais no código da turma;

Tendo preenchido o campo complementar TURMASESIEDUCACAO é validado para caracteres especiais no código ou descrição da Turma SESI preenchido.

Quando existir log de integração do SGE x Portal SESI Educação no "Monitor de Log", identificando que já fora realizado alguma integração, o campo complementar TURMASESIEDUCACAO ficará bloqueado para edição.

Somente são validadas turmas que pertençam a Cursos parametrizados (parâmetro Curso/Segmento) e quando a integração estiver habilitada.

false

Email de Aluno e Responsável Acadêmico

Ao enviar o Aluno ao Portal SESI Educação, são realizadas as seguintes validações:

Validação de email do Aluno (quando aluno não possui o email O365 (SALUNOCOMPL.EMAILO365 preenchido), utilizando serviço de validação de email, que deve ser parametrizado junto aos parâmetros da customização;
Validação de email do Responsável Acadêmico (quando preenchido), utilizando serviço de validação de email, que deve ser parametrizado junto aos parâmetros da customização.

Importante: Em caso de novo envio ao Portal SESI com email já tendo sido validado e não tenha sido alterado, é utilizado o ultimo resultado da validação.

Informações

icon	false

icon

Toggle Cloak

Integrações

Cloak

false

Alunos (e seus respectivos responsáveis acadêmicos)

Pré-Requisitos / Parametrizações

Realizar a parametrização da Integração e preenchimento De/Para;
Para envio dos dados do aluno os campos abaixo são de preenchimento obrigatório:

Campo	Localização
Regional	Cadastro de Coligada: GCOLIGADA.ESTADO
Código Integrador	Cadastro de Filial: DFILIAL.CAMPOLIVRE1
Nome	PPESSOA.NOME - Caso o PPESSOA.NOMESOCIAL esteja preenchido ele substitui o nome juntando com o sobrenome da pessoa (PPESSOA.SOBRENOME)
CPF	PPESSOA.CPF
EMAIL	Caso o email O365 (SALUNOCOMPL.EMAILO365) esteja preenchido este é enviado como principal, do contrário o email do cadastro de pessoa (PPESSOA.EMAIL) do aluno é enviado. *[Alterado!]*
EMAIL Complementar	Caso o email O365 (SALUNOCOMPL.EMAILO365) esteja preenchido o email do cadastro de pessoa (PPESSOA.EMAIL) do aluno é enviado como email complementar, do contrário nenhum email é enviado como complementar. *[Alterado!]*
Sexo	PPESSOA.SEXO
Nascimento	PPESSOA.DTNASCIMENTO
Turno	Matriz Aplicada (SHABILITACAOFILIAL.CODTURNO)
Curso [Novo!]	Área Itinerário (SCURSO.CODCURSO \| DEPARAAREAITINERARIO.CODIGOPORTAL) Itinerário (SITINERARIOFORMATIVOGRADE.CODITINERARIOFORMATIVO \| DEPARAITINERARIO.CODIGOPORTAL) como item único no formato JSON conforme a seguir: {"area":"1","itinerario":"1"}
Segmento	De/Para de Segmento (de/para com o campo CODCURSO da Matriz Aplicada SHABILITACAOFILIAL)
Série	De/Para de Série (Habilitação) (de/para com o campo CODHABILITACAO da Matriz)
Turma	Turma da Matrícula no período letivo (SMATRICPL.CODTURMA => STURMACOMPL.TURMASESIEDUCACAO)
Senha	Obrigatória na inclusão
Status	Parâmetros de situação de matrícula
Responsável,campos: Nome Email Senha	Caso o aluno seja menor de 18 anos e o segmento exija deve ser enviado. SALUNO.CODPESSOARACA => PPESSOA.NOME SALUNO.CODPESSOARACA => PPESSOA.EMAIL SALUNO.CODPESSOARACA => PPESSOA.SENHA Obrigatória na inclusão

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 (SMATRICPL.CODTURMA).

Detalhamento do Processo

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

Para que todos os dados possam ser integrados corretamente, é preciso realizar a parametrização do De/Para para cada um dos Cursos/Segmentos, Disciplinas e Séries/Habilitações, além de preencher em cada turma o campo complementar, conforme detalhado abaixo:

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.

Premissas para o valor da turma do aluno a ser integrada

O valor da turma a ser integrado do SGE – Módulo Educacional para o Portal SESI Educação é dado através do uso de tabela dinâmica X campo complementar na turma então é necessário a criação de uma tabela dinâmica que conterá os identificadores de turmas e um campo complementar na turma para indicar qual o valor a ser enviado à integração.

Importante: Para que o aluno seja exportado o mesmo deve ter um usuário cadastrado no SGE.

Checklist do Aluno

1

incomplete

O Curso da Matrícula do Aluno está parametrizado nos Cursos/Segmentos?

2

incomplete

A Matrícula verificada é a mais recente? - Somente a matrícula mais recente em curso parametrizado é considerada para a integração.

3

incomplete

O Aluno está ativo e possui cadastro de usuário? - O Usuário é necessário para a integração.

4

incomplete

Desde a configuração da integração a senha do aluno já foi alterada ao menos uma vez? - É necessário para que a integração registre o usuário na tabela ZUSUARIOSGE

5

incomplete

A turma está vigente? - Considerando como vigente a turma que a data corrente compreender entre a Data Inicial e Final da Turma.

6

incomplete

O Período Letivo não está encerrado? - Períodos letivos encerrados não são enviados.

7

incomplete

O Aluno não tem Situação de Resultado Final? - Somente alunos sem resultado são enviados.

8

incomplete

O campo Obrigatório "CodInepInstituição" está preenchido? (Campo "CAMPOLIVRE1" do Anexo Dados Fiscais do cadastro de Filial não preenchido)

9

incomplete

A Situação de Matrícula está parametrizada? - Parâmetro utilizado para definir o status correspondente que será enviado ao Portal SESI Educação.

10

incomplete

O Email do Aluno está preenchido? - Obrigatório para integração.

11

incomplete

Caso seja menor de 18 anos, o seu responsável acadêmico está preenchido? - E neste caso o usuário do responsável também deve estar presente na ZUSUARIOSGE, pois se torna obrigatório para a integração.

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.

false

Professores (e suas aulas)

Pré-Requisitos / Parametrizações

Realizar a parametrização da Integração e preenchimento De/Para;
Para envio dos dados do professor os campos abaixo são de preenchimento obrigatório:

Campo	Localização
Regional	Cadastro de Coligada: GCOLIGADA.ESTADO
Código Integrador	Cadastro de Filial / Dados Adicionais: DFILIAL.CAMPOLIVRE1
Nome	PPESSOA.NOME
Código Externo	PPESSOA.CODUSUARIO
Sexo	PPESSOA.SEXO
Nascimento	PPESSOA.DTNASCIMENTO
Email	PPESSOA.EMAIL
EMAIL Complementar	Email O365 (SPROFESSORCOMPL.EMAILO365).
CPF	PPESSOA.CPF
Senha	Obrigatória na inclusão
Aulas [Novo!]	Turma do professor (SMATRICPL.CODTURMA \| STURMACOMPL.TURMASESIEDUCACAO), Curso da turma (SHABILITACAOFILIAL.CODCURSO \| ZDEPARASEG.CODIGOPORTAL), Série da Turma (SHABILITACAOFILIAL.CODHABILITACAO \| ZDEPARASERIE.CODIGOPORTAL), Turno da Turma (STURNO.TIPO \| (Manhã;Tarde;Noite;Integral)), Área - Grupo de Complemento (SDISCGRADE.IDGRUPOCOMPLEMENTO \| ZDEPARAAREA.CODIGOPORTAL), Disciplina/Componente (SDISCIPLINA.CODDISC \| ZDEPARADISC.CODIGOPORTAL) como lista no formato JSON conforme a seguir: [{"turma":"A","segmento":"14","serie":"1","turno":"Tarde","area":"1","componente":"22"},{"turma":"A","segmento":"14","area":null,"componente":"33"},{"turma":"A","segmento":"14","serie":"1","turno":"Manhã","area":"1","componente":"4"}] Somente serão enviadas aulas de professores que atenderem aos critérios: Estar vinculadas à uma turma que esteja com os campos data inicial e data final preenchidos (STURMA.DTINICIAL e STURMA.DTFINAL) e dentro do período vigente; Estar vinculadas à uma Turma/Disciplina que esteja com os campos data inicial e data final do período do professor preenchidos (SPROFESSORTURMA.DTINICIO e SPROFESSORTURMA.DTFINAL) e dentro do período vigente; Caso as datas de início e fim das Turmas e/ou período do professor na Turma/Disciplina, estejam em branco ou fora do período de vigência, não terão suas disciplinas exportadas.

Detalhamento do Processo

A 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 a exportação ser efetivada é preciso realizar a parametrização da tabela De/Para, parametrizando obrigatoriamente os Cursos e Disciplinas vinculados ao cadastro dos professores.

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

Caso ocorra algum erro durante a integração, este será gravado em log. Após alteração do registro do professor, para realizar nova integração deverá ser selecionado o log referente ao professor e executado o processo de reenvio de erro.

Importante: Para que o professor seja exportado o mesmo deve ter um usuário cadastrado no SGE e estar dando aula em alguma Turma/Disciplina que tenha sido informado no cadastro De/Para para disciplinas.

false

Funcionários (Diretor, Secretários, Orientador Pedagógico e Coordenador)

Pré-Requisitos / Parametrizações

Realizar a parametrização da Integração;
Para envio dos dados do funcionário os campos abaixo são de preenchimento obrigatório:

Campo	Localização
Regional	Cadastro de Coligada: GCOLIGADA.ESTADO
Inep	Cadastro de Filial : DFILIAL.CAMPOLIVRE1
Nome	PPESSOA.NOME
Código Externo	PPESSOA.CODUSUARIO
Sexo	PPESSOA.SEXO
Nascimento	PPESSOA.DTNASCIMENTO
Email	PPESSOA.EMAIL
CPF	PPESSOA.CPF
Senha	Obrigatória na inclusão
Perfil [Novo!]	Caso preenchido, é enviado o perfil parametrizado nos parâmetros de Funcionários (na parametrização da Integração Portal SESI Educação). Os Funcionários que não parametrizados são enviados com o perfil padrão (Funcionário Administrativo).

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.

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.

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

false

Inativação de Alunos [Novo!]

Pré-Requisitos / Parametrizações

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

Importante

Para realizar a Inativação de Alunos o Parâmetro "Data Referência" deverá ser preenchido.

Detalhamento do Processo

A 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;
- O Final da Vigência da turma é identificado quando a Data Corrente é maior que a Data Fim da Turma;
- Tendo sido preenchido qualquer Situação na Situação de Resultado Final da Matrícula no Período Letivo o Aluno também é considerado para inativação;
- São enviados somente os Alunos cujo a Data Matrícula mais recente tenha sido realizada após a "Data Referência" (configurada em parâmetros);

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

Informações

cloak

false

Toggle Cloak

Alteração de senha do usuário

Inativação de Funcionários [Novo!]

Pré-Requisitos / Parametrizações

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

Importante
Diferente 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 que ao alterar os dados envia para o Portal Sesi Educação

Detalhamento do Processo

O Registro

A Inativação 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.

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, alterando a flag Ativo será enviado um comando de inativação do usuário ao Portal Sesi Educação.

Informações

icon

Informações

icon	false

Toggle Cloak

Processo Alteração de Exportaçãosenha do usuário

Cloak

Pré-Requisitos / Parametrizações

Realizar a parametrização da Integração e preenchimento De/Para;

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:

falseReenvio

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.

Informações

icon	false

Toggle Cloak

Processo de Exportação

Cloak

Pré-Requisitos / Parametrizações

Realizar a parametrização da

Integração e

Integração e preenchimento De/Para;

Detalhamento do Processo

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

Os registros que foram exportados e geraram erros podem ser reprocessados através do mesmo processo de integração utilizado para integrar as demais entidades. Tal processamento é disparado através do processo de integração ao se marcar a opção 'Reenvio de dados' e acionar a execução do processo (imediato ou agendamento). Outra forma é selecionar o(s) registro(s) individualmente na tela customizada de Log e executar o processo customizado que foi adicionado a ela.Uma nova tentativa de envio é realizada, passando por todos os procedimentos e validações detalhados nos requisitos anteriores. Ao final, os registros da tabela de Log serão atualizados com o novo status e parâmetros enviados/recebidos.

Informações

icon	false

Toggle Cloak

Monitor de Log

Cloak

Uma visão customizada foi criada para que seja possível verificar os dados enviados durante as integrações realizadas. Para cada registro exportado, foi criado um Log nessa tabela contendo os parâmetros utilizados, a entidade integrada.

Observação: Todos os dados são apenas para visualização, não sendo possível a alteração, edição ou exclusão de registros do Log através dessa interface.

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:

false

Reenvio

Pré-Requisitos / Parametrizações

Realizar a parametrização da Integração e preenchimento De/Para;

Detalhamento do Processo

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

Os registros que foram exportados e geraram erros podem ser reprocessados através do mesmo processo de integração utilizado para integrar as demais entidades. Tal processamento é disparado através do processo de integração ao se marcar a opção 'Reenvio de dados' e acionar a execução do processo (imediato ou agendamento). Outra forma é selecionar o(s) registro(s) individualmente na tela customizada de Log e executar o processo customizado que foi adicionado a ela.

Uma nova tentativa de envio é realizada, passando por todos os procedimentos e validações detalhados nos requisitos anteriores. Ao final, os registros da tabela de Log serão atualizados com o novo status e parâmetros enviados/recebidos.

Informações

icon	false

Toggle Cloak

Monitor de Log

Cloak

Uma visão customizada foi criada para que seja possível verificar os dados enviados durante as integrações realizadas. Para cada registro exportado, foi criado um Log nessa tabela contendo os parâmetros utilizados, a entidade integrada.

Observação: Todos os dados são apenas para visualização, não sendo possível a alteração, edição ou exclusão de registros do Log através dessa interface.

Informações

icon	false

Toggle Cloak

Web APIs

Cloak
false Integração de Usuários Foi desenvolvido um webservice customizado para realização de alteração de e-mail e

Informações

icon	false

Toggle Cloak

Web APIs

falseIntegração de SenhaFoi 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 e e-mail. O método está disponível para visualização no swagger.

Observação:

a

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

SincronizarUsuario?codUsuario=lucianom&novaSenha=dG90dnM%3D&[email protected]

Envio da requisição via Postman:

O Método HTTP utilizado é o PUT. Quando a

alteração

sincronização de

senha

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 WebService

Cloak
falseIntegração de Usuários 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 WebService
Token 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

Token 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

false

Integração de Senha

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:

Informações

icon	false

Toggle Cloak

Integração síncrona - Gatilhos

Cloak

Pré-Requisitos / Parametrizações

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

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.

Detalhamento do Processo

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

Currículo e Oferta | Aluno | <processo> Matricular aluno;
Currículo e Oferta | Aluno | <anexo> Matriculas no Período letivo

Informações

icon	false

Toggle Cloak

Integração síncrona - Gatilhos

Cloak

Pré-Requisitos / Parametrizações

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

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.

Detalhamento do Processo

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

Currículo e Oferta | Aluno | <processo> Matricular aluno;
Currículo e Oferta | Aluno | <anexo> Matriculas no Período letivo | <processo> Alterar situação de matrícula;
Currículo e Oferta | Aluno | <anexo> Matriculas no Período letivo | <processo> Matricular aluno nas disciplinas;
Currículo e Oferta | Aluno | <anexo> Matriculas isolada | <processo> > Alterar situação de matrícula;
Matrícula e Avaliação | Matrículas | <anexo> Matrículas em disciplinas | <processo> Alterar situação de matrícula;
Matrícula e Avaliação | Matrículas | <anexo> Matrículas em turma mista | <processo> Alterar situação de matrícula;
Matrícula e Avaliação | Matrícula | Matrículas | <processo> Alterar situação de matrícula;Matrícula
Currículo e Avaliação Oferta | Aluno | <anexo> Matriculas no Período letivo | <processo> Matricular aluno nas disciplinas;
Currículo e Oferta | Aluno | <anexo> Matriculas isolada | <processo> > Alterar situação de matrícula;
Matrícula e Avaliação | Matrículas | <anexo> Matrículas em disciplinas | <processo> Alterar situação de matrícula;
Matrícula e Avaliação | Matrículas | <anexo> Matrículas em turma mista | <processo> Alterar situação de matrícula;
Matrícula e Avaliação | Matrícula | Matrículas | <processo> Alterar situação de matrícula;
Matrícula e Avaliação | Matrícula | Matrículas | <processo> Matrícula | Matrículas | <processo> Matricular aluno nas disciplinas;
Matrícula e Avaliação | Matrícula | Matrículas | <processo> Confirmação de matrícula por pagamento;
Matrícula e Avaliação | Matrícula | Matrícula isolada | <processo> Alterar situação de matrícula;
Matrícula e Avaliação | Matrícula | <processo> Rematrícula;
Matrícula e Avaliação | Matrícula | Mais | <processo> Confirmação de matrícula por pagamento;
Matrícula e Avaliação | Matrícula | Mais | <processo> Matricula de disciplinas em lote;
Matrícula on-line;
Cadastro de pessoas;
Cadastro do aluno;
Cadastro de matrículas;
Estrutura Curricula | Matriz Curricular | Matriz Aplicada | Comissão Coordenadora;
Cadastro de Filial | Dados Educacionais | Diretores por Filial;
Currículo e Oferta | Professores;
Currículo e Oferta | Oferta | Turma Disciplina | Professores.

Serão integrados apenas os registros cujo curso/segmento, do contexto do processo e/ou do aluno que se está alterando, seja um dos parametrizados para a integração e apenas os registros cuja situação de matrícula, do contexto do processo e/ou do aluno que se está alterando, seja um dos parametrizados em "situações de matrícula" para a integração.

As rotinas de envio, antes de acionar as rotinas de integração, conterão tratamentos de validação do campo e-mail e responsável acadêmico:

A obrigatoriedade de preenchimento do campo e-mail deverá respeitar a parametrização realizada observando o curso/segmento do aluno que se está processando (exemplos: curso onde o aluno está se matriculando/confirmando matrícula, ou quando alteração do cadastro de aluno, o curso onde está matriculado);

Obrigatoriedade de responsável acadêmico para menores de 18 anos de acordo com a parametrização por curso/segmento relativo ao curso/segmento do contexto de execução do processo e/ou do curso/segmento relativo ao aluno que se está alterando.

Após as consistências mencionadas acima, as rotinas do plug-in se encarregarão de identificar a chave primária dos registros que estão sendo processados/alterados (no caso de processos pode ser mais de um aluno ao mesmo tempo) e acionar as rotinas de integração fornecendo a estas tais chaves primárias.

As regras da integração de alunos (recuperação de valores, mapeamento de campos, validações, etc.) são as mesmas detalhadas na integração de alunos. Neste caso elas receberão as chaves primárias dos alunos e a recuperação dos dados e integração ocorrerá apenas para os alunos representados por estas chaves. A integração com o Portal SESI Educação ocorrerá e seus retornos de(sucesso ou falha).

Após o processamento das integrações, com o retorno em mãos, é avaliado os status de retorno para cada registro (aluno) e montará uma mensagem a ser gravada na tabela de LOG com as informações de aluno, status da integração e, em caso de erros, a mensagem de erro.

Caso ocorra algum erro na integração o processo nativo não será interrompido, porém o erro da integração constará em log, nesse caso não será realizada a integração do SGE com o Portal SESI Educação.

Para exportação dos dados Funcionários e Professores, serão exportados apenas os cadastros que possuírem usuário associado e que atendam as regras de validação de campos obrigatórios.

Informações

icon	false

Toggle Cloak

Reconhecimento de Saberes

Cloak

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.
É 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):

Código	Status
MAT-C1	1
MAT-C2	0
MAT-C3	1
MAT-C4	1
CNT-C1	0
CHT-C1	1

Parâmetros 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.

Informações

icon	false

Toggle Cloak

De/Para Portal SESI Educação

Cloak
false O Portal SESI Educação disponibiliza uma documentação Online para facilitar a identificação das Entidades a serem parametrizadas no De/Para. Para acessar, clique aqui.

: Competência Certificada

O log do processo pode ser consultado na tabela ZLOGRECSABERPORTAL.

Informações

icon	false

Toggle Cloak

De/Para Portal SESI Educação

Cloak
false O Portal SESI Educação disponibiliza uma documentação Online para facilitar a identificação das Entidades a serem parametrizadas no De/Para. Para acessar, clique aqui.

Informações

icon	false

Toggle Cloak

Extra

Cloak
false O Portal SESI Educação utiliza do Web Service de Consultas da Lib DN, onde é possível realizar execução de consultas TOTVS via Web API. A Documentação deste serviço pode ser acessada

Informações

icon	false

Toggle Cloak

FAQ [Novo!]

Cloak

false

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. Para maiores detalhes consulte a documentação desse procedimento no TDN.

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)

Verificar junto com o suporte de CNI ou Educar Brasil se o token de integração para validação de e-mail é válido.

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)

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)

Ao fazer login no Portal do Aluno no ambiente de homologação o usuário é redirecionado para o ambiente de produção

Alterar as referencias ao portal do aluno nas configuração dos módulo educacional (SGE) de homologação. Para maiores detalhes consulte a documentação desse procedimento no TDN.

Erro na validação de email. Motivo: Not found

Verificar junto com o suporte de CNI ou Educar Brasil se o token de integração para validação de e-mail é válido.

E-mail já utilizado

Verifique se o email cadastrado é um email válido.

Deve-se verificar se o e-mail informado já está sendo utilizado por outro usuário no SGE e/ou Portal SESI (é premissa que o e-mail seja de uso pessoal);

E-mail não preenchido

Verificar se o usuário a ser exportado possui e-mail válido

Erros de Log - Erro na validação de email. Motivo: Low credit. Payment required

Erro: [INTEDUCARBRASIL] Erro na validação de email. Motivo: Payment required{"success":"false","message":"Low credit. Payment required"

Verificar junto com o suporte de CNI

Informações

icon	false

Toggle Cloak

Extra

CloakfalseO Portal SESI Educação utiliza do Web Service de Consultas da Lib DN, onde é possível realizar execução de consultas TOTVS via Web API. A Documentação deste serviço pode ser acessada Informações

icon	false

Toggle Cloak