Páginas filhas
  • Manual Operacional da Customização - Integração Moodle x SGE (SESI-SENAI)

Versões comparadas

Chave

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

...

Expandir
titleProcesso Exportação de Matrículas

Detalhamento do processo

Além dos dados do aluno (usuário), serão enviados dados da matrícula (inscrição do aluno no curso, grupo de turma e agrupamento de filial/unidade) para que o mesmo possa ser criado no Moodle. O processo de Exportação de Matrículas irá buscar as matrículas de alunos no SGE que estiverem com Status igual ao parametrizado na aba Status da Matrícula – Matrícula (parâmetros da Integração, já descritos neste documento).


Image AddedImage RemovedImage Removed


Só serão exportadas as matrículas que atenderem às seguintes regras:

  • Matrículas em uma Turma com o campo complementar Ferramenta Ava preenchido com Moodle.


  • Matrículas em uma turma/disciplina com o Tipo da Turma definido como à distância, semipresencial, presencial e gerencial associada a uma Turma com o campo Ferramenta Ava preenchido com Moodle.
    • Novo!  No SGE, os alunos estarão matriculados em turmas/disciplinas gerenciadas, vinculadas à uma turma/disciplina gerencial. Através do Grupo da Turma no Moodle, será possível identificar a Turma Gerencial do aluno.
  • Deverá existir a Oferta no Moodle referente a Disciplina na qual o aluno será matriculado. A Oferta só será enviada quando atingir o número de dias antes do início da Turma, conforme definido no parâmetro "Quantidade Dias Envio- Ofertas". A data da inscrição do aluno será de acordo com a data início da Turma/disciplina e a partir dessa data ele terá acesso à sala do Moodle.


  • A integração da matrícula irá ocorrer apenas no momento que a situação de matrícula do aluno for um valor existente nos parâmetros que indicam Matrícula (aba Status de Matrícula – Matricula).


  • O registro de matrícula somente será integrado se existir um usuário ativo vinculado ao aluno.


Aviso
titleImportante:

Novo! 

  • No SGE, os alunos estarão matriculados em turmas gerenciadas, vinculadas à uma turma gerencial. Através do Grupo da Turma no Moodle, será possível identificar a Turma Gerencial do aluno. O código da turma gerenciada do aluno não será exportado para o Moodle. A customização identificará a matrícula através da turma gerencial. 
  • Para os casos de cancelamento e transferência de alunos em turmas/disciplinas gerenciais, o processo customizado irá seguir as mesmas regras da customização atual.

...

Expandir
titleProcesso Cancelamento e Transferência de Matrícula – Suspensão do acesso

Detalhamento do processo

