Páginas filhas
  • Manual Operacional da customização - Versão 2.0

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Inclusão dos Gatilhos da Integração V2

...

Expandir
titleProcesso de Exportação [Atualizado]
Aviso

Antes de realizar a exportação das entidades ao Portal SESI, certifique-se que todos os parâmetros e configurações citadas acima, estejam preenchidas e com os valores corretos.

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.

Aviso

Para que os alunos integrados com sucesso sejam visualizados no Portal SESI Educação, é premissa que também tenham sido integradas as entidades: Turmas e Matrículas.

Informações
titleClique na entidade e veja as regras ao lado
Section
bordertrue
Column
width30

Toggle Cloak
exclusivetrue
id1
Pré Cadastro de Pessoa

Toggle Cloak
exclusivetrue
id2
Integração de Alunos/responsáveis

Toggle Cloak
exclusivetrue
id3
Integração de Turmas [Novo!] 

Toggle Cloak
exclusivetrue
id4
Integração de Matrículas [Alterado!]

Toggle Cloak
exclusivetrue
id5
Integração de Docentes

Toggle Cloak
exclusivetrue
id6
Integração de Aulas do Docente

Toggle Cloak
exclusivetrue
id7
Integração de Funcionários

Toggle Cloak
exclusivetrue
id8
Integração de Oficinas

Column
width70
Cloak
visibletrue
id1

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 (Exceto para alunos de 0 a 7 anos da Educação Infantil)
  • 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
visibletrue
id2

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 (Exceto para alunos de 0 a 7 anos da Educação Infantil)
  • 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. 
  • Matrículas do aluno: Caso o aluno possua matrícula, é necessário que a mesma esteja com a flag "Enviar ao Portal Sesi" para que o aluno seja integrado.
Cloak
id3

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[Novo!] 

No caso do Itinerário Formativo, serão consideradas as turmas/disciplinas que fizerem parte da matriz curricular e estejam definidas como parte do Itinerário. As disciplinas do itinerário formativo podem ou não fazer parte da grade de disciplinas, mas para efeito de considerar que elas são do Itinerário Formativo será verificado se o campo "Itinerário Formativo" da Turma/Disciplina está preenchido.

true@TITRequisitos da integração de Turmas/Disciplinas do Itinerário Formativo [Novo!]

@TIT
  • Serão consideradas como disciplinas do Itinerário Formativo aquelas que estiverem vinculadas à Matriz Curricular no anexo de Itinerários Formativos


  • No anexo de Disciplinas do Itinerário o campo "Grupo de complemento" será considerado para o DE/PARA 

Outras validações
  • [Novo!] ¹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 [Novo!] 

[Novo!] 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:

  1. 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.
  2. Executar o processo de exportação de Turmas.
Cloak
id4

Serão exportadas as Matriculas dos alunos considerando:


Itens que serão integrados

[Alterado!] Alunos já exportados ao Portal SESI e que estejam matriculados com algum dos Status (status indica) 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”. A data da turma não tem interferência na validação desse status;
  • 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;
  • 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”.
  • [Novo!] É importante ficar atento à parametrização da situação de matrícula campo "Status indica", pois ele deve estar coerente com o que será enviado para o Portal SESI. A partir da versão 12.1.2402.024 a data inicial da turma não considerada para identificação do Status Indica, passando a valer o DExPARA definido na parametrização.
    Assim se o aluno possui uma situação no SGE que o identifica como um pré-matrícula este deve ter o Status indica de pré-matrícula, valendo a mesma regra para as demais situações. 

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
id5

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
Atenção!

Para que o professor seja exportado, é necessário que ele tenha um usuário cadastrado no SGE e esteja ministrando aula em uma Turma/Disciplina que tenha sido informada no cadastro De/Para para disciplinas.

Cloak
id6

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á integradas

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

Cloak
id7

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 e-mail 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
id8

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
titleIntegração - Gatilhos

