Histórico da Página

Pré-requisitos

Os anexos de retorno devem ser liberados nas permissões de perfil dos usuários para aparecerem nos seus respectivos lugares. Para mais detalhes de como liberar no perfil dos usuários acesse o Manual de Instalação de Customizações na seção Liberando Acesso aos Menus.

Descrição do processo

Este requisito detalha os parâmetros necessários para a Integração de dados entre o TOTVS Educacional (SGE) e o Moodle.

Detalhamento do processo

A tela de parâmetros estará disponível em TOTVS Educacional | Customizações | Integração Moodle| Parâmetros.

Image RemovedImage Added

Ao clicar no menu de acesso será aberta a tela de parâmetros que possui seis abas de configurações: Dados de Conexão – WS, Parâmetros Gerais, Status de matrícula- Matricula, Status de Matricula- Inativar Matrículas, Disciplinas – Elegíveis (sendo está aba disponível apenas para o SESI) e Modalidades de Cursos, conforme descrição abaixo. Essa parametrização será realizada por coligada e Nível de Ensino.

Image RemovedImage Added

Na Aba Dados de Conexão – WS, deve ser informado os dados:

• Endereço WebService: Neste parâmetro o usuário deverá informar o Endereço de acesso ao WebService disponibilizado pelo Moodle.
• Usuário: Neste parâmetro o usuário deverá informar o Usuário de acesso ao WebService disponibilizado pelo Moodle.
• Senha: Neste parâmetro o usuário deverá informar a senha de acesso ao WebService disponibilizado pelo Moodle.
• Token acesso (Auto Login): O Token será valor fixo utilizado na autenticação do Moodle através do link externo que será disponibilizado no Portal do Aluno e no Portal do Professor.
• Token acesso (Integração): O Token será valor fixo utilizado na autenticação da Integração com WebService do Moodle

Na Aba Parâmetros Gerais, deve ser informado os dados:

Image RemovedImage Added

• Quantidade dias Envio - Oferta: Neste campo o usuário deverá informar a quantidade de dias, anteriores a Data de Início da Turma/Disciplina no SGE, para a integração enviar a Sala de oferta no Moodle. Esta informação vai definir quantos dias antes do início da turma, a mesma será enviada para o Moodle dando acesso para Alunos e Professores.
• ID Papel Professor: Neste campo o usuário deverá informar o ID do Papel do Professor no Moodle, para a integração enviar o código informado neste parâmetro ao Moodle. Esta informação irá definir qual será o Papel do Professor (Professor não Editor) e poderá ser alterado de acordo com a necessidade da FIEP.
• ID Papel Aluno: Neste campo o usuário deverá informar o ID do Papel do Aluno no Moodle. Essa informação será enviada pela integração do SGE para o Moodle no envio da matrícula/inscrição do aluno e irá definir qual será o Papel do Aluno no Moodle. O valor poderá ser alterado de acordo com a necessidade da FIEP.

Obs.: O ID do Papel Professor (Professor não Editor) e o ID do Papel Aluno (Aluno) serão únicos por coligada. As permissões do papel do professor e do aluno serão definidas diretamente no Moodle e não serão tratadas pela integração.

• Número tentativas de reenvio: Neste campo o usuário deverá informar o número máximo de tentativas que a customização deverá tentar realizar a integração com Moodle dos registros com status de erro.
• Endereço de e-mail – Inativação de acesso: Definir o e-mail (ou grupo) que deverá receber uma notificação quando algum acesso no Mooddle for suspenso pelo processo de Exportação de Cancelamento e Transferência de matrículas. Para informar mais de um e-mail, basta separá-los por ponto e vírgula (.

Na Aba Status de Matrícula - Matrícula, o usuário deverá informar o (s) Status de Matrícula que serão considerados no processo de matrícula para envio ao Moodle.

Image RemovedImage Added

Ao clicar em incluir, o campo exibido será do tipo lookup que a selecionar a customização retornará todos os Status de matrícula (SSTATUS) cadastrados para àquele Nível de Ensino.

Na Aba Status de Matrícula – Inativar Matrícula, o usuário deverá informar todos os Status de matrícula (Situação de Matricula) que a customização deverá considerar no processo de inativar uma matrícula na Integração com o Moodle.Image Removed

Image Added

Ao clicar em incluir, o campo exibido será do tipo lookup que ao selecionar a customização retornará todos os Status de matrícula (SSTATUS) cadastrados por Nível de Ensino.
Image Removed
Image Added

Na Aba Disciplinas- Elegíveis, será exibida uma visão onde o usuário deverá informar a (s) disciplinas Elegíveis ao Portal Oficinas, que deverão ser exportadas para o Moodle para gerando uma sala para cada Oficina. Essa situação é específica para o SESI.
Ao clicar em incluir, o campo exibido será do tipo lookup e ficará a cargo do usuário selecionar as disciplinas do cadastro (SDISCIPLINA).

Image RemovedImage RemovedImage AddedImage Added

Na Aba Modalidades de Cursos, usuário deverá informar a (s) Modalidades de Cursos e quantidade de dias – suspensão de usuário de cada uma, definidos por Coligada, para cortar o acesso do docente/professor ao tentar realizar alterações de notas no Moodle, após o prazo final do lançamento de notas no SGE.

Ao clicar em incluir, serão exibidos dois campos:

• Modalidade: será do tipo lookup e ficará a cargo do usuário selecionar a modalidade do cadastro nativo (SMODALIDADECURSO) para o qual deseja informar quantidade de dias para suspensão do usuário, de acordo com prazo final de cada Modalidade, definido pela FIEP.
• Qtde. Dias – Suspensão (Usuário): campo do tipo texto onde o usuário deverá informar a quantidade de dias de acordo com a Modalidade do Curso, que serão somadas à data final da Turma/ Disciplina. Esse resultado será enviado como data fim do acesso do usuário (aluno/professor) em determinado curso/sala e seu acesso será suspenso no Moodle.

Exemplo: Data Final (Turma/Disciplina): 09/03/2021 + Qdte. Dias Suspensão (Usuário) 3 dias uteis após o encerramento da turma/disciplina, para as Modalidade de Aprendizagem, ECO etc. = 12/03/2021. Essa data será enviada como data final nas inscrições dos usuários (aluno/professor) do Curso no Moodle. A Suspensão do usuário ocorrerá de forma automática no Moodle, quando for atingida a data final excluindo o acesso do mesmo no Curso.

Novo! 

Pré-requisitos

Os parâmetros de: Bloqueio Digitação de Notas no SGE e Alerta Digitação de Notas no SGE deverão estar marcados.

Detalhamento do processo

Ao salvar o lançamento de notas através da interface do RM.exe e pelo Portal do Professor, a customização irá validar se o parâmetro de Alerta de Digitação de Notas no SGE está marcado. Caso afirmativo será exibido uma mensagem de alerta ao usuário.

Alerta Digitação de Notas no SGE

Bloqueio Digitação de Notas no SGE

A mensagem de alerta será exibida quando o usuário realizar o lançamento de notas, através das seguintes interfaces: 

• TOTVS Educacional| Matrícula e Avaliação| Notas e faltas de etapa 
• TOTVS Educacional| Matrícula e Avaliação|Notas de avaliação 
• TOTVS Educacional| Matrícula e Avaliação|Mais| Digitação por aluno| Notas e faltas de etapa 
• TOTVS Educacional| Matrícula e Avaliação|Mais| Digitação por aluno| Notas de avaliação 
• Portal do Professor| Diário de Classe| Selecionar a turma/disciplina| AvaliaçõesNotas de avaliação 

Caso a turma selecionada não esteja configurada como utiliza Ferramenta Ava Moodle, a customização não irá exibir a mensagem de alerta através da  interface do RM.exe e pelo Portal do Professor.

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.

▪ 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. 

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.

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.

O modelo de Etapa de Notas varia de acordo com a modalidade de cada curso e mediação (Presencial, Semipresencial e À distância).
Para os cursos do SESI que não são elegíveis ao Portal Oficinas, assim como os cursos do SENAI, os modelos de etapa de notas e avaliações são cadastrados na Parametrização por Curso. Que estará disponível em: Totvs Educacional | Currículo e Oferta| Parametrização por Curso | Anexo| Modelo de Etapas da Matriz Aplicada| Etapa de Notas| Modelo de avaliação por curso.

AVALIAÇÕES SENAI/IEL:

Para o SENAI/IEL, os modelos de avaliações por curso não serão cadastrados através do SGE. O cadastro das avaliações será aberto no Moodle para que cada professor/docente possa incluí-las, respeitando regras de apuração de resultados do Rendimento escolar.

Elas serão importadas para as etapas correspondentes no cadastro de cada Turma/Disciplina no SGE, que estará disponível em: Totvs Educacional | Currículo e Oferta|Turma/Disciplina| Anexo| Etapas| Anexo| Avaliações. De acordo com o manual de processos de rendimento escolar do SENAI, as avaliações das etapas 1 Avaliação da Etapa 1 e 4 Avaliação da Etapa 2 devem ser cadastradas seguindo o padrão:

▪ Os códigos impares de 1 a 29 são reservados para avaliações.
▪ Os códigos pares de 2 a 30 são reservados para as recuperações paralelas.

Essa regra deve ser respeitada no Moodle no momento do cadastro das avaliações, para que o processo de apuração de resultados não seja afetado no SGE. Para os casos de etapa de Recuperação onde a regra será a mesma do SGE, o Moodle irá criar/enviar as avaliações apenas se o aluno não atingir a média de recuperação.

NOTAS:
O Docente/Professor poderá lançar notas no Moodle manualmente ou poderão ser calculadas automaticamente pelo questionário auto avaliativo.
O usuário deverá realizar o cadastro das Etapas de forma equivalente no Moodle e SGE.

Estrutura SENAI:

Novo! 

Novo! 

Estrutura IEL:

AVALIAÇÕES SESI:
Para o SESI os modelos de avaliações por curso serão cadastrados através do SGE (padronizadas) e os professores não poderão incluir/excluir avaliações através da plataforma Moodle, eles terão acesso apenas para realizar configurações nas avaliações.

NOTAS:
O Docente/Professor poderá lançar notas no Moodle manualmente ou poderão ser calculadas automaticamente pelo questionário auto avaliativo.

Estrutura SESI:

Observação: Quando a etapa for de Recuperação, não será realizada a importação de avaliação. As notas serão importadas diretamente para as etapas de recuperação de cada trimestre correspondente no SGE, para serem calculadas e preenchidas automaticamente pelo processo de apuração de resultado final do aluno no TOTVS Educacional (fórmula de apuração de resultados existente), conforme regra definida no projeto FS008668 - Importação de notas para etapa de recuperação.

As notas das etapas do tipo: Média da etapa, Média Final, Conselho de Classe e Resultado Final, não serão importadas do Moodle para o SGE, já que não serão lançadas no Moodle. Serão importadas apenas as notas de Etapas mais (Recuperação Final) e Avaliações das Etapas, para serem calculadas e preenchidas automaticamente pelo processo de apuração de resultado final do aluno no TOTVS Educacional.

Novo! → FS008966 - Integração Moodle - Importação de Notas do SENAI no Modelo SESI

Ao ser executado, o processo verifica a marcação do novo parâmetro  “Não importar Avaliações do Moodle - Modelo SESI” do anexo de Ferramenta Ava da Turma. Caso esteja preenchido, o processo não importa as avaliações do Moodle para o SGE e as notas são importadas seguindo o padrão de avaliações e regras para o SESI. 

Importante: 

A importação de notas para as Coligadas SESI e IEL não foi modificada. 

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.

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

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.