Cancelamento
É possível realizar o cancelamento de uma matricula, seguindo os critérios abaixo:

  • Alterar a situação de matrícula do aluno nas turmas/disciplinas para uma das situações parametrizadas na aba Status de Matrícula – Inativar Matrícula (parâmetros da customização - Status de Matrícula – Inativar Matrícula (Conforme descrito anteriormente neste documento).


Visão no SGE:


Para suspender os usuários de alunos que foram enviados do SGE para o Moodle, (para que os mesmos não tenham acesso a plataforma) foi criado o processo de Exportação de Cancelamento e Transferência:
Image RemovedImage Removed
Image Added

Visão no Moodle:



Transferência
Além do cancelamento da matrícula, as transferências podem ocorrer das seguintes formas:


Transferência de Turma/Turno na mesma Unidade (SESI e SENAI): O processo de mudança de
turma/turno consiste em alterar a matrícula de um aluno no período letivo, mudando a turma atual
para uma nova turma, dentro da mesma unidade/filial no SGE. No Moodle será realizada apenas a
alteração de Grupo do aluno.


Transferência de Unidade para mesmo Curso (SESI e SENAI): O processo de mudança de unidade
consiste em transferir o aluno da unidade X para Y, do mesmo curso. No Moddle serão realizadas as
alterações de Grupo e Agrupamento do aluno.


Transferência de Curso para mesma Unidade (SENAI): O processo de mudança de curso para
mesma unidade/filial consiste em alterar o curso X do aluno para curso Y. No Moodle irá Suspender
o aluno na sala e inserir o mesmo, em uma nova sala, em um novo Grupo e Agrupamento.


Transferência de Curso para Unidade diferente (SENAI): O processo de mudança de curso para
outra unidade/filial consiste em alterar o curso X do aluno para curso Y da unidade X para Y. No
Moodle irá suspender o aluno na sala e inserir o mesmo, em uma nova sala, em um novo Grupo e
Agrupamento.


▪ Transferência Externa (SESI e SENAI): O processo de transferência externa pode ser utilizado para
os casos de Alunos de intercambio e para casos de Alunos que vão para outra escola que não seja da
rede SESI e SENAI. No Moodle irá apenas suspender o aluno da sala.


Importante: Para os tipos de transferências onde irão ocorrer (mudança de turma com alteração de matriz curricular, mudança de curso/unidade) o processo para tratar o histórico das notas dos alunos não será automatizado pelo processo customizado. Caberá ao usuário no Moodle verificar as notas das atividades realizadas pelo aluno no curso origem e lança-las no curso destino.

Exemplo de transferência de turma:
Visão no SGE:


Visão no Moodle:


Fluxo do processo:

Novo! 

Exclusão

É possível realizar a exclusão uma matrícula, selecionando a mesma em tela e excluir, o mesmo será realizado o processamento de suspensão de acesso ao Moodle corresponde a matricula disciplina excluída.

Nota
titleImportante

Caso ocorra algum problema em meio a exclusão do registro no SGE o comportamento nativo de exclusão não será interrompido, mas será registrado a ocorrência de erro no monitor de log para realização do reenvio.

Registros excluídos com erro serão processados na próxima execução do processo Cancelamento e Transferência.

...

Expandir
titleProcesso Importação de Notas Moodle

Detalhamento do processo

O objetivo desse Processo é importar para o SGE as notas e avaliações dos alunos, registradas no Moodle. Será criado um novo parâmetro customizado para execução desse processo, o menu utilizado ficará disponível em 2 (dois) locais diferentes, no SGE sendo eles:


▪ TOTVS Educacional | Customização | Moodle | Importação de Notas de Alunos.

Novo! 

Foi realizado um ajuste na API do Moodle, para melhorar a funcionalidade de importação automática de notas. Agora, o processo irá considerar as notas adicionadas até, no máximo, 72 horas antes do processo de importação.


Image RemovedImage Added


Ao executar o processo de forma automática, a customização irá selecionar todas as Turmas/Disciplinas com o Tipo da Turma definido como à distância ou semipresencial, associada a uma Turma com o campo Ferramenta Ava preenchido com Moodle, para o envio de notas ao Moodle, de todos os alunos que estão matriculados nas mesmas. O processo poderá ser executado manualmente pelo usuário, na data do processamento, ou agendado conforme recurso nativo de agendamento de job.

Novo! 

O processo de Importação de Notas atual foi ajustado para realizar importação  das turmas/disciplinas do tipo presencial e gerencial, considerando as novas regras para realizar importação de notas das turmas/disciplinas do tipo presencial desagrupadas por filial, de acordo com as regras de Exportação de Oferta - Curso do SGE para o Moodle.

Ao executar o processo de forma automática (Geral), a customização irá ajustar o processo atual, para selecionar todas as Turmas/Disciplinas com o Tipo da Turma definido como à distância, semipresencial e presencial associada a uma Turma com o campo Ferramenta Ava preenchido com Moodle, para o envio de notas ao Moodle, de todos os alunos que estão matriculados nas mesmas.


Dica

Pelo processo automático a customização só irá importar as notas de acordo com a Data Final da Turma/Disciplina + Qtde de Dias de Suspensão do usuário informada no parâmetro (Modalidade), quando for menor ou igual a data do processamento (data execução do processo geral). 


▪ TOTVS Educacional | Currículo e Oferta | Turma/Disciplina | Processo| Importação de Notas de Alunos.

Novo! 

Foi realizado um ajuste na API do Moodle, para melhorar a funcionalidade de importação de notas por turma/disciplina.  Agora, o processo irá retorna as notas alteradas a qualquer momento no processo de importação.







Ao executar o processo de forma manual, o usuário deverá selecionar a Turma/Disciplina com o Tipo da Turma definido como à distância ou semipresencial, associada a uma Turma com o campo Ferramenta Ava preenchido com Moodle e serão listados todos os alunos, que estão matriculados naquela determinada Turma/Disciplina, ficando a cargo do usuário selecionar um ou vários alunos e confirmar a execução do processo, para o envio de notas ao Moodle. 

Novo! 

Ao executar o processo de forma manual (Por Turma/Disciplina), o usuário deverá selecionar a Turma/Disciplina com o Tipo da Turma definido como presencial associada a uma Turma com o campo Ferramenta Ava preenchido com Moodle e serão listados todos os alunos, que estão matriculados naquela determinada Turma/Disciplina, ficando a cargo do usuário selecionar um ou vários alunos e confirmar a execução do processo, para o envio de notas ao Moodle. 


Dica

Pelo Processo manual (execução pela turma/disciplina) essa regra não é aplicada, já que este processo é utilizado justamente para exceções de lançamento de notas após o período definido. Caso afirmativo será exibido uma mensagem de alerta ao usuário, conforme exemplo:

Modelo mensagem: 

O lançamento de notas para esta Turma/Disciplina está fora do prazo de acordo com o prazo da apuração de resultados informado no parâmetro Modalidade. Deseja prosseguir e importar a nota? 


Quando os parâmetros Utiliza Importação Notas - Moodle -Turmas Presenciais e Turmas EAD estiverem desmarcados, o processo customizado não irá  importar nota do Moodle para o SGE. Porém o lançamento de nota no Moodle não sofrerá alterações, permitindo o acesso ao usuário, para continuar lançando nota no Moodle. Neste caso, se o usuário digitar uma nota no Moodle a mesma não será importada para o SGE.  Também não está previsto neste escopo o envio das notas lançadas através do SGE para o Moodle.


Aviso
titleImportante:

A importação manual não valida o parâmetro e período de suspensão de usuário, já que este processo é utilizado justamente para exceções de lançamento de notas após o período definido.

Novo! 

Para realizar a importação de notas das turmas/disciplinas gerenciais, o processo customizado terá que identificar através do Grupo Turma, a matrícula da turma/disciplina gerenciada, vinculada à uma turma/disciplina gerencial, para possibilitar a importação das notas do Moodle para o SGE. O código da turma gerenciada do aluno não será exportado para o Moodle. A customização identificará a matrícula através da turma gerencial. 

A nota será lançada na Sala referente a turma/disciplina gerencial no Moodle e ao importar para SGE o processo customizado deverá seguir comportamento nativo e salvar as notas lançadas nas turmas/disciplinas gerenciadas no SGE. Para isso, existem algumas regras para as notas serem importadas.

  • A turma/disciplina gerenciada deverá conter as mesmas etapas de notas e faltas da turma/disciplina gerencial.
  • Deverá ter o mesmo tipo de nota (numérico ou conceitual) da turma/disciplina gerencial. 
  • O parâmetro Utilizar turma/disciplina Gerencial na digitação de notas no TOTVS Educacional, disponível em: Configurações | Parâmetros Gerais| Secretaria |Etapa 1/7   deverá estar marcado, para o lançamento de notas na turma/disciplina gerencial ser replicado para as turmas/gerenciadas. Caso o parâmetro esteja desmarcado, a customização não irá realizar a importação das notas. Este parâmetro é configurado por filial. 

Após o lançamento das notas, a customização irá acionar os mesmos métodos utilizados na importação atual para obter as notas do Moodle e realizar a inclusão no SGE.


...

Expandir
titleMonitor de Log

Descrição do processo

Este requisito detalha a funcionalidade de Monitor de Logs da Integração.

Detalhamento do processo

Nesta interface o usuário poderá consultar os LOGs das operações de exportação executadas pela integração do TOTVS Educacional com Moodle.
Os históricos das exportações de dados para o Moodle serão registrados e poderão ser visualizadas no menu TOTVS Educacional | Customização | Integração Moodle | Monitor de Log.

Novo! 

Serão criadas novas funcionalidades no Monitor, são elas:

1 - Exportação de Ofertas - Turmas Gerenciais

2-  Processo de atualização de Tipo de mediação – Turma/Disciplina

3-  Processo de atualização de Tipo de mediação – Matriz/Curso


Image RemovedImage Added


Será possível realizar filtro através de campos referente ao último job executado e associado ao lob, código da filial, Action associada ao registro chave primária da Action (se existir).


 

Será apresentada ao usuário uma visão com a relação de registros importados e exportados.


  • Id Log: Identificador sequencial de Log.
  • Data de Criação: Data de Criação do registro.
  • Data da última alteração: Data da última alteração do registro.
  • Status: Situação da Integração (Sucesso ou Erro).
  • Id. Job: Ultimo job executado que resulto criação ou alteração do log.
  • Descrição do módulo: Descrição que permite identificar o módulo.
  • Cód. Filial: Código da Filial associada ao registro.
  • Funcionalidade: Tipo de Processo que está sendo feito (Por exemplo: Exportação Moodle).
  • Campos Chave: Descrição dos campos utilizados para gerar o registro integrado.
  • Valores Chave: Chave primária do registro integrado.
  • Action: Nome da Action associada ao registro do log. Se este campo não estiver visível indica que o registro não está associado a uma tela do sistema.
  • PrimaryKey re. principal: Chave primária associada a action que permitirá a edição do registro associado.
  • Exibir registro relacionado: Botão que abrirá a tela de edição do registro relacionado ao logo caso exista.
  • Última mensagem do item de log: Ultima mensagem do item do log.
  • Download de arquivos associados: Permitirá o download de arquivo associado ao logo caso exista.



Ao acessar o anexo de um registro será possível o usuário visualizar todos os registros relacionados ao cadastro integrado selecionando a opção Item de Log. Estarão disponíveis os seguintes campos:

  • Id. Item Log: Identificador sequencial de log.
  • Id. Log: Identificador sequencial de log.
  • Mensagem: Mensagem com o status da integração do item.
  • Status: Situação da integração do item selecionado.
  • Dados Enviados: Relação dos dados enviados para integração.
  • Dados Recebidos: Relação dos dados recebidos.
  • Data de Criação: Data de criação do registro.
  • Data da última Alteração: Data da última alteração do registro.

*Não será possível incluir, editar ou excluir informações através dessa interface.

Os dados informados nesta interface serão armazenados em tabela customizada por coligada.

Informações
titleFuncionalidades

Segue um arquivo contendo a lista de todas as funcionalidades do log e os campos que compõem a chave:

Lista de Funcionalidades

Os processo de importação de notas das Turmas/Disciplinas Presenciais e Gerenciais serão incluídos no log existente).

