...
Sumário
Objetivo Desse Documento
Síntese
Instalando a Customização
Observações Importantes
Parâmetros de customização integração
Cadastro DE/PARA para integração
Integração de alunos (e responsáveis acadêmicos dos alunos)
Integração de professores (e disciplinas)
Integração de funcionários (Diretor, Secretários, Orientador Pedagógico e Coordenador)
Processo alteração de senha usuário SGE – Módulo Educacional
JobServer de integração (exportação)
Log Customizado
Processo de reenvio de dados
WebMethod integração usuário
Auto login Portal SGE
Importação de E-mails (Base do Portal SESI Educação)
Integração síncrona de alunos, professores e funcionários
Integração de Reconhecimento de Saberes via Web Service
Histórico de Atualização do Documento
...
...
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._*
...
Nenhum.
...
...
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.
Caso tal parâmetro não seja marcado então todos os registros da entidade serão considerados na integração;
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;
...
...
...
...
...
...
...
|
Imagem ilustrativa: Os valores corretos devem ser verificados no manual da EducarBrasil |
...
|
Imagem ilustrativa: Os valores corretos devem ser verificados no manual da EducarBrasil |
...
|
Imagem ilustrativa: Os valores corretos devem ser verificados no manual da EducarBrasil |
...
...
Campo | Localização |
Regional | Cadastro de Coligada: GCOLIGADA.ESTADO |
Inep | Cadastro de Filial / Dados para o MEC: SFILIALMEC.CODINEPESCOLA |
Nome | PPESSOA.NOME |
CPF | PPESSOA.CPF |
Código Externo | PPESSOA.CODUSUARIO |
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: | Caso o aluno seja menor de 18 anos e o segmento exija deve ser enviado. |
...
...
Realizar parametrização da Integração e Parametrização De/Para Cursos e Disciplinas.
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:
Campo | Localização |
Regional | Cadastro de Coligada: GCOLIGADA.ESTADO |
Inep | Cadastro de Filial / Dados para o MEC: SINSTITUICAOMEC.CODINEPINSTITUICAO |
Nome | PPESSOA.NOME |
Código Externo | PPESSOA.CODUSUARIO |
Sexo | PPESSOA.SEXO |
Nascimento | PPESSOA.DTNASCIMENTO |
PPESSOA.EMAIL | |
CPF | PPESSOA.CPF |
Senha | Obrigatória na inclusão |
...
...
Realizar a parametrização da Integração.
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:
Campo | Localização |
Regional | Cadastro de Coligada: GCOLIGADA.ESTADO |
Inep | Cadastro de Filial / Dados para o MEC: SINSTITUICAOMEC.CODINEPINSTITUICAO |
Nome | PPESSOA.NOME |
Código Externo | PPESSOA.CODUSUARIO |
Sexo | PPESSOA.SEXO |
Nascimento | PPESSOA.DTNASCIMENTO |
PPESSOA.EMAIL | |
CPF | PPESSOA.CPF |
Senha | Obrigatória na inclusão |
...
...
...
...
...
...
...
...
...
...
...
Conforme imagem abaixo:
...
...
Parametrização da Integração e Parametrização De/Para.
Foi desenvolvido um processo para realizar o reenvio de erros ocorridos na integração.
Durante 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 poderão 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 (Requisito 05) 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 será 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.
...
Nenhum.
Foi desenvolvido um WebService customizado para realizar a integração dos Usuários.
A partir do WebService desenvolvido, foi publicado um WebMethod para permitir a integração de usuários. O método possui a seguinte assinatura:
public ResponseDataType IntegraUsuario(UserDataType userData)
O objeto de retorno possui as seguintes propriedades:
public class ResponseDataType
{
public string CodUsuario;
public int ErrorCode;
public bool Success;
public string Message;
}
Sendo ErrorCode um código referente a algum erro que possa acontecer durante a integração. Virá como 0 (zero) em caso de sucesso. O booleano Sucess indica se ocorreu sucesso ou não na integração e o Message informa uma mensagem referente a algum possível erro, vindo vazio se tudo ocorrer corretamente.
O objeto UserDataType possui os seguintes parâmetros, que são os dados para a integração em si:
public class UserDataType
{
public string CodigoUsuario;
public string NovaSenha;
public string Email;
}
O código do usuário que irá ser integrado, a nova senha e o Email.
Observação: A senha deve trafegar em Base64.
Token de Segurança
Para que seja possível efetivar as requisições no WebService customizado, é preciso informar um usuário e senha válidos para realizar o login no SGE. Novamente, a senha deve estar na codificação encode/Base64.
Exemplo da configuração da requisição no SoapUI:
Exemplo de resposta de uma requisição processada com sucesso:
Exemplo de erro da requisição de validação de E-mail:
Tabela com códigos de erros do WebService
Descrição do erro | Código do erro |
Token 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 |
...
Nenhum.
Auto Login no Portal SGE de forma transparente aos usuários.
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
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.
Exemplo:
CPF: 012.345.678-90
Lista de Competências (disciplinas):
Código | Status |
MAT-C1 | 1 |
MAT-C2 | 0 |
MAT-C3 | 1 |
MAT-C4 | 1 |
CNT-C1 | 0 |
CHT-C1 | 1 |
Parametros Customizados - Aba Reconhecimento de saberes
Caso seja executado o processo para o aluno acima e ele esteja matriculado em todas as disciplinas enviadas pelo Web Service, ele ficará com as seguintes situações de matrícula nas disciplinas, considerando as parametrizações do exemplo:
...
...
...
...