Manual Operacional da customização - Integração Sapes


O manual a seguir visa detalhar as customizações realizadas neste projeto para realizar a exportação de Alunos para o Sapes.


Pré-requisitos


Descrição do processo


Detalhamento do processo


Pré-requisitos

O objetivo desse processo é detalhar a Exportação de dados do SGE para o Sapes, os dados necessários de matrículas dos alunos que estão concluindo determinado curso, para disponibilização da Pesquisa de Egresso do SENAI.

Descrição do processo

A interface customizada estará disponível em: TOTVS Educacional | Sistema Industria | Integração Sapes| Exportação de Dados.

O processo poderá ser executado a qualquer momento pelo usuário, na data do processamento ou agendado conforme recurso nativo de agendamento de job.

Detalhamento do processo

Clique em Exportação de Dados



A Exportação de Dados para o Sapes será realizada apenas para os alunos que estiverem matriculados nas turmas/disciplinas das modalidades parametrizadas na (Aba Modalidades de Cursos), e quando atingir o número de dias anteriores à data final, da última matrícula do aluno na turma/disciplina que tiver a maior data final (STURMADISC.DTFINAL), do último Período do Curso, na Análise Curricular, conforme definido no parâmetro Qtde Dias – Envio Conclusão (Disciplina) informados, para cada Modalidade de Curso. Esta informação irá definir quantos dias antes da conclusão será enviada a Pesquisa de Egresso para o Sapes, com a lista de dados das matrículas dos alunos.

Além da regra acima, as seguintes validações serão respeitadas: 

  • Serão selecionados alunos com situação de matrícula diferente de 1 e 19 - Pré-Matriculado para alunos matriculados em cursos com período único (turmas.periodocurso = 1); 
  • Motivo de falta de CPF (SALUNOCOMPL.MOTIVOCPF) igual a '03' ou '04' . 
  • Código do Período Letivo não iniciado com a sigla FE, que identifica os antigos períodos letivos do Fase Empresa. 
  • Situação de matrícula das disciplinas: a customização terá que atualizar a Análise Curricular, para identificar a situação de matrícula do aluno na disciplina do último Período do Curso. Serão selecionados apenas alunos com situação de matrícula igual a Matriculado, alunos com status diferente de matriculado significa que está pendente ou concluiu a disciplina e não será enviado. Para o envio dos dados ao Sapes, a customização irá consumir o método do Webservice parametrizado, sendo enviadas informações do aluno, da unidade, do curso e da modalidade. 


Para o envio dos dados ao Sapes, a customização irá consumir o método do Webservice parametrizado, sendo enviadas informações do aluno, da unidade, do curso e da modalidade.

Após verificação pelo ID, caso o aluno já exista no Sapes, seu registro será atualizado. Caso contrário será inserido um novo registro. Após processamento, o Sapes retornará à informação se o registro foi processado com sucesso ou erro, informando a mensagem em caso de erro. Ao final do processamento, os registros serão gravados em tabela customizada de log, com dados como: data da criação, usuário responsável, dados enviados, dados recebidos, mensagem de erro e status do registro na integração.

Importante:

  • Será necessário realização de De|Para de forma fixa no código para as informações de Cor/Raça, Tipo de Deficiência e Status da Situação de matrícula. Não será realizado nenhum cadastro de De|Para para essas ou outras informações;
  • As informações serão extraídas de cadastros nativos do SGE, não sendo criado nenhum novo cadastro e/ou campo;
  • Os dados serão exportados do SGE para o Sapes, onde a pesquisa de egresso será realizada.

Pré-requisitos

O objetivo desse processo é detalhar a Exportação de dados do SGE para o Sapes, os dados necessários de matrículas dos alunos que estão concluindo determinado curso, para disponibilização da Pesquisa de Egresso do SENAI, por turma.

Descrição do processo

O menu utilizado ficará disponível em: TOTVS Educacional| Currículo e Oferta | Turma | Processos| Exportar Dados para o Sapes, para ser executado de forma manual pelo usuário.

Detalhamento do processo

Ao clicar no processo, será exibida tela com a lista de aluno da turma selecionada, para que o usuário selecione todos ou apenas os desejados. O processo enviará ao Sapes uma lista de dados das matrículas dos alunos selecionados que atenderem aos requisitos pré-definidos. Se ocorrer alguma atualização dos dados após o envio, o processo irá identificar a modificação e enviar a atualização para o SAPES.


Ao Final do processo será exibida na tela, 

Pré-requisitos

Não se aplica.

Descrição do processo

O objetivo da Interface de Log é armazenar informações e status dos dados que foram exportados do SGE para o Sapes.

Detalhamento do processo

Será possível acompanhar os status dos dados de matrículas dos alunos enviados para o Sapes. Nesta interface será possível identificar os status dos alunos integrados. Não será permitida a inclusão, alteração ou exclusão de registros nesta interface. Os dados exibidos nesta interface ficam armazenados na tabela customizada ZDOCSIGNMONITOR. Os históricos das exportações de dados para o Moodle serão registrados e poderão ser visualizadas no menu TOTVS Educacional | Sistema Indústria | Integração Sapes| Monitor de Log.



Na tela de log estarão disponíveis os seguintes campos: 

  •  Id Log: Identificador sequencial de Log.
  •  Campos Chave: Descrição dos campos utilizados para gerar o registro integrado. 
  •  Valores Chave: Chave primária do registro integrado. 
  •  Status: Situação da Integração (Sucesso ou Erro). 
  •  Funcionalidade: Tipo de Processo que está sendo feito (Por exemplo: Exportação de Dados). 
  •  Módulo: Tipo da integração que está sendo feita.
  •  Data de Criação: Data de Criação do registro. 
  •  Data da última alteração: Data da última alteração do registro.

Ao acessar o anexo de um registro será possível o usuário visualizar todos os registros relacionados ao cadastro integrado selecionando a opção Item de Log. Estarão disponíveis os seguintes campos:

  • Id. Item Log: Identificador sequencial de log; 
  • Id. Log: Identificador sequencial de log;
  • Mensagem: Mensagem com o status da integração do item; 
  • Status: Situação da integração do item selecionado;
  • Dados Enviados: Relação dos dados enviados para integração;
  • Dados Recebidos: Relação dos dados recebidos;
  • Data de Criação: Data de criação do registro;
  • Data da última Alteração: Data da última alteração do registro.


Pré-requisitos

Possuir registros enviados com erro.

Descrição do processo

O objetivo do processo de reenvio de dados é permitir o envio para o Sapes dos registros que não foram exportados corretamente. Esse processo poderá ser executado manualmente ou poderá ser agendado, por registro (com status de cancelado, erro ou pendente) e a integração efetuará a exportação dos registros novamente.

Detalhamento do processo

O Reenvio de Dados, que ao ser acionado a customização tentará realizar novamente o envio das informações ao Sapes. A funcionalidade estará disponível na tela de Monitor de Logs, menu TOTVS Educacional | Sistema Indústria | Integração Sapes| Monitor de Log | Processos | Reenvio de Log.

Neste exemplo abaixo o envio apresentou o status de erro;

Selecione o erro que desejo reenviar,clicar em processos, reenvio de log;