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

Versões comparadas

Chave

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

...

Informações
iconfalse

Toggle Cloak
Parametrizações

Cloak

Introdução

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

  1. Endereço de acesso ao webservice de integração, disponibilizado pela Educar Brasil;
  2. Usuário do Portal SESI Educação para o consumo do webservice, disponibilizado pela Educar Brasil;
  3. 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

  1. 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;
  2. 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;
  3. 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;
  4. 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

  1. Utilizado para alterar a situação das disciplinas certificadas no Reconhecimento de Saberes;
  2. Utilizado no Motivo Alteração, ao alterar a situação de matrícula para situação ¹Competência Reconhecida automaticamente pelo processo.
Competência não Reconhecida

  1. Utilizado para alterar a situação das disciplinas reprovadas no Reconhecimento de Saberes;
  2. Utilizado no Motivo Alteraçã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

  1. Utilizado para alterar a situação da Matrícula no Período Letivo ao receber o retorno do Reconhecimento de Saberes;
  2. Utilizado no Motivo Alteraçã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.

false

Aba Validação de Email [Novo!]

  1. Endereço de acesso à API para  consulta de e-mail, disponibilizado pela Educar Brasil;
  2. Token de acesso à API para  consulta de e-mail, disponibilizado pela Educar Brasil.
Informações
iconfalse

Toggle Cloak
Campos Complementares

Cloak
TURMASESIEDUCACAO

A criação do campo

O Campo

complementar TURMASESIEDUCACAO e tabela dinâmica é

criado

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
iconfalse

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
titleObrigatoriedade 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 mensagem Campo 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
titleCadastro 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.

...

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.

O Excel avalia o conteúdo das primeiras linhas para determinar o tipo de dado (http://dougbert.com/blog/post/Importing-from-Excel-IMEX-and-mixed-data-types.aspx  http://support.microsoft.com/kb/194124/EN-US) então é importante que as colunas das planilhas e seus dados estejam com a tipagem de acordo com os definidos nos layouts abaixo.

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 mensagem Campo 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.

Então um De/Para é cadastrado:
Image Removed
Para Habilitação/Série: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:Então um De/Para é cadastrado:
Image Removed

Para Área - Grupo de Complemento: 

Então um De/Para é Cadastrado:

Image Removed

Cloak
Expandir
titleObrigatoriedade e verificação do campo e-mail para Alunos e Professores
Expandir
titleParâmetros de customização integração
Expandir
titleCadastro 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
id1586291586725_-1757961241

Image Removed

Imagem ilustrativa: Os valores corretos devem ser verificados no manual da EducarBrasil

Âncora
DeParaHabilitacaoDeParaHabilitacao

Image Removed

Imagem ilustrativa: Os valores corretos devem ser verificados no manual da EducarBrasil

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.

Image Removed

Imagem ilustrativa: Os valores corretos devem ser verificados no manual da EducarBrasil

Expandir
titleIntegração de alunos (e responsáveis acadêmicos dos alunos)

Pré-Requisitos / Parametrizações


Realizar a parametrização da Integração e parametrização do De/Para CursosHabilitações e Disciplinas
Para envio dos dados do aluno os campos abaixo são de preenchimento obrigatório:

Campo

Localização

Regional

Cadastro de Coligada: GCOLIGADA.ESTADO

Código Integrador

Cadastro de Filial / 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/SegmentosDisciplinas 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.

...