Pré-Requisitos / Parametrizações

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


Detalhamento do Processamento


Foram desenvolvidos pontos de gatilhos que serão acionados durante a modificação de cadastro de aluno e de matrícula, para a exportação dos dados para o Portal SESI Educação. Dados de professores e funcionários serão exportados em situações de mudanças cadastrais ou quando houver associação do professor a uma turma, do funcionário a uma comissão coordenadora ou à diretoria da filial.

Quando o usuário executar alguma alteração nos cadastros ou realizar a execução dos processos abaixo, a integração será executada para o(s) registro(s) selecionado(s).

Cadastros:

  • Cadastro de Pessoas.
  • Cadastro de Aluno.
  • Cadastro de Matrículas.
  • Matrícula on-line.
  • Cadastro de Turmas.
  • Cadastro de Professores.
  • Currículo e Oferta | Oferta | Turma Disciplina | Professores;
  • Estrutura Curricula | Matriz Curricular | Matriz Aplicada | Comissão Coordenadora.
  • Cadastro de Filial | Dados Educacionais | Diretores por Filial.
  • Cadastro de Usuários (apenas para alterações de e-mail/senha).


Processos:

  • Currículo e Oferta | Aluno | <processo> Matricular aluno;
  • Currículo e Oferta | Aluno | <anexo> Matriculas no Período letivo | <processo> Alterar situação de matrícula;
  • Currículo e Oferta | Aluno | <anexo> Matriculas no Período letivo | <processo> Matricular aluno nas disciplinas;
  • Currículo e Oferta | Aluno | <anexo> Matriculas isolada | <processo> > Alterar situação de matrícula;
  • Matrícula e Avaliação | Matrícula | Matrículas | <anexo> Matrículas em disciplinas | <processo> Alterar situação de matrícula;
  • Matrícula e Avaliação | Matrícula | Matrículas | <anexo> Matrículas em turma mista | <processo> Alterar situação de matrícula;
  • Matrícula e Avaliação | Matrícula | Matrículas | <processo> Alterar situação de matrícula;
  • Matrícula e Avaliação | Matrícula | Matrículas | <processo> Matricular aluno nas disciplinas;
  • Matrícula e Avaliação | Matrícula | Matrículas | <processo> Confirmação de matrícula por pagamento;
  • Matrícula e Avaliação | Matrícula | Matrícula isolada | <processo> Alterar situação de matrícula;
  • Matrícula e Avaliação | Matrícula | <processo> Rematrícula;
  • Matrícula e Avaliação | Matrícula | Mais | <processo> Confirmação de matrícula por pagamento;
  • Matrícula e Avaliação | Matrícula | Mais | <processo> Matricula de disciplinas em lote;



Filtragem dos Registros para Integração:
Apenas os registros de alunos cujo curso/segmento estejam configurados para integração serão processados.Somente as matrículas que estiverem em situações cadastradas como "situações de matrícula" serão incluídas na integração.

Validações Antes do Envio:
E-mail: O preenchimento do campo de e-mail será obrigatório conforme a configuração do curso/segmento do aluno em questão (por exemplo, no momento da matrícula ou alteração de cadastro).
Responsável Acadêmico: Para alunos menores de 18 anos, a presença de um responsável acadêmico será exigida, de acordo com as regras definidas para o curso/segmento relacionado ao aluno ou ao processo em execução.

Processamento e Integração:
As rotinas do sistema identificarão automaticamente os alunos envolvidos no processo (podendo ser mais de um ao mesmo tempo) e enviarão suas informações para integração.
As regras de integração (como coleta de dados, mapeamento de campos e validações) seguirão o mesmo padrão já utilizado para a integração de alunos. A integração ocorrerá apenas para os alunos cujas chaves primárias forem fornecidas.

Resultado da Integração:
Após a integração, o sistema avaliará o resultado (sucesso ou falha) para cada aluno.Um registro de log será gerado, contendo informações sobre o aluno, o status da integração e, em caso de erro, a mensagem de erro correspondente.

