Esta parametrização é realizada por coligada (SESI – Departamento Regional) e nível de ensino do SGE – Módulo Educacional (Educação Básica) e as informações preenchidas são armazenadas em tabela customizada.
Os parâmetros estão agrupados em abas/guias. A seguir apresentamos os parâmetros necessários para a integração e seus significados:
false
Aba Identificação
Habilita Integração Portal SESI Educação
Parâmetro que indica se a integração será realizada ou não
O processo de integração pode estar agendado, mas a integração apenas irá ocorrer se este parâmetro estiver marcado. Tal parâmetro é valido para os registros de Alunos, Responsáveis Acadêmico, Professores, Diretor(es), Secretário(s), Coordenador(es) e Orientador Pedagógico para que seja realizada a integração de usuários para o Portal SESI Educação.
Dados de Integração
Endereço de acesso ao webservice de integração, disponibilizado pela Educar Brasil;
Usuário do Portal SESI Educação para o consumo do webservice, disponibilizado pela Educar Brasil;
Chave de verificação para o consumo do webservice, disponibilizado pela Educar Brasil.
Estando Habilitado a Integração, estes 3 parâmetros são Obrigatórios.
Datas
Utilizar data referência é um parâmetro que habilita o campo Data Referência para que sirva de data de corte, para que somente os dados alterados pela última vez após a data selecionada sejam enviados;
Data da última execução do processo de exportação para entidade de Aluno, esta data servirá de referência para a próxima execução da exportação;
Data da última execução do processo de exportação para entidade de Professor, esta data servirá de referência para a próxima execução da exportação;
Data da última execução do processo de exportação para entidade de Funcionários, esta data servirá de referência para a próxima execução da exportação.
Importante: Caso utilize a data de referência a primeira execução desconsiderará registros criados/alterados antes da data parametrizada. Depois da primeira execução este parâmetro não tem mais utilidade, pois utilizará as datas de última execução.
Importante: Esta parametrização é por Nível de Ensino, portanto, a integração deve ser habilitada para todos os níveis de ensino que a customização deve funcionar.
false
Aba Reconhecimento de Saberes
Token
Este recurso serve para gerar um Token do tipo Basic Authentication, o qual deve ser informado no Portal SESI para utilização da autenticação da comunicação com o SGE
Gerando...
Para gerar o Token deve ser informado o usuário e senha do usuário que será registrado a utilização da integração vinda do Portal SESI Educação.
É importante utilizar um usuário exclusivo.
À Reconhecer
Utilizado para identificar as disciplinas em Reconhecimento de Saberes, que precisam ser reconhecidas pelo Portal SESI Educação.
Competência Reconhecida
Utilizado para alterar a situação das disciplinas certificadas no Reconhecimento de Saberes;
Utilizado no MotivoAlteração, ao alterar a situação de matrícula para situação ¹Competência Reconhecida automaticamente pelo processo.
Competência não Reconhecida
Utilizado para alterar a situação das disciplinas reprovadas no Reconhecimento de Saberes;
Utilizado no MotivoAlteração, ao alterar a situação de matrícula para situação ¹Competência não Reconhecida automaticamente pelo processo.
Matrícula no Período Letivo
Utilizado para alterar a situação da Matrícula no Período Letivo ao receber o retorno do Reconhecimento de Saberes;
Utilizado no MotivoAlteração, ao alterar a situação da Matrícula no Período Letivo automaticamente pelo processo.
false
Aba Cursos (Segmentos)
Um cadastro onde deverá ser relacionado (informado/cadastrado) os cursos do SGE – Módulo Educacional (segmentos de ensino da Educação Básica indicadas no Portal SESI Educação (Educar Brasil)) para os quais somente alunos e professores/disciplinas de tais cursos serão integrados. Junto a informação de cada curso deverá ser sinalizado se o e-mail do aluno (matriculado em tal curso) deverá ser obrigatório e também se alunos menores de 18 (dezoito) anos (matriculado em tal curso) deverão ter um responsável acadêmico informado.
false
Aba Situações de Matrícula
No Portal SESI Educação os registros contêm uma propriedade indicando o status dos registros que poderá ser: Ativo, Inativo ou Excluído. Para a integração de alunos este status será definido de acordo com a situação de matrícula do aluno. Como no SGE – Módulo Educacional as situações de matrículas são a partir de um cadastro (existem situações que não se pode alterar, mas é possível cadastrar novas) então é necessário definir o significado de cada situação de matrícula. Em vista disto, neste módulo de parametrização, há um cadastro onde é possível efetuar o mapeamento entre as diversas situações de matrículas do SGE – Módulo Educacional e o que ela representará para o Portal SESI Educação no momento da integração.
É permitida a seleção da situação de matrícula e do status desta para o Portal SESI Educação podendo marcar uma entre três opções Ativo, Inativo e Excluído. Este mapeamento é realizado para todas as situações de matrícula do SGE – Módulo Educacional.
realizada via script disponibilizado no pacote de instalação.
Esse campo complementar deve fazer uso de uma tabela dinâmica:
Os itens dessa tabela dinâmica devem ser cadastrados conforme regra do cliente e de acordo com o documento disponibilizado pela
EducarBrasil
Educar Brasil.
Este campo deve estar disponível para visualização na turma e deve ser preenchido de acordo com a turma que será identificada pelo professor para publicação de material.
Sistema de Gestão de Oficinas – SGO
No caso da unidade que possuir o sistema de Gestão de Oficinas – SGO, este campo estará disponível para visualização no anexo "Turma SESI Educação" do cadastro de Salas do Oficina e deve ser preenchido de acordo com a turma que será identificada pelo professor para publicação de material.
Importante: O campo deve ser ativado pelo usuário -
...
Informações
icon
false
Toggle Cloak
De | Para
Cloak
O SGE – Módulo Educacional
...
A criação do campo complementar e tabela dinâmica é realizada através de script disponibilizado no pacote de instalação.
...
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, disponibilizamos 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).
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.
Curso/Segmento
Nesta entidade devem ser preenchidos os campos:
"Valor do TOTVS Educacional" onde deve ser selecionado o Curso;
"Valor no Portal SESI Educação" onde deve ser informado o código do curso equivalente no Portal SESI Educação (validar com responsável pelo portal).
Disciplina
Nesta entidade devem ser preenchidos os campos:
"Curso" onde deve ser selecionado o Curso para a disciplina;
"Valor do TOTVS Educacional" onde deve ser selecionada a Disciplina;
"Valor no Portal SESI Educação" onde deve ser informado o código da disciplina equivalente no Portal SESI Educação (validar com responsável pelo portal).
Habilitação/Série
Nesta entidade devem ser preenchidos os campos:
"Curso" onde deve ser selecionado o Curso para a habilitação/serie;
"Valor do TOTVS Educacional" onde deve ser selecionada a Habilitação/Serie;
"Valor no Portal SESI Educação" onde deve ser informado o código da habilitação/serie equivalente no Portal SESI Educação (validar com responsável pelo portal).
Área - Grupo de Complemento
Nesta entidade devem ser preenchidos os campos:
"Curso" onde deve ser selecionado o Curso para "Área - Grupo de Complemento";
"Valor do TOTVS Educacional" onde deve ser selecionada a "Área - Grupo de Complemento";
"Valor no Portal SESI Educação" onde deve ser informado o código da "Área - Grupo de Complemento" equivalente no Portal SESI Educação (validar com responsável pelo portal).
Área Conhecimento
Nesta entidade devem ser preenchidos os campos:
"Curso" onde deve ser selecionado o Curso para a área de conhecimento;
"Valor do TOTVS Educacional" onde deve ser selecionada a Área de Conhecimento;
"Valor no Portal SESI Educação" onde deve ser informado o código da área de conhecimento equivalente no Portal SESI Educação (validar com responsável pelo portal).
Itinerario
Nesta entidade devem ser preenchidos os campos:
"Curso" onde deve ser selecionado o Curso para a disciplina;
"Valor do TOTVS Educacional" onde deve ser selecionada a Disciplina;
"Valor no Portal SESI Educação" onde deve ser informado o código da disciplina equivalente no Portal SESI Educação (validar com responsável pelo portal).
...
Expandir
title
Obrigatoriedade e verificação do campo e-mail para Alunos e Professores
No cadastro de Alunos e Professores do TOTVS Educacional, a customização valida o preenchimento do campo e-mail, tornando esse campo obrigatório ao incluir ou editar um registro, exibindo a mensagemCampo e-mail obrigatório, caso o usuário não preencha o e-mail.
Além da obrigatoriedade do campo e-mail, a customização valida se o e-mail informado no cadastro da pessoa já está associado a outra Pessoa. Se sim, é exibida a seguinte mensagem com os dados de Nome e CPF da pessoa que já está utilizando o e-mail:
“O e-mail informado já está sendo utilizado por:
Nome: Letícia Viana
CPF: 111.111.111-11”
Em ambos os casos, o registro não é salvo.
Expandir
title
Cadastro DE/PARA para integração
Pré-Requisitos / Parametrizações
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 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 Added.
...
Cloak
Observações Importantes
Nas máquinas e/ou servidores com acesso ao RM.exe onde será realizada a importação de e-mails via XLS (a ser realizada uma única vez como processo inicial) torna-se necessário que exista o MS-Office/Ms-Excel instalado, para que seja possível à customização abrir o arquivo e executar a leitura do mesmo durante a importação de planilhas do Excel. Detalhes sobre necessidade do MS-Excel: Para que este método funcione é necessário ter instalado, no computador onde o processo será iniciado (client), os objetos de transferência de dados entre aplicações do office (Microsoft Access Database Engine Redistributable – AccessDatabaseEngine.exe). Normalmente, em computadores que possuem o office instalado, isto já está presente.
Obrigatoriedade e verificação do campo e-mail para Alunos e Professores
No cadastro de Alunos e Professores do TOTVS Educacional, a customização valida o preenchimento do campo e-mail, tornando esse campo obrigatório ao incluir ou editar um registro, exibindo a mensagemCampo e-mail obrigatório, caso o usuário não preencha o e-mail.
Além da obrigatoriedade do campo e-mail, a customização valida se o e-mail informado no cadastro da pessoa já está associado a outra Pessoa. Se sim, é exibida a seguinte mensagem com os dados de Nome e CPF da pessoa que já está utilizando o e-mail:
“O e-mail informado já está sendo utilizado por:
Nome: Letícia Viana
CPF: 111.111.111-11”
Em ambos os casos, o registro não é salvo.
Expandir
title
Parâmetros de customização integração
Expandir
title
Cadastro DE/PARA para integração
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 RemovedAtravé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 Removed.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:
Chart from Table
id
1586291586725_-1757961241
Image Removed
Imagem ilustrativa: Os valores corretos devem ser verificados no manual da EducarBrasil
Então um De/Para é cadastrado: Image Removed
Âncora
DeParaHabilitacao
DeParaHabilitacao
Para Habilitação/Série:
Image Removed
Imagem ilustrativa: Os valores corretos devem ser verificados no manual da EducarBrasil
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 RemovedPara Disciplinas:
Image Removed
Imagem ilustrativa: Os valores corretos devem ser verificados no manual da EducarBrasil
Importante: Para as disciplinas de EJA Pro e Nova EJA e Novo Ensino Médio o cadastro de De-Para deve ser realizado para entidade "Área - Grupo de Complemento" como informado pela tabela do Educar Brasil.
Importante: O valor do código para as disciplinas de Educação Continuada será sempre o mesmo.
Então um De/Para é cadastrado: Image Removed
Para Área - Grupo de Complemento:
Image Removed
Imagem ilustrativa: Os valores corretos devem ser verificados no manual da EducarBrasil
Então um De/Para é Cadastrado:
Image Removed
Expandir
title
Integração de alunos (e responsáveis acadêmicos dos alunos)
Cadastro de Filial / Dados para o MEC: SFILIALMEC.CODINEPESCOLA
Nome
PPESSOA.NOME - Caso o PPESSOA.NOMESOCIAL esteja preenchido ele substitui o nome juntando com o sobrenome da pessoa (PPESSOA.SOBRENOME)
CPF
PPESSOA.CPF
Sexo
PPESSOA.SEXO
Nascimento
PPESSOA.DTNASCIMENTO
Turno
Matriz Aplicada (SHABILITACAOFILIAL.CODTURNO)
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 Código Externo 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
Nota
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).
Descrição do Processo
Funcionalidade no Job de integração para realizar a exportação de Alunos.
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 pertecam a Período Letivo (SPLETIVO) que não estão encerrados, desconsiderando os demais.
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.
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.