Páginas filhas
  • Manual Operacional - Integração SGE x Portal SESI

Versões comparadas

Chave

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

...

Informações
iconfalse

Toggle Cloak
Integrações


Cloak
false

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

Pré-Requisitos / Parametrizações

  1. Realizar a parametrização da Integração e preenchimento De/Para;
  2. 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

EMAILCaso 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 ComplementarCaso 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

  1. Realizar a parametrização da Integração e preenchimento De/Para;
  2. 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 ComplementarEmail 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

  1. Realizar a parametrização da Integração;
  2. 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.

false

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

Pré-Requisitos / Parametrizações


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

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

...

Informações
iconfalse

Toggle Cloak
FAQ [Novo!]

Cloak
falseForam 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 se o token de integração para validação de e-mail é válido.

Erros de Log - Erro: Responsável não enviado

O responsável acadêmico do aluno menor de 18 anos está sem usuário cadastrado, será necessário gerar o usuário para o responsável acadêmico.

Erros de Log - Erro: CPF do responsável não informado

Falta informar o CPF do responsável acadêmico.

Erros de Log - Erro: CPF inválido

Necessário preencher o campo CPF do aluno.

Erros de Log - Erro: E-mail Complementar inválido

O email do aluno [pessoa.email] é invalido, necessário deixar o campo em branco ou informar um e-mail válido.

Erros de Log - Erro: E-mail Complementar já cadastrado

Verificar no Portal SESI Educação quais usuário estão com o mesmo e-mail cadastrado e proceder com o ajuste do cadastro do e-mail, ou vários alunos e responsáveis com o mesmo e-mail cadastrado.

Erros de Log - Erro: E-mail do responsável não preenchido

Necessário preencher o campo de e-mail do responsável acadêmico.

Erros de Log - Erro: E-mail do responsável não pode ser igual ao e-mail do aluno

O e-mail do aluno e responsáveis devem ser distintos, necessário ajustar os cadastros.

Erros de Log - Erro: E-mail existente

Hipótese 1:  E-mail está sendo utilizado por mais de um usuário no SGE (o caso mais comum é com o e-mail do responsável acadêmico)
 

Passo 1: O interlocutor do SGE deve consultar o e-mail no banco do SGE e verificar a qual usuário de fato o e-mail pertence;

  • Se o usuário (dono do e-mail) estiver sincronizado com o seu e-mail:  

O interlocutor deve corrigir o cadastro do usuário que apresentou erro por estar utilizando um e-mail já existente (deve inserir um e-mail válido e exclusivo para o usuário) e reenviar; 

  • Se o e-mail estiver sendo utilizado por um usuário que está sincronizado, mas que não é o dono do e-mail:  

O interlocutor deve, primeiro, corrigir o cadastro do usuário (retirando o e-mail que pertence a outra pessoa) e reenviar o usuário com o seu e-mail para atualização no Portal SESI.

Em seguida, deve-se reencaminhar o usuário que apresentou o erro “E-mail existente” (uma vez que o seu e-mail não está mais sendo utilizado por outra pessoa).  

  • Usuários do SGE que não estão sendo sincronizados ao Portal SESI, por utilizarem o mesmo e-mail:  

Deve-se alterar os cadastros (com e-mail válido e exclusivo para cada usuário) e reencaminhar estes usuários ao Portal SESI.

  • Se o e-mail não estiver vinculado com mais de um usuário no SGE, seguir a Hipótese 2.

Hipótese 2:  E-mail sendo utilizado por mais de um usuário no Portal SESI (a mensagem “e-mail existente” pode ser que o e-mail já está sendo utilizado por um usuário ativo ou inativo no Portal SESI).

Para essa situação, será necessário realizar a abertura de uma demanda no Suporte do Portal Sesi Educação 

Caso o problema não for resolvido, após as tratativas com o suporte do Portal Sesi, o interlocutor do regional deve marcar em cópia a equipe do SESI/DN (naguiar@naguiar@cni.com.br, [email protected] e [email protected])

Erros de Log - Erro: Nome do responsável não informado

Aluno sem responsável acadêmico cadastrado, necessário incluir no cadastro.

Erros de Log - Erro: Senha do responsável não enviada

Necessário gerar a senha do responsável acadêmico.

Erros de Log - Erro: O e-mail informado para o aluno não é válido ou não está preenchido

E-mail do aluno é invalido.

Erros de Log - Erro: O e-mail informado para o responsável acadêmico não possui uma caixa de e-mail

E-mail do responsável acadêmico é invalido.

Erros de Log - Erro: Desculpe. Ocorreu um erro no consumo do webservice do Portal SESI Educação

Erro: {PortalSesi} - Desculpe. Ocorreu um erro no consumo do webservice do Portal SESI Educação que impediu a integração. ERRO : {0} The remote server returned an error:(404) Not Found. 

Reenviar o registros com erro, caso o erro persista será necessário verificar a disponibilidade e a conectividade do servidores do Totvs RM com os webservice de integração do Portal SESI Educação.