Histórico da Página

...

Expandir

title	Parâmetros da Integração

Table Excerpt

name	ParametrosIntegracao

Table Excerpt

name	ParametrosIntegracaoIntro

Além das premissas técnicas, é essencial realizar algumas configurações para garantir o sucesso da integração:

Acesse os Parâmetros através do seguinte caminho:

TOTVS Educacional > Sistema Indústria >Portal SESI> Parâmetros

A interface exibirá sete abas para serem configurados: Identificação, Reconhecimento de Saberes, Cursos (segmentos), Situações de matrícula, Validação de e-mail, Funcionários e Autenticação SSO.

Deck of Cards

history	false
id	Params

Card

label	Identificação

Table Excerpt

name	parametrosidentificacao

Nesta aba, são configurados os campos básicos para o funcionamento da integração.

Habilita Integração Portal SESI Educaçã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 da 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.
Classificação de Municípios (IBGE): Campo com lista de classificação de municípios (DCLASSIFMUNICIPIO), para o usuário selecionar em qual classificação de Município corresponde a do IBGE.
Dias para envio de turma finalizada: Neste campo o usuário deverá informará a quantidade de dias (em números) em que uma turma já finalizada será considerada na exportação.
Utiliza campo complementar Turma SESI Educação: Este campo marcado indica que no processo de exportação de turmas ao Portal SESI Educação, será considerado como código da turma, o valor informado no campo complementar mencionado.
- Caso desmarcado será considerado o valor do campo nativo da turma 'Código da turma' (STURMA.CODTURMA).
- Caso marcado e o campo complementar não estiver preenchido, será considerado o valor do campo nativo da turma 'Código da turma' (STURMA.CODTURMA). Maiores informações no tópico Processo de exportação.

Card

label	Reconhecimento de Saberes

Table Excerpt

name	parametrosrecsabes

Nesta aba, são configurados os campos referentes ao Reconhecimento de Saberes.

Token para WS: 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.

Os demais campos, são para configurar os status e motivos de alteração para indicar quando a situação do aluno for:

Reconhecimento de Saberes: Utilizado para identificar as disciplinas em Reconhecimento de Saberes, que precisam ser reconhecidas pelo Portal SESI Educação.

Competências reconhecidas: Utilizado para alterar a situação das disciplinas certificadas no Reconhecimento de Saberes;
Motivo da alteração: Utilizado no Motivo Alteração, ao alterar a situação de matrícula para situação Competência Reconhecida automaticamente pelo processo.

Competências não reconhecidas: Utilizado para alterar a situação das disciplinas reprovadas no Reconhecimento de Saberes
Motivo da alteração: Utilizado no Motivo Alteração, ao alterar a situação de matrícula para situação Competência não Reconhecida automaticamente pelo processo.

Matricula 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 e para identificação da matrícula em itinerário a ser considerada como Matriculado;
Motivo de alteração: Utilizado no Motivo Alteração, ao alterar a situação da Matrícula no Período Letivo automaticamente pelo processo.

Card

label	Cursos (Segmentos)

Table Excerpt

name	parametroscursos

Nesta aba deverá ser 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.

Cursos (Segmentos).gif

Card

label	Situações de Matrícula

Table Excerpt

name	parametrossitmatric

Para integração dos alunos no Portal SESI, o status do aluno é definido de acordo com sua Situação de Matrícula no SGE.

Nesta aba o usuário deverá informar as situações de matricula no SGE, que o Portal SESI deve considerar como: Pré matriculado, Matriculado ou Inativo.

Ao incluir um novo registro será apresentado 3 campos para preenchimento:

Sit. Matricula: Lista das as situações de matrículas existentes na base.

Status Indica: Status no Portal SESI, da situação de matricula selecionada. Podendo ser Pré matriculado, Matriculado ou Inativo.

Não enviar ao Portal SESI: 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.

Estado

colour	Green
title	Exemplo:

Se a Escola considerar que a situação de matricula "cancelado" do SGE deve ser enviada ao Portal SESI como Inativo, o preenchimento será da seguinte:

Se em determinado momento a Escola determinar que essa situação de matrícula não deve ser considerada na Exportação ao Portal SESI é necessário marcar o checkbox:

Aviso

Se o usuário do aluno estiver Ativo, o processo customizado de exportação ao Porlta SESI busca a informação parametrizada nessa aba, para fazer a relação da situação de matricula do Aluno com status indica, identifcado se será ou não exportado.