...

Expandir
titleProcesso para Reenvio de Dados

Novo! 

Pré-requisitos:

Liberar a permissão do perfil de usuário, no Monitor de log (Moodle), opção Reenvio de Log, conforme imagem:



Descrição do processo

Este requisito detalha o processo de Reenvio de registros em caso de falha na integração.

Detalhamento do processo

O objetivo do Processo de reenvio de dados é permitir o envio para o Moodle dos registros que não foram exportados corretamente. Esse processo poderá ser executado manualmente ou poderá ser agendado, por registro e a integração efetuará a exportação dos registros novamente.
A funcionalidade estará disponível na tela de Monitor de Logs, menu Processos | Reenvio de Log
Image Removed
Image Added 


Ao ser acionado o processo customizado de reenvio de dados a customização tentará realizar novamente o envio das informações ao Moodle, caso consiga o status do registro passará para Sucesso. O processo de reenvio automático será executado até atingir o número máximo de tentativas parametrizado (Parâmetros da integração – Parâmetros Gerais). Caso o parâmetro esteja vazio a customização não realizará nenhuma tentativa de reenvio automaticamente. Caso seja atingido o número máximo de tentativas de reenvio e em nenhuma das tentativas tenha retornado sucesso, a customização passará o status do registro para Cancelado, sendo o registro não integrado com o Moodle. Dependendo do erro ocorrido, o usuário precisará acessar o Monitor de log e analisar os logs, corrigir os registros (caso necessário) e então acionar o processo de reenvio.

...