...
...
Objetivo
Este documento foi elaborado para informar aos usuários chave da área Educacional do SESI, sobre a Integração SGE x Portal SESI . A integração com o TOTVS Educacional Portal SESI é responsável pela exportação dos registrossincronização de algumas entidades, facilitando assim a gestão e acesso aos participantes (alunos, professores, funcionários)..
Público Alvo
Este manual é destinado aos colaboradores selecionados como usuários chave do SESI.
...
Este material tem como base a visão prática e completa do Processo Customizado processo customizado da área Educacional através da Integração Portal SESI.
A metodologia utilizada tem como ponto de partida o mapeamento completo do respectivo processo, relacionado com as interfaces no Sistema TOTVS Educacional. Sempre que houver alguma atividade a ser realizada no Sistema, as suas funcionalidades e rotinas serão explicadas com detalhe.
Expandir | ||
---|---|---|
| ||
Para utilização da Integração com o Portal SESI Educação é necessário observar alguns pontos:
|
Expandir | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Informações | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Toggle Cloak |
---|
Esta parametrização é realizada por coligada (SESI – Departamento Regional) e somente para o nível de ensino do SGE – Módulo Educacional Educação Básica (Ensino Básico) 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:
falseAba IdentificaçãoHabilita Integração Portal SESI EducaçãoParâ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çãoEstando Habilitado a Integração, estes 3 parâmetros são Obrigatórios.
DatasImportante: 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 é utilizado somente para o envio das inativações de alunos, e para os demais 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 SaberesTokenEste 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
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.
À ReconhecerUtilizado para identificar as disciplinas em Reconhecimento de Saberes, que precisam ser reconhecidas pelo Portal SESI Educação.
Competência ReconhecidaUm 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ículaNo 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.
[Novo!]
Se o checkbox "Não enviar ao Portal SESI" estiver marcado as matrículas com tal situação serão desprezadas para a integração.
Importante : Se o usuário do aluno estiver Ativo, o processo customizado irá pegar a informação do DE/PARA da situação de matrícula na parametrização do Portal SESI.Se o usuário do aluno estiver Inativo, o processo customizado já envia para o Portal SESI como Excluído.
false Aba Validação de Email [Novo!]Na integração de Funcionários ao Portal SESI Educação os registros contêm uma propriedade indicando o perfil do funcionário, por padrão é enviado o perfil "FUNCIONARIO" que equivale ao Funcionário Administrativo do Portal SESI Educação. Caso o perfil do Funcionário não deva ser Funcionário Administrativo, deve ser utilizado este cadastro para selecionar outro perfil [Funcionário Pedagógico e Administrador de Unidade].
Em vista disto, neste cadastro devem ser preenchidos os campos conforme a sua funcionalidade:
Somente os funcionários cuja o perfil padrão (Funcionário Administrativo) não atenda as necessidades da Unidade que devem ser parametrizados neste cadastro.
icon | false |
---|
Toggle Cloak |
---|
A criação do campo complementar TURMASESIEDUCACAO e tabela dinâmica é realizada via script disponibilizado no pacote de instalação.
Esse campo complementar deve fazer uso de uma tabela dinâmica: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.
Validações[Novo!]
Ao salvar um novo cadastro de Turma, são realizadas as seguintes validações:
Somente são validadas turmas que pertençam a Cursos parametrizados (parâmetro Curso/Segmento) e quando a integração estiver habilitada.
Importante: O campo deve ser ativado pelo usuário -icon | false |
---|
Toggle Cloak |
---|
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, 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:
|
Expandir | ||||
---|---|---|---|---|
| ||||
O SGE possui valores para as suas tabelas, campos, cadastros, tipos que divergem com os valores atuais cadastrados no Portal SESI Educação. Além das parametrizações descritas acima, é Para a integração é necessário ter valores equivalentes aos do Portal SESI Educação, antes de acionar o serviço que efetiva a integração. O Cadastro está disponível no Menu: TOTVS Educacional | Sistema Industria | Integradores | Portal SESI | DE/PARA da integração A tela de cadastro do DE I PARA é composta por 4 campos que devem ser preenchidos seguindo a ordem: 1- Entidade (Cadastro): Lista com 6 entidades que devem ter equivalências com o Portal SESI informada. Sendo elas:
2- Curso: Lista com todos os cursos cadastrados na base.
3- Valor no TOTVS Educacional: Lista da Entidade e Curso selecionado anteriormente. (No exemplo acima, foi selecionado a Entidade: Disciplina e o Curso: EF II, neste caso o valor no TOTVS Educacional trará todas as disciplinas do EF II). 4- Valor no Portal SESI Educação: Onde deve ser informado o código equivalente no Portal SESI Educação (validar com responsável pelo portal).
|
Expandir | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Após as configurações descritas acima, o usuário poderá executar o processo de Exportação. A exportação de dados é responsável pelo envio das seguintes Entidades:
Antes de executar o processo é necessário que o usuário entenda as regras de cada Entidade que será integrada.
Conhecendo a regra de cada Entidade que será exportada. O usuário poderá executar o processo de Exportação através do Menu: TOTVS Educacional | Sistema Industria | Integradores | Portal SESI | Exportação de Entidades
Executando manualmente o processo o usuário poderá selecionar uma ou mais entidades. O resultado da exportação é registrado no Monitor de log da integração, descrito no próximo tópico deste manual. |
Expandir | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Após a exportação dos dados, cada exportação gera um determinado registro de Log. O Monitor de Log, possibilita uma visão dos dados que foram enviados e o retorno de cada exportação. Ele estará disponível no Menu: TOTVS Educacional | Sistema Industria | Integradores | Portal SESI | DE/PARA da integração Ao acessar a tela é apresentado todos os Registros da Exportação. Para facilitar o entendimento vamos apresenta-lo por Funcionalidade. Cada Funcionalidade integrada, traz as informações de Log: No anexo Item de log, é possível visualizar com mais detalhes os dados exportados: Na tela do anexo temos acesso a:
Caso seja apresentado algum erro na exportação, é possível identificar qual regra foi violada, a partir da mensagem apresentada: No exemplo acima, o Pré cadastro de pessoa nao foi exportado porque o "O campo Email não é um endereço de email válido." Nesta situação, o usuário poderá corrigir o campo e realizar o reenvio desse log, através do Processo: Reenvio de dados: |
Expandir | ||||||
---|---|---|---|---|---|---|
| ||||||
Os dados referentes a alunos, docentes e funcionários estão sujeitos a modificações após a exportação inicial. Quando essas alterações ocorrerem, ao realizar o processo de exportação novamente, a customização enviará ao Portal SESI apenas os campos que foram modificados. Vale ressaltar que os campos que foram alterados não serão exportados novamente.
Aluno na criação (Method =POST) não tinha registro de nome social. Atualizando o cadastro do aluno com a inclusão do nome social e realizado a exportação novamente, foi enviada a atualização (Method = PUT) com o nome social cadastrado (JULIO):
|
Expandir | ||
---|---|---|
| ||
Foi incluído no Portal do aluno, um menu para que ele acesse o Portal SESI. Quando os alunos clicarem nesse link, eles serão direcionados automaticamente para o Portal SESI, onde serão autenticados automaticamente, sem a necessidade de inserir suas informações de login novamente. |
Expandir | ||
---|---|---|
| ||
Também foi incluído no Portal do professor, um menu para que ele acesse o Portal SESI. Quando os professores clicarem nesse link, eles serão direcionados automaticamente para o Portal SESI, onde serão autenticados automaticamente, sem a necessidade de inserir suas informações de login novamente. |
Expandir | ||
---|---|---|
| ||
Sempre que houver a necessidade de Inativação de um docente no Portal SESI, o usuário deverá seguir o processo para inativação, conforme descrito abaixo:
Os registros desse processo são gravados no Monitor de log. |
Expandir | ||
---|---|---|
| ||
O processo para Inativação de usuários - Portal SESI, possibilita inativação por completo do usuário no Portal SESI. O processo estará disponível no Menu: TOTVS Educacional | Sistema Industria | Integradores | Portal SESI: Ao ser acionado o processo apresentará na tela um lookup com a lista de usuários já integrados como Ativo no Portal SESI, para que o usuário selecione o que será inativado. É permita a seleção de apenas um usuário por vez. Atenção a mensagem exibida na tela: “ATENÇÃO: Certifique-se que o usuário selecionado esteja correto. Ao executar o processo, o mesmo será inativado por completo no Portal SESI.” Ao final da execução será exibido o log com o número de registros afetados, informando o sucesso da operação. Esse registro ficará gravado no Log Integração Portal SESI Educação. Esse processo gera duas ações:
2. Na próxima exportação de dados, o usuário será atualizado e enviado ao Portal SESI com o comando de inativação. |
Expandir | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||
|
Expandir | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Informações | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Toggle Cloak |
---|
Ao salvar um novo cadastro de Turma, são realizadas as seguintes validações:
Somente são validadas turmas que pertençam a Cursos parametrizados (parâmetro Curso/Segmento) e quando a integração estiver habilitada.
falseEmail de Aluno e Responsável AcadêmicoAo enviar o Aluno ao Portal SESI Educação, são realizadas as seguintes validações:
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.
icon | false |
---|
Toggle Cloak |
---|
Cloak | ||||
---|---|---|---|---|
falseAlunos (e seus respectivos responsáveis acadêmicos)Pré-Requisitos / Parametrizações
AlunoSGE { Nome | Campo Origem Observações | |||
Identificador SGE | AlunoSGE.idred | "7" | Enviado de forma fixa o valor '7' | |
Regional | AlunoSGE.regional | GCOLIGADA.ESTADO | Estado do cadastro da Coligada | |
Código Integrador | AlunoSGE.inep | DFILIAL.CAMPOLIVRE1 | Cadastro de Filial: DFILIAL.CAMPOLIVRE1 | |
Código Integrador | AlunoSGE.codigointegrador | DFILIAL.CAMPOLIVRE1 | Cadastro de Filial: DFILIAL.CAMPOLIVRE1 | |
Curso | AlunoSGE.curso|string | SCURSO.CODCURSO | De/Para de Curso correspondente ao Campo caso o AlunoSGE.segmento seja 17 ou 18 | |
Perfil | AlunoSGE.perfil | "ESTUDANTE" | Enviado de forma fixa o valor 'ESTUDANTE' | |
Nome | AlunoSGE.nome | PPESSOA.NOME | PPESSOA.NOMESOCIAL + PPESSOA.SOBRENOME | Nome do Aluno - Caso o PPESSOA.NOMESOCIAL esteja preenchido ele substitui o nome juntando com o sobrenome da pessoa (PPESSOA.SOBRENOME) | |
Código Externo | AlunoSGE.codigoexterno | PPESSOA.CODUSUARIO | Código do Usuário do Aluno | |
Senha do Usuário | AlunoSGE.user_sen | Senha do Usuário | Senha do Usuário do Aluno | |
Sexo | AlunoSGE.sexo | PPESSOA.SEXO | Correspondendo à 'feminino' | 'masculino' | |
Data de Nascimento | AlunoSGE.nasc | PPESSOA.DTNASCIMENTO | Data de nascimento do Aluno | |
Turno | AlunoSGE.turno | SHABILITACAOFILIAL.CODTURNO | Correspondendo à 'Manhã' | 'Noite' | 'Tarde' | 'Integral' | |
Segmento | AlunoSGE.segmento | SHABILITACAOFILIAL.CODCURSO | De/Para de Segmento correspondente ao Campo | |
Série | AlunoSGE.serie | SHABILITACAOFILIAL.CODHABILITACAO | De/Para de Serie correspondente ao Campo | |
Turma | AlunoSGE.turma | STURMA.CODTURMA | STURMACOMPL.TURMASESIEDUCACAO | A prioridade é do campo TURMASESIEDUCACAO quando preenchido | |
Nome do Responsável | AlunoSGE.respon_nome | PPESSOA.NOME | Nome do Responsável Acadêmico | |
CPF do Responsável | AlunoSGE.respon_cpf | PPESSOA.CPF | CPF do Responsável Acadêmico | |
E-mail do Responsável | AlunoSGE.respon_email | PPESSOA.EMAIL | E-mail do Responsável Acadêmico | |
Código do Usuário do Responsável | AlunoSGE.respon_ra | PPESSOA.CODUSUARIO | Código do Usuário do Responsável Acadêmico | |
Senha do Usuário | AlunoSGE.respon_sen | Senha do Usuário | Senha do Usuário do Responsável Acadêmico | |
Status | AlunoSGE.status | SMATRICPL.CODSTATUS | Caso o GUSUARIO.STATUS for ativo, identificamos de acordo com os parâmetros de Situação de Matrícula correspondendo à Ativo | Inativo | Excluído Senão enviamos Excluído | |
CPF do Aluno | AlunoSGE.cpf | PPESSOA.CPF | CPF do Aluno | |
E-mail do Aluno | AlunoSGE.email | PPESSOA.EMAIL | Caso o e-mail O365 (SALUNOCOMPL.EMAILO365) esteja preenchido este é enviado como principal, do contrário o e-mail do cadastro de pessoa (PPESSOA.EMAIL) do aluno é enviado. | |
E-mail complementar do Aluno | AlunoSGE.emailcomplementar | SALUNOCOMPL.EMAILO365 | 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. | |
Área do Itinerário | AlunoItinerario.area | SHABILITACAOFILIAL.CODCURSO | Caso o aluno esteja matriculado em um Itinerário: De/Para de Área correspondente ao Campo | |
Itinerário | AlunoItinerario.itinerario | SMATRICPLITINERARIOFORMATIVO.CODITINERARIOFORMATIVO | Caso o aluno esteja matriculado em um Itinerário: De/Para de Itinerário correspondente ao Campo | |
Nome | Campo | Origem | Observações | |
Identificador SGE | DocenteSGE.idred | "7" | Enviado de forma fixa o valor '7' | |
Regional | DocenteSGE.regional | GCOLIGADA.ESTADO | Estado do cadastro da Coligada | |
Código Integrador | DocenteSGE.inep | DFILIAL.CAMPOLIVRE1 | Cadastro de Filial: DFILIAL.CAMPOLIVRE1 | |
Código Integrador | DocenteSGE.codigointegrador | DFILIAL.CAMPOLIVRE1 | Cadastro de Filial: DFILIAL.CAMPOLIVRE1 | |
Perfil | DocenteSGE.perfil | "ESTUDANTE" | Enviado de forma fixa o valor 'DOCENTE' | |
Nome | DocenteSGE.nome | PPESSOA.NOME | Nome do Professor | |
Código Externo | DocenteSGE.codigoexterno | PPESSOA.CODUSUARIO | Código do Usuário do Professor | |
Senha do Usuário | DocenteSGE.user_sen | Senha do Usuário | Senha do Usuário do Professor | |
Sexo | DocenteSGE.sexo | PPESSOA.SEXO | Correspondendo à 'feminino' | 'masculino' | |
Data de Nascimento | DocenteSGE.nasc | PPESSOA.DTNASCIMENTO | Data de nascimento do Professor | |
Status | DocenteSGE.status | SMATRICPL.CODSTATUS | Caso o GUSUARIO.STATUS for ativo, enviamos Ativo Senão enviamos Excluído | |
CPF do Professor | DocenteSGE.cpf | PPESSOA.CPF | CPF do Professor | E-mail do Professor | DocenteSGE.email | PPESSOA.EMAIL |
Caso o e-mail O365 (SPROFESSORCOMPL.EMAILO365) esteja preenchido este é enviado como principal, do contrário o e-mail do cadastro de pessoa (PPESSOA.EMAIL) do professor é enviado. Quando Funcionário: E-mail |
do |
cadastro de pessoa (PPESSOA.EMAIL) do |
Funcionário é enviado |
. |
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:
Turno
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.falseFuncionários (Diretor, Secretários, Orientador Pedagógico e Coordenadores)FuncionarioSGE {
idred (string, obrigatório),
regional (string, obrigatório),
inep (string, obrigatório),
codigointegrador (string, opcional),
perfil (string, obrigatório),
codigoexterno (string, obrigatório),
cpf (string, opcional),
nome (string, obrigatório),
email (string, obrigatório),
sexo (string, obrigatório),
nasc (DateTime, obrigatório),
status (string, obrigatório),
user_sen (string, opcional)
}
Nome
Campo
Origem
Observações
Identificador SGE
FuncionarioSGE.idred
"7"
Enviado de forma fixa o valor '7'
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).
Caso o GUSUARIO.STATUS for ativo, enviamos Ativo
Senão enviamos Excluído
O 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.
Realizar a parametrização da Integração;
Para realizar a Inativação de Alunos o Parâmetro "Data Referência" deverá ser preenchido.
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.
falseInativação de Funcionários [Novo!]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.
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, desmarcando a flag Ativo será enviado o comando de inativação do usuário ao Portal Sesi Educação.
falseExclusão de Professores [Novo!]Da 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.
A 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.
icon | false |
---|
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.icon | false |
---|
Toggle Cloak |
---|
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:Conforme imagem abaixo:
falseReenvioDurante 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.icon | false |
---|
Toggle 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.
Para informações sobre Alteração Status Logs com Erro e o processo de Exclusão de Logs no monitor, acesse o Manual Operacional da Customização - LIB DN
icon | false |
---|
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 | |||
---|---|---|---|
| |||
|
|
HTML | ||
---|---|---|
<style>
.expand-control {
cursor: pointer;
text-decoration: none;
margin-bottom: 10px;
background-color: #ededed;
height: 30px;
font-size: 14px;
padding: 5px;
}
.expand-control-text {
vertical-align: top;
font-weight: bold;
color: #242424;
}
.post {
background-color: #378000;
color: #ffffff;
display: inline-block;
padding: 5px;
border-radius: 5px;
font-weight: bold;
}
.get {
background-color: #004fd6;
color: #ffffff;
display: inline-block;
padding: 5px;
border-radius: 5px;
font-weight: bold;
}
.put {
background-color: #ffa200;
color: #ffffff;
display: inline-block;
padding: 5px;
border-radius: 5px;
font-weight: bold;
}
.delete {
background-color: #cf0000;
color: #ffffff;
display: inline-block;
padding: 5px;
border-radius: 5px;
font-weight: bold;
}
.endereco{
display: inline-block;
padding: 5px;
font-weight: bold;
}
</style>
<!--
EXEMPLO DE MARCAÇÃO PARA TIPO DE REQUEST:
<div class="post">POST</div>
<div class="get">GET</div>
<div class="put">PUT</div>
<div class="delete">DELETE</div>
O ENDEREÇO DEVE SER INSERIDO COM A SEGUINTE MARCAÇÃO:
<div class="endereco">/rm/api/TOTVSCustomizacao/CstIntegracaoProtheus/ItemContabil</div>
--> | ||
Expandir | ||
| ||
Expandir | ||
|
Dica | ||
---|---|---|
| ||
Dias para envio da Turma/Oficina Finalizada: 30 Data corrente de execução do processo: 10/01/2024 Data calculada: 10/01/2024 - 30: 11/12/2023 (desconsidera as finalizadas até essa data) Oficina ABC - Data início: 01/10/2023 e Data fim: 02/12/2023 - Não enviada Oficina 321 - Data início: 01/12/2023 e Data fim: 11/12/2023 - Enviada Oficina DEF - Data início: 01/01/2024 e Data fim: 30/03/2024 - Enviada |
Ao ocorrer qualquer alteração nos dados das oficinas enviadas ou inclusão/exclusão de professores vinculados à sala oficina, os dados atualizados serão enviados ao Portal SESI ao rodar o processo de exportação novamente.
Expandir | ||
---|---|---|
| ||
Os dados das oficinas na matrícula serão enviados para o Portal SESI quando o processo de exportação for executado ou quando uma matrícula em oficina for efetuada.
O processo atual de envio de matrículas do SGE para o Portal SESI será modificado para incluir informações das oficinas. Quando uma matrícula é enviada e contém informações de matrícula em oficina, essas informações serão enviadas na mesma requisição. A API de Matrícula atual será ajustada pelo Portal SESI para considerar uma nova lista chamada "Oficinas", permitindo o envio desses dados pelo SGE. Se não houver oficinas vinculadas, o processo de envio de matrícula continuará enviando apenas os dados da matrícula do aluno, conforme o fluxo padrão da integração do Portal SESI. Durante o ano, um aluno pode estar vinculado a mais de uma oficina, portanto, todas as oficinas associadas à matrícula do aluno devem ser informadas ao Portal SESI. Sempre que ocorrer uma matrícula no Portal Oficina, o processo será acionado para atualizar as informações da matrícula do aluno com todas as oficinas associadas. Serão consideradas apenas as oficinas do tipo Formação Geral e Básica e Interseriado. |
icon | false |
---|
Toggle Cloak |
---|
icon | false |
---|
Toggle Cloak |
---|
Verificar se os períodos letivos passados estão encerrados.
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.
Alterar o status do usuário do aluno para Ativo no SGE e reenviar os dados para portal Sesi.
Solicitar ao cliente alterar a tag CustomErros para Off no web.config (FrameHTML) 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 (FrameHTML) está correto.
Verificar se a tag owin:AutomaticAppStartup está com o valor "true".
Verificar pelo monitor de processos qual é o servidor que está executando o processos. A customização deve estar instalada nesse servidor.
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.
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)
Verificar com o pessoal da Educar Brasil se os dados de acesso ao Portal Sesi estão corretos (Usuario, Token, URL)
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.
Verificar junto com o suporte de CNI ou Educar Brasil se o token de integração para validação de e-mail é válido.
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);
Verificar se o usuário a ser exportado possui e-mail válido
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.
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.
Falta informar o CPF do responsável acadêmico.
Necessário preencher o campo CPF do aluno.
O email do aluno [pessoa.email] é invalido, necessário deixar o campo em branco ou informar um e-mail válido.
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.
Necessário preencher o campo de e-mail do responsável acadêmico.
O e-mail do aluno e responsáveis devem ser distintos, necessário ajustar os cadastros.
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])
Aluno sem responsável acadêmico cadastrado, necessário incluir no cadastro.
Necessário gerar a senha do responsável acadêmico.
E-mail do aluno é invalido.
E-mail do responsável acadêmico é invalido.
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.