O SESI adota como diretriz para a gestão escolar a solução SGE (Totvs) e o complementa com o Portal SESI Educação (EducarBrasil) portal de apoio voltado ao ensino que está em consonância com as diretrizes definidas pelo Ministério da Educação que permite ao usuário uma navegação fácil, rápida e intuitiva.

Foi identificada pelo SESI a necessidade de integrar alguns módulos da solução SGE com o Portal SESI Educação, facilitando assim a gestão e acesso aos participantes (alunos, professores, funcionários).
Para atender tal demanda, foram desenvolvidas rotinas customizadas que utilizam de Webservices disponibilizados por ambos os sistemas para possibilitar a comunicação e a integração dos dados.

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.

• *_Office 2007: http://www.microsoft.com/en-us/download/details.aspx?id=23734_*
• Office 2010: http://www.microsoft.com/en-us/download/details.aspx?id=13255

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

Pré-Requisitos / Parametrizações

Nenhum.

Descrição do Processo

Foi desenvolvida uma parametrização para configurar os dados da integração SGE – Módulo Educacional (Totvs) e Portal SESI Educação (EducarBrasil).

Detalhamento do Processo

No SGE – Módulo Educacional, por meio do menu customização, foi criada uma interface customizada por onde o usuário administrador poderá efetuar a parametrização da integração. 
Esta parametrização será 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 pelo usuário 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: 
Aba Identificação

• Integração habilitada: parâmetro do tipo caixa de marcação (checkBox) e 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; 
ATENÇÃO: Esse parâmetro deve estar desmarcado para a execução do processo de carga inicial. Após isso ele deve ser marcado para possibilitar a integração síncrona.

• Dados de acesso ao webservice disponibilizado pela EducarBrasil:

• Caminho do WebService: parâmetro do tipo texto onde deve ser informado o endereço de acesso ao webservice de integração disponibilizado pela EducarBrasil;

• Usuário: parâmetro do tipo texto e onde deve ser informado o usuário do Portal SESI Educação (EducarBrasil) para o consumo do webservice;

• Token: parâmetro do tipo texto que representa uma chave de verificação para o consumo do webservice;

• Utilizar data referência/corte: parâmetro do tipo caixa de marcação (checkBox) e representa um indicativo se a integração, na recuperação dos registros, utilizará uma data mínima como referência, isto é, apenas registros incluídos/alterados após tal data serão considerados na integração.

Caso tal parâmetro não seja marcado então todos os registros da entidade serão considerados na integração;

• Data referência: parâmetro que aceitará apenas valores do tipo data e onde deve ser informado com data de referência (ou de corte) a ser utilizada para recuperação dos registros a serem considerados no processo de integração. Apenas registros incluídos/alterados cuja data seja igual ou posterior a tal data serão processados.

Este parâmetro estará/será habilitado apenas se o parâmetro "Utilizar data referência" estiver marcado.
Caso o parâmetro "Utilizar data referência" estiver marcado então este campo será obrigatório;

• Data da última execução do processo (data da última integração): As integrações podem ser realizadas por cadastros separadamente, então apresentaremos, apenas para visualização (somente leitura), as datas em que ocorreu a última integração de acordo com o cadastro.

Caso o parâmetro "Integração habilitada" esteja marcado (integração ativa) então os parâmetros "Caminho do WebService", "Usuário" e "Token" são de preenchimento obrigatórios. 

Aba Reconhecimentos de Saberes 
Os seguintes parâmetros serão utilizados nos processos de alteração de matrícula. Essa parametrização deve ser realizada por nível de ensino.

• Token para WS: Este parâmetro será utilizado para uma autenticação que será realizada com um Web Service.

• Status de reconhecimento de saberes: Este parâmetro será utilizado para identificar as disciplinas em Reconhecimento de Saberes. Colocar o status de matricula igual a "Reconhecimento de Saberes".