Tratamento de Erros:
Se ocorrer algum erro durante a integração, o processo principal não será interrompido. No entanto, o erro será registrado no log, e a integração com o Portal SESI Educação não será realizada para os registros afetados.

Exportação de Dados de Funcionários e Professores:
Apenas os cadastros de funcionários e professores que possuírem um usuário associado e atenderem às regras de validação de campos obrigatórios serão exportados.


Expandir
titleMonitor de log

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:


Informações
titleClique no item a esquerda e veja a descrição a direita
Section
bordertrue
Column
width30

Toggle Cloak
exclusivetrue
id10
Mensagem

Toggle Cloak
exclusivetrue
id20
Dados Enviados

Toggle Cloak
exclusivetrue
id30
Dados Recebidos


Column
width70
Cloak
visibletrue
id10

Mensagem: descrição geral da execução do processo.

Exemplo: Criação do aluno realizada com sucesso.



Cloak
visibletrue
id20

Dados enviados: Aqui é possível verificar se todos os dados preenchidos foram enviados.

Exemplo de exportação de Pré Cadastro de Pessoa:


  • Method= POST (criação) ou PUT (atualização)
  • iduser = identificador único da pessoa no Portal SESI
  • idred: será enviado fixo “7”
  • codigoExterno: campo livre 1 (Cadastro de Filial: DFILIAL.CAMPOLIVRE1)



Cloak
id30

Dados recebidos: retorno da exportação.

Exemplo: “cadastro realizado com sucesso’’





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:


...

Inativação de Usuários (Docentes / funcionários)
Expandir
titleInativação de Alunos

Com base no controle dos dados mais recentes integrados das Matrículas do Aluno, passaremos a enviar a atualização de inativação do aluno utilizando o serviço “Matrículas do Aluno”.

Neste processo, deve-se considerar a parametrização do Requisito 01 do escopo FS008994 - Integração Portal SESI - Melhorias na Integração - Parte 1, que identifica as Situações de Matrícula e seus respectivos Status. Para cada situação, será considerado o valor a ser enviado.

Uma situação especial a ser considerada é a de Concluinte, que não está designada na parametrização. Essa condição é identificada quando o aluno apresenta a Situação de Matrícula com Status Indica “Matriculado” e a matrícula se enquadra em um dos seguintes cenários:

  • Data corrente não compreende o período da Turma, Data Início e Data Fim;
  • Possuem Resultado preenchido;

O campo statusMatricula será então preenchido condicionalmente considerando as seguintes possibilidades:

1.Pré-Matriculado (2): 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;


2.Concluinte (4): 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 atenderem ao menos uma das seguintes regras:

    1. Data corrente é maior que a Data Fim da Turma;
    2. Possuem Resultado preenchido.


3. Matriculado (3): 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 (4) ou Pré-Matriculado (2);


4. Inativo (0): para matrículas no período letivo que estiverem parametrizadas com Situação de Matrícula que o Status Indica estiver preenchido como “Inativo”;

Expandir
title

Expandir
titleInativação de Docentes

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:

  • Acesse o Menu: TOTVS Educacional  |  Currículo e oferta | Professores  | Processos | Inativação de Professor - Portal SESI

  • Será apresentado na tela do lado esquerdo a lista de professores selecionados e que já foram exportados para o Portal SESI.
  • Ao Clicar em um registro do lado esquerdo, aparecerá do Lado direito da tela as filais que ele está vinculado.
  • Selecionar do lado direito em qual filial o docente será inativado.

  • Avançar a tela, os docentes e filiais selecionadas, serão apresentadas em árvore para que o usuário visualize a estrutura que faz parte da Inativação.

  • Após a execução do processo, a  data  final do vínculo do professor com turmas/disciplinas será alterada.

Os registros desse processo são gravados no Monitor de log.

...