Se o usuário do aluno estiver Inativo, o processo customizado já envia para o Portal SESI como Inativo.

Card

label	Validação de e-mail

Table Excerpt

name	parametrosvalidaemail

Essa aba refere-se a configurações para utilização de Consulta/validação de email pela Quickemail.

Os campos apresentados são:

URL API: Endereço de acesso à API para consulta de e-mail, disponibilizado pela Educar Brasil;

TOKEN: Token de acesso à API para consulta de e-mail, disponibilizado pela Educar Brasil.

Intervalo de horas: Este campo será considerado para validar novamente o e-mail na QuickeMail (somente daqueles que não tenham sido considerados "válidos") respeitando o intervalo de horas definido no parâmetro.

Card

label	Funcionários

Table Excerpt

name	parametrosfuncionarios

Na integração de Funcionários ao Portal SESI Educação os registros contêm uma propriedade indicando o perfil do funcionário.

Este cadastro deve ser utilizado para informar o perfil de cada Funcionário, que poderá ser:

Funcionário Administrativo (Perfil padrão do Portal SESI)
Funcionário Pedagógico e
Administrador de Unidade

Neste cadastro devem ser preenchidos os campos conforme a sua funcionalidade:

Código da filial/escola: utilizado para identificar para qual filial se destina o funcionário que terá um perfil diferenciado do padrão. Um funcionário pode estar em mais de uma filial e com perfis diferentes;
Código da Pessoa: mostrando apenas os funcionários a serem levados ao Portal SESI para filial selecionada no campo 1 que ainda não foram parametrizados, deve ser selecionado o funcionário ao qual se quer atribuir um perfil diferenciado para a filial selecionada;
Perfil no Portal SESI Educação: utilizado para identificar qual perfil enviar ao Portal SESI, combo que permite selecionar entre os perfis: Funcionário Administrativo, Funcionário Pedagógico e Administrador de Unidade.

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

Card

label	Autenticação SSO

Table Excerpt

name	parametrossso

Aba destinada à configuração de logins via SSO (Single Sign-On).

Os campos são preenchidos automaticamente após a Importação do Arquivo (config_sesi.json) que é fornecido pelo Portal SESI

Abaixo descrição dos campos para conhecimento:

Endereço WebService: Endereço de acesso ao webservice disponibilizado pelo Portal SESI.
Public Key: chave pública para descriptografar o token JWT.
Client ID: usuáriode acesso ao webservice disponibilizado pelo Portal SESI.
Secret Key: Senhade acesso ao webservice disponibilizado pelo Portal SESI.
Importar arquivo (config_sesi.json): Botão para importação das configurações via arquivo JSON*.

*Arquivo disponibilizado pelo Portal SESI.

Aviso
Esse parâmetro deve ser preenchido exclusivamente via importação do arquivo. Qualquer manipulação manual dos campos, resultará em falhas da funcionalidade.

...

Expandir

title	Processo de Exportação

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:

Alunos (e responsáveis acadêmicos)
Docentes
Funcionários (Diretores escolares, secretários Escolares, orientadores, comissão coordenadores)
Turmas
Matriculas
Aulas Docentes
Oficinas (apenas para o Regional Paraná)

Antes de executar o processo é necessário que o usuário entenda as regras de cada Entidade que será integrada.

Informações

title	Clique na entidade e veja as regras ao lado

Section

border	true

Column

width	30

Toggle Cloak

exclusive	true
id	1

Pré Cadastro de Pessoa

Toggle Cloak

exclusive	true
id	2

Integração de Alunos/responsáveis

Toggle Cloak

exclusive	true
id	3

Integração de Turmas

Toggle Cloak

exclusive	true
id	4

Integração de Matrículas

Toggle Cloak

exclusive	true
id	5

Integração de Docentes

Toggle Cloak

exclusive	true
id	6

Integração de Aulas do Docente

Toggle Cloak

exclusive	true
id	7

Integração de Funcionários

Toggle Cloak

exclusive	true
id	8

Integração de Oficinas

Column

width	70

Cloak

visible	true
id	1

Essa integração antecede o envio de Aluno, Responsável, Docente e Funcionários para o Portal SESI, na intenção de identificar se será aproveitado algum cadastro existente ou criado o pré-cadastro.

Para integração de alunos e responsáveis acadêmicos (para alunos menores de 18 anos), tem como base o cadastro de Pessoa. Sendo assim consideramos:

Campos obrigatórios para integração

Nome
Estado Natal e Naturalidade
Data de nascimento
Sexo
E-mail
Nome da mãe (caso não possua CPF informado)

Campos de envio opcional

CPF
Nome Social
E-mail Complementar (caso o email O365 Esteja preenchido ele será enviado como principal).

Outras validações

Sendo encontrado um registro, o Portal SESI retornará o Iduser* correspondente. *Identificar único da pessoa no Portal SESI.

Cloak

visible	true
id	2

Para integração de alunos e responsáveis acadêmicos (para alunos menores de 18 anos), tem como base o cadastro de Pessoa. Sendo assim consideramos:

Campos obrigatórios para integração

Nome
Estado Natal e Naturalidade
Data de nascimento
Sexo
E-mail
Usuário* (caso o usuário esteja inativo será enviado o comando de inativação ao Portal SESI)
Senha do usuário
Nome da mãe (caso não possua CPF informado)

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

Campos de envio opcional

CPF
Nome Social
E-mail Complementar (caso o email O365 Esteja preenchido ele será enviado como principal)
Raça

Outras validações

E-mail do responsável acadêmico: Será verificado se o responsável acadêmico é também um aluno ou Professor. Caso seja, consultamos se o e-mail do responsável acadêmico (PPESSOA) é o mesmo e-mail do campo complementar a Office 365 (aluno ou professor). Se os e-mails forem idênticos, a validação na Quickemail não será necessária, se forem divergentes, a validação na Quickemail será aplicada respeitando os parâmetros cadastrados.
Notificação de Alerta para E-mail Inválido: Será exibida notificação no cadastro de Aluno, caso seja realizada inclusão ou alteração no e-mail, para validar a sintaxe* do e-mail (*se tem domínio, o @ e ponto caracteres validos) e alertar da importância de um e-mail válido.

Cloak

id	3

Para integração é necessário de as Turmas e Turmas/disciplinas sejam cadastras considerando:

Campos obrigatórios para integração

Para turmas e turmas Disciplinas:

Turno
Data inicial
Data final
Código turma¹

Para o Novo Ensino Médico considerar também:

Itinerário Formativo

Outras validações

Será verificado se o parâmetro 'Utiliza campo complementar Turma SESI Educação' está marcado.
- Este campo marcado indica que no processo de exportação de turmas ao Portal SESI Educação, será considerado como código da turma, o valor informado no campo complementar mencionado.
- Caso desmarcado será considerado o valor do campo nativo da turma 'Código da turma' (STURMA.CODTURMA).
  - RedAtenção Caso o parâmetro esteja marcado o envio do código da turma para o Portal SESI será o campo complementar “Turma Sesi Educação” desde que esteja preenchido. Quando ele não está preenchido a customização envia o Código da Turma (STURMA.CODTURMA).
Campo complementar Enviar ao Portal SESI no cadastro da Turma: Este campo, por padrão estará marcado. Caso seja desmarcado a Turma e seus vínculos não serão considerados na integração com o Portal SESI.

Reenvio de turmas já exportadas

Para as Turmas que já foram enviadas com sucesso para o Portal SESI com o código da Turma, e o Regional necessite reenviar o registro alterando para o envio da informação existente no campo complementar Turma SESI Educação, será necessário:

Alterar/incluir os registros das Turmas para que a integração entenda que o registro sofreu atualização e precisa ser reenviado ao Portal SESI, nesse reenvio serão consideradas as novas regras implementadas neste escopo.
O fato de preencher o campo complementar Turma SESI educação já é uma alteração válida para o reenvio.
Executar o processo de exportação de Turmas.

Cloak

id	4

Serão exportadas as Matriculas dos alunos considerando:

Itens que serão integrados

Alunos já exportados ao Portal SESI e que estejam matriculados com algum dos Status abaixo:

Pré-matrícula: para matrículas no período letivo que estiverem parametrizadas com Situação de Matrícula que o Status Indica estiver preenchido como

Cloak

id	4

Serão exportadas as Matriculas dos alunos considerando:

Itens que serão integrados

Alunos já exportados ao Portal SESI e que estejam matriculados com algum dos Status abaixo:

Pré-matrícula: para matrículas no período letivo que estiverem parametrizadas com Situação de Matrícula que o Status Indica estiver preenchido como “Pré-Matriculado” ou “Matriculado” e a Data corrente é menor que a Data Início da Turma;
Matriculado: para matrículas no período letivo que estiverem parametrizadas com Situação de Matrícula que o Status Indica estiver preenchido como “Matriculado” e não forem identificados como Concluinte ou Pré-Matriculado;
Inativo: para matrículas no período letivo que estiverem parametrizadas com Situação de Matrícula que o Status Indica estiver preenchido como “Inativo”.

Importante:

Passaremos a enviar todas as matrículas elegíveis ao Portal SESI educação e não mais somente a última, porém atualizações serão enviadas somente em caso de alteração de situação de matrícula ou resultado, pois estes são os campos enviados que não fazem parte da chave da matrícula.
Considerando que a situação de matrícula ‘Pré matriculado’, possivelmente são de alunos cuja turma em que está vinculado ainda não foi iniciada, caso o aluno não tenha situação de matrícula considerada “Matriculado”, no Portal SESI o aluno permanecerá Inativo, até que esta “Pré-matrícula” tenha mudado para “Matriculado”.

Outras validações

Campo complementar Enviar ao Portal SESI na Matrícula do Período letivo: Este campo, por padrão estará marcado. Caso seja desmarcado essa matrícula não será considerada na integração com o Portal SESI.
A data de início daturma não é considerada um pré-requisito para exportação. Consideramos a data da entrada da pré-matrícula no SGE (exceto para alunos da EJA).

Cloak

id	5

Para integração de Docentes (Professores), tem como base o cadastro de Pessoa. Sendo assim consideramos:

Campos obrigatórios para integração

Nome
Estado Natal e Naturalidade
Data de nascimento
Sexo
E-mail
Usuário (Ativo)
Senha do usuário
Nome da mãe (caso não possua CPF informado)

Campos de envio opcional

CPF
Nome Social
E-mail Complementar (caso o e-mail O365 Esteja preenchido ele será enviado como principal)
Raça

Cloak

id	6

Para integração de Aulas do Docente, será enviado a relação do Docente com as turmas/disciplinas:

Validações

Professores vinculados a turmas/disciplina, já exportadas.

Verificar as regras de envia das turmas e turmas/disciplinas.

Cloak

id	7

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

Sendo assim, consideramos:

Campos obrigatórios para integração

Nome
Estado Natal e Naturalidade
Data de nascimento
Sexo
E-mail
Usuário* (caso o usuário esteja inativo será enviado o comando de inativação ao Portal SESI)
Senha do usuário
Perfil de funcionário (Cadastrado nos parâmetros)
Nome da mãe (caso não possua CPF informado)

Campos de envio opcional

CPF
Nome Social
E-mail Complementar (caso o email O365 Esteja preenchido ele será enviado como principal)
Raça

Outras validações

Tais registros de 'funcionários' do SGE – Módulo Educacional são pessoas (PPESSOA) associados às funções através dos Menus:

Filial | Dados Educacionais | <anexo> Diretores por Filial
Módulo Educacional | Currículo e Oferta | Estrutura Curricular | Matrizes curriculares | <anexo> Matriz aplicada | <anexo> Comissão Coordenadora'.

Cloak

id	8

A integração das Oficinas será tratada em tópico a parte deste manual.

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

Informações
Esse processo poderá ser agendado conforme recurso nativo. O processo de exportação acontece de formar síncrona. O primeiro envio pode levar mais tempo para ser concluído.

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

title	Atualização de dados

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.

Estado

colour	Green
title	Exemplo:

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

Aviso

title	Reenvio de turmas já exportadas

Considerando a nova regra, onde o campo complementar: Turma SESI Educação, pode ser considerado:

Para as Turmas que já foram enviadas com sucesso para o Portal SESI com o código da Turma (STURMA.CODTURMA), e o Regional necessite reenviar o registro alterando para o envio da informação existente no campo complementar Turma SESI Educação, será necessário:

Alterar/incluir os registros das Turmas para que a integração entenda que o registro sofreu atualização e precisa ser reenviado ao Portal SESI, nesse reenvio serão consideradas as novas regras implementadas neste escopo.
O fato de preencher o campo complementar Turma SESI educação já é uma alteração válida para o reenvio.
Executar o processo de exportação de Turmas.

Expandir

title	Acesso ao Portal SESI via Portal do Aluno

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.

...

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 77

Nova versão 78

Chave

Gerando...