• Status de competências reconhecidas: Este parâmetro será utilizado para alterar as disciplinas certificadas no Reconhecimento de Saberes. Colocar o status de matricula igual a "Competência certificada".

• Motivo de alteração situação de matrícula na competência reconhecida: Neste parâmetro deverá ser informado o motivo a ser utilizado ao alterar a situação de matrícula para aprovado automaticamente pelo processo.

• Status de competência não reconhecidas: Este parâmetro será utilizado para alterar as disciplinas reprovadas no Reconhecimento de Saberes. Colocar o status de matricula igual a "Pre-Matricula".

• Motivo de alteração situação de matrícula de competência não reconhecida: neste parâmetro deverá ser informado o motivo a ser utilizado para alterar a situação de matrícula para Pré-Matriculado automaticamente pelo processo.

• Status de matrícula no período letivo: este parâmetro será utilizado para alterar o status da Matrícula no Período Letivo. Colocar o status de matricula igual a "Matriculado".

• Motivo de alteração de situação de matriculado no período letivo: será o motivo para alterar a situação de matrícula automaticamente pelo processo.

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.

Aba Situações de matrículas 
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, disponibilizamos 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. 
O usuário selecionará/informará a situação de matrícula e marcará o status desta para o Portal SESI Educação podendo marcar uma entre três opções Ativo, Inativo e Excluído. Este mapeamento deverá ser realizado para todas as situações de matrícula do SGE – Módulo Educacional.

Observação: Todas as Situações de Matrícula parametrizadas no SGE – Módulo Educacional com permissão de acesso ao Portal SGE Educacional, devem ser configuradas como "Ativo". 

Além dos cadastros da tela de parametrização, será necessário ativar o Campo Complementar TURMASESIEDUCACAO no cadastro de turmas a ser preenchido via tabela dinâmica TURMASSESI. 

A criação do campo complementar e tabela dinâmica é realizada através de script disponibilizado no pacote de instalação.

Campo complementar de Turma:
Nome da Coluna: TURMASESIEDUCACAO


Esse campo complementar deverá fazer uso de uma tabela dinâmica: 

Os itens dessa tabela dinâmica deverão ser cadastrados conforme regra do cliente de acordo com o documento disponibilizado pela EducarBrasil. 

Este campo deverá 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.

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.

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 necessário criar 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. Esta funcionalidade será denominada 'Cadastro de DE/PARA' e está sendo 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 o valor equivalente no sistema destino (Portal SESI Educação).

Descrição do Processo

Os cadastros que necessitam de uma DE/PARA são: 'Segmento/Nível de Ensino' do Portal SESI Educação, que no SGE – Módulo Educacional é interpretado como 'Curso', e o cadastro de 'Disciplinas'. 
A interface de edição contará com os seguintes controles:

• Um controle do tipo "lista para seleção" para permitir a seleção de a qual cadastro (Segmento/Curso ou Disciplina ou Série) se referem os valores;
• Um campo do tipo 'seleção a partir de uma lista dinâmica' para permitir a seleção do valor no SGE – Módulo Educacional, será o valor do campo DE (origem);
• Um campo alfanumérico para digitação do valor equivalente no Portal SESI Educação, será o valor do campo PARA (destino).

A consistência deste cadastro será a obrigatoriedade de preenchimento dos três campos.

Detalhamento do Processo

Usuário acessa o SGE – Módulo Educacional, através do menu "Customização / DE/PARA da integração". Será exibida uma tela de visão com as opções de inclusão, exclusão e edição.

Através desse módulo o usuário poderá realizar o cadastro de De/PARA. Ao incluir um novo registro será exibida uma tela contendo os três campos para identificação.

.

Primeiramente deverá ser selecionado o tipo de Entidade (Cadastro), que pode ser: Curso/Segmento, Disciplina ou Habilitação/Série.

• Curso/Segmento: serão exibidos no campo "Valor do SGE – Módulo Educacional" os cursos disponíveis;
• Disciplina: serão exibidos no campo "Valor do SGE – Módulo Educacional" as disciplinas disponíveis;
• Habilitação/Série: serão exibidos no campo "Valor do SGE – Módulo Educacional" as habilitações disponíveis.
• Área - Grupo de Complemento: serão exibidos no campo "Valor do SGE – Módulo Educacional" aos grupos de complemento disponíveis.

No campo "Valor no Portal SESI Educação" deverá 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:

Então para um De/Para será cadastrado:

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 para um De/Para será cadastrado:

Para Disciplinas:

Então para um De/Para será cadastrado:

Para Área - Grupo de Complemento: 

Então para um De/Para será Cadastrado:

Pré-Requisitos / Parametrizações

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

Descrição do Processo

Foi desenvolvido uma 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:

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 será dado através do uso de tabela dinâmica X campo complementar na turma então será 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 será 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.

Pré-Requisitos / Parametrizações

Realizar parametrização da Integração e Parametrização De/Para Cursos e Disciplinas.

Descrição do Processo

Foi desenvolvido uma funcionalidade no Job de integração para realizar a exportação de Professores. 
Para envio dos dados do professor os campos abaixo são de preenchimento obrigatório:

Detalhamento do Processo

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.

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 EducarBrasil, e seu retorno será 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.

Pré-Requisitos / Parametrizações

Realizar a parametrização da Integração.

Descrição do Processo

Foi desenvolvido uma funcionalidade no Job de integração para realizar a exportação de Funcionários. 

Para envio dos dados do funcionário os campos abaixo são de preenchimento obrigatório:

Detalhamento do Processo

O termo 'funcionários' se refere às pessoas designadas a determinadas funções no SGE – Módulo Educacional (secretários escolares, coordenadores, diretores escolares, entre outros). Tais registros de 'funcionários' do SGE – Módulo Educacional são pessoas (PPESSOA) associados às funções através das funcionalidades 'Filial | Dados Educacionais | <anexo> Diretores por Filial e 'SGE – Módulo Educacional | Currículo e Oferta | Estrutura Curricular | Matrizes curriculares | <anexo> Matriz aplicada | <anexo> Comissão Coordenadora'. 

Importante: Para que os "Funcionários" seja exportado o mesmo deve ter um usuário vinculado ao seu cadastro de pessoa no SGE. 



A localização de Diretores e secretários serão localizados com base nos dados cadastrados no SGE - Módulo Fiscal | Filiais | Dados Educacionais | Diretores por Filial. Neste módulo são cadastrados os diretores e secretários.

Os campos obrigatórios, parametrizações e e-mail serão validados e, se estiverem corretos, serão enviados para o Portal EducarBrasil, e seu retorno será gravado na tabela de Log.

Pré-Requisitos / Parametrizações

Parametrização da Integração e Parametrização De/Para.

Descrição do Processo

Foi desenvolvido um processo para realizar o reenvio de erros ocorridos na integração.

Detalhamento do Processo

O Registro dos usuários são criados apenas no SGE e ao realizar uma alteração nos dados eles devem ser 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 irá interceptar a alteração, irá verificar a entidade que pertence o registro e irá realizar o processo de integração das informações. Ao final, um Log será inserido na tabela customizada informando o status da operação.

Observação: Caso ocorra um erro durante a integração, um registro será inserido no Log e o cadastro/alteração de senha do RM ocorrerá normalmente, sem que qualquer mensagem de erro seja exibida ao usuário.

Pré-Requisitos / Parametrizações

Realizar a parametrização da Integração.

Descrição do Processo

Foi desenvolvido um processo customizado que realizará a exportação de determinados registros para o Portal SESI Educação.

Detalhamento do Processo

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 poderá 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:

• Alunos (e responsáveis pelos alunos);
• Professores (Docentes);
• Funcionários (Diretores Escolares, Secretários Escolares, Orientadores, Coordenadores);
• Reenvio de dados.
  
  

Conforme imagem abaixo: