Integração Moodle x Mentor Web

Essa configuração não é obrigatória, porém caso haja necessidade pode ser realizada para facilitar a configuração.

• Deve-se acessar a aba “Site administration”

• Na Aba General, deve-se localizar o Menu “Language” e acessar a opção “Language packs”:

• Nesta tela, basta localizar e selecionar o idioma Português. Após selecionar, deve-se clicar no botão “Install selected language pack(s)”

Após adicionar o idioma Português, devemos definir ele como padrão, conforme abaixo:

• Acessar as abas Site administration e General, localizar o Menu Language e acessar a opção Language settings.

• Deve-se alterar o idioma na opção “Default language”, selecionado o idioma Português. Para aplicar a mudança é necessário salvar a configuração, clicando no botão “Save Changes” localizada no final da página.

Também é necessário alterar o idioma padrão do usuário administrador.

• Para realizar a alteração, basta clicar na Foto de Perfil, opção “Language” e selecionar o idioma Português.

A configuração acima é opcional, sendo permitido também manter o idioma em inglês se desejado.

Nesta etapa é necessário instalar os plugins via interface do Moodle.

É necessário estar logado com o usuário administrador.

Para instalar os plugins deve ser baixado o arquivo .zip dos plugins atualizados. Atualmente existem três plugins:

• auth-ws: Plugin necessário para que o usuário possa logar no Moodle, usando a mesma senha do Mentor Web.

Para baixar o plugin clique no link: moodle-auth-ws-2024062400.zip

• local_mentorweb: Plugin que necessário para que seja possível cadastrar avaliações parciais no Moodle.

Para baixar o plugin clique no link: moodle_local_mentorweb-2024070801.zip

• grade-export: Plugin necessário para exportar as notas do Moodle para o Mentor Web.

Para baixar o plugin clique no link: moodle-grade-export-2024042201.zip

Instalação do Plugin auth-ws

• Para instalar o plugin, deve-se acessar a opção Administração do site > aba Plugins > menu Instalar plugins

• Arraste o .zip do plugin. Deve-se clicar no botão “Instalar plugin do arquivo .zip”

• Após clicar no botão de instalar plugin, será exibida uma mensagem de validação do plugin. Deve-se clicar em “Continuar”

• O Moodle exibirá uma tela sobre as informações da versão do Moodle. Basta clicar em “Continuar” ao final da página:

• A tela seguinte, refere-se a Verificação de plugins. Essa página mostra os plugins que podem requerer sua atenção durante a atualização, como os novos plugins que serão instalados, plugins com novas versões que serão atualizados e plugins que estão faltando, etc.

Deve-se clicar no botão “Atualizar base de dados do Moodle agora”. Em seguida, será exibida uma tela indicando que o plugin auth_ws foi atualizado. Basta clicar em “Continuar”

• A tela seguinte, refere-se as configurações da Autenticação via webservice externo

Nessa tela a única alteração necessária é o campo URL do edusoftapi. A URL que deve ser informada é a URL da API do cliente. Essa informação deve ser repassada pelo Consultor da Edusoft ao administrador do Moodle. URL de exemplo: https://treino.mentorweb.ws/edusoftTreinoApi

• O próximo passo é habilitar a autenticação via auth-ws. Deve-se acessar a opção “Administração do site”, aba “Plugins”, menu “Gerenciar autenticação”, localizar a Autenticação via webservice externo e Habilitar

Instalação do Plugin local_mentorweb

• Para instalar o plugin, deve-se acessar a opção Administração do site > aba Plugins > menu Instalar plugins

• Arraste o .zip do plugin. Deve-se clicar no botão “Instalar plugin do arquivo .zip”

* Após clicar no botão de instalar plugin, será exibida uma mensagem de validação do plugin. Deve-se clicar em “Continuar”

• O Moodle exibirá uma tela sobre as informações da versão do Moodle. Basta clicar em “Continuar” ao final da página:

• A tela seguinte, refere-se a Verificação de plugins. Essa página mostra os plugins que podem requerer sua atenção durante a atualização, como os novos plugins que serão instalados, plugins com novas versões que serão atualizados e plugins que estão faltando, etc.

Deve-se clicar no botão “Atualizar base de dados do Moodle agora”. Em seguida, será exibida uma tela indicando que o plugin local_mentorweb foi atualizado. Basta clicar em “Continuar”

• Na tela de configurações do plugin, será necessário configurar o token do Moodle e a URL do mentorweb. Por hora, não será necessário preencher o Token, pois ele será gerado em um passo adiante. O campo URL deve ser configurada já nesse momento, com a URL do mentorweb. Essa informação deve ser repassada pelo Consultor da Edusoft ao administrador do Moodle. URL de exemplo: https://treino.mentorweb.ws/treino/rest/ICorujaACA/

Instalação do Plugin grade-export

* Para instalar o plugin, deve-se acessar a opção Administração do site > aba Plugins > menu Instalar plugins

* Arraste o .zip do plugin. Deve-se clicar no botão “Instalar plugin do arquivo .zip”

* Após clicar no botão de instalar plugin, será exibida uma mensagem de validação do plugin. Deve-se clicar em “Continuar”

* O Moodle exibirá uma tela sobre as informações da versão do Moodle. Basta clicar em “Continuar” ao final da página:

* A tela seguinte, refere-se a Verificação de plugins. Essa página mostra os plugins que podem requerer sua atenção durante a atualização, como os novos plugins que serão instalados, plugins com novas versões que serão atualizados e plugins que estão faltando, etc.

Deve-se clicar no botão “Atualizar base de dados do Moodle agora”. Em seguida, será exibida uma tela indicando que o plugin grade-export foi atualizado. Basta clicar em “Continuar”

É necessário criar um serviço externo no Moodle que tenha as permissões necessárias de criação de cursos e inscrição de alunos, para que o Mentor Web consiga integrar corretamente os dados.

• Deve-se acessar a opção Administração do site > aba Servidor > menu Web services. Neste menu, clicar em Serviços externos.

• É necessário Adicionar um serviço externo e inserir uma sigla e uma descrição, conforme o exemplo abaixo, onde a descrição é “Sistema de Gestão Acadêmica” e a sigla é “SGA”. Os parâmetros “Ativado” e “Apenas usuários autorizados” devem ser marcados. Após realizar a configuração, clicar no botão “Adicionar Serviço”

• Após adicionar o serviço, devemos atribuir Funções a ele. Para isso, basta clicar na opção “Adicionar Funções” na tela

• Na tela de adicionar funções, deve-se adicionar todas as funções listadas abaixo e clicar em Adicionar

• É necessário adicionar um usuário para o serviço externo. Para isso, acesse a Administração do site > aba Servidor, opção Web services e menu Serviços externos.

• Clicar em “Usuários Autorizados”

• Deve-se localizar o usuário e clicar no botão “Adicionar”, que contém a seta para esquerda.

• Nesse momento, será gerado o Token para o Serviço Externo. Dessa forma, acesse Administração do site > Servidor > Web services > Gerenciar tokens > Criar token

• Na criação do Token, coloque um nome para o Token, adicione o usuário autorizado e o Serviço Externo. A opção “Válido até” deverá ser desmarcada. Salver as alterações.

• Será gerado um Token. É necessário salvar o token, para uso posterior.

• O Token gerado no passo anterior, deverá ser adicionado no Mentor Web > Menu “Configuração EAD”, no campo Chave de autenticação (Token)

Também é necessário adicionar o Token no Moodle, no plugin local_mentorweb: Administração do site > Plugins > Localizar o menu MentorWeb > Adicionar no campo “Token”

Esta configuração é necessária para que o Mentor Web possa inscrever os alunos nos cursos.

• Acesse a opção Administração do site > Plugins > Localize a opção “Inscrições manuais” e altere a configuração “Habilitar inscrições manuais” para SIM. Salve as alterações.

• Deve-se acessar a opção Administração do site > Geral > Recursos avançados > Marcar a opção “Habilitar serviços web (web services)” Salve a alteração.

• Também é necessário Habilitar o protocolo JSON. Para isso, acesse Administração do site > Servidor > WebServices > Gerenciar protocolos > habilite o Protocolo REST. Salve a alteração

Essa configuração é necessária para que o Mentor Web possa cadastrar os usuários sem gerar erros de senha.

• Deve-se acessar a opção Administração do site > Geral > Segurança > Configurações de segurança do site, altere as configurações conforme descrito abaixo. Após realizar os ajuste, salve as alterações.

1. Política de senhas (passwordpolicy): Desmarcado.
2. Tamanho da senha (minpasswordlength): 0 (Zero)
3. Números (minpassworddigits): 0 (Zero)
4. Letras minúsculas (minpasswordlower): 0 (Zero)
5. Letras maiúsculas (minpasswordupper): 0 (Zero)
6. Caracteres não alfanuméricos (minpasswordnonalphanum): 0 (Zero)
7. Caracteres consecutivos idênticos (maxconsecutiveidentchars): 0 (Zero)

Essa configuração é necessária para o login automático, quando o aluno loga no Moodle via portal do aluno no Mentor Web. Você pode baixar o arquivo, clicando no link ao lado. Lembre-se de descompactar o arquivo: logar.rar

• O arquivo deve ser repassado ao administrador do Moodle, que deve adicionar o arquivo dentro do servidor na pasta moodle/login/logar.php.

• No Moodle, acessar a opção Administração do site > Cursos > Gerenciar cursos e categorias.

• Escolha a Categoria pai que foi integrada pelo Mentor Web.

• Por padrão o Moodle irá mover os cursos para outra categoria. Deve-se mudar para excluir os cursos vinculados a categoria.

Após o procedimento acima, é necessário limpar os IDs de integração das categorias e das turmas disciplinas

Limpar registros

Para limpar todos os registros do Moodle no Mentor Web:

• Deverá possuir um banco e aplicação de teste para o Mentor Web e Moodle.
• Realizar o passo a passo desse tutorial.
• Para limpar as informações de pessoas integradas

UPDATE TB_PESSOA SET PES_CODEAD = NULL, PES_DATINTEAD = NULL, PES_EMAILINSTITUICAO = NULL WHERE PES_CODEAD IS NOT NULL
DELETE FROM TB_PESSOA_EAD

• Para limpar as categorias integradas

UPDATE TB_CATEGORIA_EAD SET CAE_CODEAD = NULL WHERE CAE_CODEAD IS NOT NULL 

• Para limpar as informações de turmas/disciplinas integradas

UPDATE TB_TURMA_DISCIP SET TDI_CODEAD = NULL, TDI_DATINTEAD = NULL WHERE TDI_CODEAD IS NOT NULL
UPDATE TB_AVAPAR_CADAVA SET APC_CODEAD = NULL WHERE APC_CODEAD IS NOT NULL
UPDATE TB_AGRUPAM_TURMA_DISCIP SET AGT_CODEAD = NULL WHERE AGT_CODEAD IS NOT NULL
UPDATE TB_MESTRE_DISCIPLINA SET MDI_DATINTEAD = NULL WHERE MDI_DATINTEAD IS NOT NULL
 
DELETE FROM tb_atualizamdi_ead

• Para limpar as categorias integradas.

DELETE FROM tb_categoria_ead

Caso o usuário queira limpar o cadastro de usuário/cursos e categorias no Moodle via banco deverá executar o comando abaixo.

DELETE FROM MDL_COURSE_CATEGORIES WHERE ID NOT IN(SELECT MIN(ID) FROM MDL_COURSE_CATEGORIES)
DELETE FROM MDL_COURSE WHERE ID NOT IN(SELECT MIN(ID) FROM MDL_COURSE)
DELETE FROM MDL_USER WHERE ID > :ID do administrador do sistema

Obs.: Não executar em base de produção esses scripts, pois deletará as informações

Antes de iniciar os processos de configuração do Moodle no Mentor Web, é necessário que todos os passos da configuração do Moodle tenham sido realizados.

No módulo Acadêmico (Graduação, Pós, EAD e etc) está disponível a opção de menu Configuração EAD, que deverá ser acessada para definição das configurações, onde está dividida em duas abas, uma referente a configuração do Moodle e outra referente as categorias que serão integradas.

Abaixo, serão descritos os componentes das abas:

Aba Configurações

URL do web service: Caminho do web service que será chamado para integração.

URL para login automático no Moodle: Ao utilizar o action “Acessar o moodle” o sistema jogará as informações de usuário por esta URL, porém para funcionamento desta opção o arquivo “logar.php” deve estar dentro da pasta login do Moodle.
Faça o download do arquivo logar.zip, descompacte e copie o arquivo logar.php para dentro da pasta login que se encontra na raiz da pasta mooodle.

Chave de autenticação (Token): Informar a chave gerada (token) no passo de configurações do Moodle.

Exporta somente movimentos vigentes: Irá exportar somente movimentos vigentes, verificando data inicial e final dentro do cadastro da turma/disciplina.

Enviar turma sem alunos/professores: Irá enviar turmas sem alunos e professores.

Enviar alunos com situação pré-matrícula: Se marcado, irá enviar alunos com situação de pré-matrícula.

Data de início: Irá habilitar as seguintes opções;

• Não envia, onde não exportará a data inicial dentro do cadastro da turma/disciplina.
• Enviar a data de início da turma/disciplina, onde irá exportar a data inicial dentro do cadastro da turma/disciplina.

Data de término: Irá habilitar as seguintes opções;

• Não envia, onde não exporta data final dentro do cadastro da turma/disciplina.
• Enviar a data de término da turma/disciplina, onde irá exportar a data final dentro do cadastro da turma/disciplina.
• Calcular data de término da turma/disciplina, o sistema envia a data inicial da turma/disciplina + a quantidade de dias configurado no curso/unidade. Clique aqui para saber onde cadastra-se a quantidade de dias para concluir o curso EAD.

Divisão de aluno(s) em grupo(s) : Opções de divisão de alunos em: 'Não utiliza', 'Polo/Unidade' e 'Subturma'.

Essa configuração determina se a integração deve dividir os alunos em grupos, conforme a parametrização. Pode-se dividir em Polo/Unidade em que o aluno está matriculado ou na Subturma em que o aluno está realizando a disciplina. Caso configurado, os grupos serão criados no Curso do Moodle com a nomenclatura da subturma ou, então, com a nomenclatura da unidade (polo);

Instruções para consulta de campos personalizados no EAD: Definição de consulta SQL que será utilizada na integração para buscar os valores dos campos e informar ao Moodle os valores para campos personalizados (custom fields). Na consulta SQL deverá ser informando os alias dos campos utilizados no Moodle (nome do campo e não o seu apelido) relacionado aos campos da pessoa. Exemplo: SELECT PES_NRODOC1 AS “cpf”, PES_NRODOC2 AS “rg” FROM TB_PESSOA WHERE PES_ID = ${PESSOA_ID}. Onde “cpf” e “rg” são os campos personalizados do Moodle e “PES_NRODOC1” e “PES_NRODOC2” são os campos da tabela com os valores requeridos.
Campos coringa: Consulta de campos coringa que podem ser utilizados na consulta acima.

Aba Categorias

Na aba “Categorias” são definidas as categorias/níveis que são integradas e estruturadas as informações dentro do Moodle, pois as turmas/disciplinas serão distribuídas em categorias e níveis conforme definição dessa configuração. Deve-se selecionar os níveis que as turmas devem ser agrupadas.

Deve-se preencher também o campo “Identificação da turma/disciplina no EAD” , pois esta informação define como serão identificadas as turmas/disciplinas no ambiente do Moodle. Para essa configuração podem ser utilizados os campos relacionados no quadro “Campos disponíveis”.

Consulta de campos personalizados no EAD

Para integração da consulta de campos personalizados, primeiramente deverá ser acessado o Perfil administrador do Moodle e acessar a tela de Administração do site:

Ao acessar esta tela, selecionar a Aba Usuários e clicar no item 'Campos de perfil do usuário', conforme imagem abaixo:

Para configurar os campos deve-se clicar em Criar um novo campo de perfil, informar o tipo do campo e o nome, esse nome deverá ser o mesmo informado no alias nas configurações do EAD no Moodle, ao final do processo.

É possível alterar ou excluir os campos cadastrados a partir dos ícones ao lado do campo.

Depois de cadastrados os campos, deve-se realizar a configuração do EAD com campos personalizados e informados na consulta, sem esquecer do alias, que será o mesmo nome do campo no Moodle, criado anteriormente:

Para este processo será utilizado o campo específico na tela de Configurações EAD:

Como exemplo de consulta, foi disponibilizado uma consulta padrão para CPF e RG:

Por fim, realizar a integração com o Moodle.

Particularidades para funcionamento da integração

Para execução da integração com sucesso entre Mentor Web e Moodle existem algumas opções que devem estar preenchidas no sistema, sendo os seguintes:

• Opção de “Integra com o EAD”, nas informações do curso por unidade.
• A nomenclatura das fases no cadastro do curso deve estar preenchido, caso o contrário no momento da integração poderá retornar “Serviço Indisponível”.
• No Moodle, realizar as configurações

Integração de categoria/Módulos da Grade de disciplinas

Quando a configuração de uma grade curricular inclui módulos de disciplinas e tanto a grade quanto as disciplinas estão integradas com o EAD, o sistema enviará automaticamente a categoria e o módulo da grade para o Moodle se configurado como uma das categorias. Isso ocorrerá conforme as configurações definidas tanto no EAD quanto na própria grade curricular.

Pré-requisitos

• Para que as categorias sejam enviadas faz-se necessário:
  
  • Realizar as configurações no menu de Configuração do EAD
    
  • Ter matrícula na turma que será integrada com o moddle
    
  • Na grade curricular estar configurado a opção de utilizar módulo
    
  • Módulo das disciplinas cadastradas e vinculadas as disciplinas na grade.

Abaixo disponibilizamos as informações necessárias para fazer a integração.

• Configurações EAD

Acessar o menu EAD > Configuração > Aba categorias. Nesta aba é selecionado as informações que serão enviadas na integração com o EAD da turma. Disponibilizado a opção “Nível 6: Módulo da Grade” e também a opção de Identificação da turma/disciplina no EAD “MODGRA”. Para enviar o módulo da grade deve-se selecionar a opção de “Nível 6: Módulo da grade”, e no campo “Identificação da turma/disciplina no EAD, também informar o “MODGRA”.

• Configurações da Grade Curricular

No cadastro da grade curricular, deverá estar configurado para utilizar módulo de disciplinas.

Com isso será habilitado a aba de “Módulos de disciplina”, nesta aba são cadastrados os módulos da grade.

Após o cadastro dos módulos, na aba “Componente curricular” será habilitado a opção “Módulo” para ser informado o módulo que cada disciplina está vinculado. A opção “Integra com EAD” também deverá estar marcado para cada disciplina que terá a integração com o EAD.

• Integrar com o EAD

Após as configurações realizadas, e houver alunos matriculados na turma, ao acessar o menu: “Integrar com o EAD”, será possível realizar a integração da turma enviando a categoria/módulo das disciplinas. Deve-se selecionar o período letivo da turma, curso, turma e disciplina que será enviada, e clicar no botão “Integrar”.

No Moodle acessar o menu: Administração do site > Cursos > Gerenciar cursos e categorias, será possível visualizar os dados que foram enviados, na configuração de teste conforme pode ser visto na aba de configurações EAD, foi configurado para enviar:
Nível 1: Subnível
Nível 2: Unidade
Nível 3: Período letivo
Nível 5: Curso
Nível 6: Módulo da grade
Nível 7: Fase
Nível 8: Turma

Portanto no moodle também será exibido nessa ordem, conforme print abaixo.

O código do template servirá para fazer referência ao código de um curso no Moodle, com o objetivo de criar uma cópia (clonagem) deste curso. Ao informar o código do template na disciplina no cadastro da turma, e integrar essa disciplina com o moodle, serão clonados para essa disciplina os seus materiais, multimídias, conteúdos e configurações do curso que foi informado o código no template.

Para acessar a tela de Serviço Externo, é necessário ter permissão na aplicação Security para o Perfil do usuário. A permissão a ser dada é a “Serviço externo” nos módulos “Comum” dos sistemas MentorWeb e MentorWebG5.

O administrador poderá gerenciar os serviços disponíveis, incluindo a possibilidade de disponibilizar novos serviços. Os serviços já cadastrados e utilizados pela Edusoft não podem ser modificados em termos de estrutura, exceto por ajustes nos seguintes campos: IPs liberados, HTTPS, usuário, senha e valor padrão (parâmetros do detalhe). Quando o proprietário do serviço é a Edusoft, o administrador só poderá alterar esses campos específicos. No caso dos serviços que foram cadastrados pelo próprio administrador, ele terá permissão para modificar todos os campos conforme necessário.

O acesso a essa funcionalidade pode ser feito diretamente pelo menu Serviço Externo (Módulo Comum)

Ao acessar a tela de serviço externo, o administrador poderá acessar o serviço já cadastrado Moodle - Conclui disciplinas / ingresso - EAD

O serviço será responsável por:

• Atualizar o status dos ingressos marcados com a opção “Integra com EAD” para “Concluído”, desde que não haja nenhuma disciplina com o status “Cursando”, mesmo que a alteração da situação da disciplina não tenha sido feita por meio de agendamento.
• Revisar as configurações de compartilhamento para garantir que as configurações EAD estejam devidamente cadastradas conforme o compartilhamento. Além disso, verificar se há resultados do tipo “Não concluiu” cadastrados, respeitando o agrupamento definido.

Orientações para preenchimento:

• Comando: Anexar o arquivo kjb.zip

Em seguida acessar Opções > Step's Kettle de transformação

Orientações para preenchimento:

• Nome do Step: Informar o nome atualizaMestreDisciplinaIngressoMoodle
• Anexo do step: Anexar o arquivo ktr.zip

Para cadastrar uma atividade o professor deve ter acesso e ter vinculo a um curso no Moodle.
Ao realizar o login no Moodle, o professor deve selecionar o curso desejado.

Ao selecionar um curso, será aberto o painel do curso.
Em cada tópico é possível adicionar um atividade. Clique em Adicionar uma atividade ou recurso no tópico desejado.

Ao clicar para adicionar uma atividade, selecione o tipo de atividade “Tarefa”.

Depois de adicionar a atividade, será aberto o cadastrado da atividade, com os campos: Nome da tarefa, Descrição, entre outros. Deve-se preencher esses campos conforme necessidade.

No cadastro da tarefa, é possível informar as configurações da nota da atividade, podendo editar a nota máxima da tarefa, que deve respeitar o critério usado para a turma/disciplina. Por exemplo, se a turma utiliza um tipo de nota de 0 a 10, a nota máxima deve ser 10.

Na parte final do cadastro da avaliação, existe a configuração da Avaliação Parcial, chamada MentorWeb. Nessa configuração deve-se informar o tipo de nota que será inserido a avaliação e a sigla da mesma.

Esta tela utiliza o serviço acadêmico de cadastro de avaliação parcial, para verificar a documentação do mesmo clique aqui.

Após a criação das tarefas e a realização das avaliações, o professor pode inserir as notas dos alunos. Para registrar uma nota, basta clicar na atividade correspondente.

Ao acessar a tarefa, deve-se clicar no botão nota para abrir a tela de digitação de notas.

Na tela de digitação de notas, serão exibidas as respostas de cada aluno. Se houver anexos ou comentários adicionados pelos alunos, estes também poderão ser visualizados.

A nota deve ser inserida no campo “Nota”. Além disso, é possível adicionar comentários de feedback para cada aluno.

As notas devem ser registradas individualmente, um aluno de cada vez.

Ao lado do nome do aluno, é possível escolher o próximo aluno a ser avaliado.

Após digitar as notas, basta enviar as notas para o Mentor Web, conforme procedimento detalhado a seguir.

Após a criação e digitação, as notas podem ser enviadas do Moodle para o Mentor Web.

Para enviar as notas, deve-se acessar a disciplina e clicar na opção “Notas”

Na tela seguinte, deve-se clicar no botão “Relatório de notas” > Exportar

No item Itens de nota a serem inclusos, selecione as tarefas que serão enviadas para o Mentor Web. Após selecionar todas as tarefas que vão ser enviadas, clique em Download.

Após clicar em Download, o professor terá o resultado da operação (Sucesso, Falha…). Se for sucesso, as notas foram enviadas ao Mentor Web.

Esta tela utiliza o serviço acadêmico de gravação de notas de avaliação parcial, para verificar a documentação do mesmo clique aqui.

Para que o Mentor Web receba as médias calculdas pelo Moodle, é necessário realizar configurações no Mentor Web e no Moodle.

Configurações no Mentor Web

1. Regra de cálculo para recebimento de médias EAD

Para utilizar o processo de recebimento de médias EAD, é necessário cadastrar a regra de cálculo (Módulo Acadêmico > Diário Eletrônico > Regras de Cálculo) abaixo:

double media = 0;
 
media = (nota.CODIGO);
 
return media;

Exemplo:
Ao definir o seguinte código na regra de cálculo:


No cadastro de critério de avaliação por disciplina, aba Avaliações, o código da primeira avaliação, deve ser o mesmo definido na regra de cálculo

2. Ajuste do Critério de Avaliação > Opção Utiliza diário eletrônico

Obrigatoriamente as turma/disciplinas que irão receber as médias, deverão utilizar um critério de avaliação que não utiliza diário eletrônico. Quando um critério de avaliação não utiliza diário eletrônico, não será possível realizar a digitação de notas e frequência. Sendo assim, ao desmarcar esta opção são desabilitados alguns campos em tela. São eles: “Provas e Trabalho” e “Calcula frequência”.

Deve possuir apenas duas avaliações na aba Avaliações. A primeira deverá ser normal e a segunda deverá ser uma nota de média, marcando a opção “Média”.

Após criação deste critério de avaliação, deve-se criar as turmas/disciplinas e vincular este critério de avaliação.

A titulo de curiosidade:

• Para os critérios de avaliação que são de zero(0) a cem(100), será necessário configurar no Moodle também, pois a configuração padrão do Moodle é de zero(0) a dez(10).
• Os tipos de critérios abaixo, não recebem as médias pois não contém o mesmo tipo no Moodle:
  • Digita conceito por objetivo
  • Digita somente faltas
  • Digita avaliação descritiva
• Na alteração de critério de avaliação, somente será permitido realizar a alteração de critério de avaliação quando ambos os critérios de avaliação estiverem com a opção “Utiliza diário eletrônico”.
• Ao vincular o critério de avaliação que não utiliza diário eletrônico em uma turma/disciplina, o diário eletrônico, por padrão, estará sempre encerrado. Não tendo a opção de abri-lo. Por este motivo, a rotina de Encerramento e Reabertura de diário em lote não exibirá turmas/disciplina com este tipo de critério de avaliação.

3. Controle de disciplinas para turmas que não utilizam grade curricular

O aluno não ficará com ingresso concluído caso possua pendências acadêmicas e financeiras. Para turmas que não utilizam grade curricular são consideradas pendências acadêmicas:

• Pendência de disciplina
• Pendência do Enade
• Pendência de documentos obrigatórios para conclusão do ingresso

As pendências de disciplinas, são definidas no cadastro da turma, aba controle de disciplina: As demais pendências podem ser configuradas conforme documentação: Documentos e Enade

4. Cadastro de Grade Curricular > Controle de disciplinas para turmas que utilizam grade curricular

No cadastro de grades curriculares, é possível realizar as configurações da aba Carga Horária Curricular. Abaixo, seguem as orientações de configurações:

Campos disponíveis:

• Tipo: deve-se informar qual tipo de componente curricular terá configurações de controle.
  
• Controle com base em: deve-se definir qual será a base para controle das disciplinas, se será por número de disciplinas ou por carga horária.
  
• Mínimo exigido: este campo deverá ser preenchido com o mínimo exigido conforme o tipo de controle da disciplina. Para o mínimo em carga horária, deve-se informar o valor em horas-relógio.
  
• Máximo exigido: este campo deverá ser preenchido com o máximo exigido conforme o tipo de controle da disciplina. Para o máximo em carga horária, deve-se informar o valor em horas-relógio.
  
• Total por componente: campo apenas para consulta, irá trazer a somatória em horas-relógio do componente curricular.
  
• Agrupador de controle: este campo é utilizado para criar regras de “controle” de mais de um “tipo de disciplina” para a grade. Onde o agrupador de controle for igual, apenas uma das opções é obrigatórias.
  

Exemplo: Ao cadastrar dois tipos de disciplinas para um mesmo agrupador de controle, apenas uma dessas opções será obrigatória.
No exemplo abaixo, foi cadastrado o agrupador de controle 3, e para ele, foram vinculados dois tipos de disciplinas: “Optativa” e “Estágio”. Neste caso, o aluno vinculado a esta grade não precisará cumprir as duas regras, deverá cumprir apenas uma delas.

• Controle por subárea: é possível realizar um controle por subáreas, informando para cada uma delas se este controle será por carga horária ou por número de disciplinas:
  

• Carga horária (atividades complementares): campo onde poderá ser inserido a carga horária das atividades complementares da grade curricular. Será inserido no formato horas-relógio.
  
• Carga horária extensão: campo onde poderá ser inserido a carga horária da extensão da grade curricular. Será inserido no formato horas-relógio.
  
• Carga horária total: campo apenas para consulta, onde trará a somatória dos totais por componente (mínimo exigido), carga horária das atividades complementares e carga horária da extensão.
  
• Carga horária exigida: campo onde poderá ser preenchido em horas-relógio a carga horária a ser exigida efetivamente do aluno, para integralização do curso.
  
• Créditos (atividades complementares): pode-se definir uma quantidade mínima de créditos de atividades complementares que o aluno precisa cumprir.
  
• Créditos extensão: pode-se definir uma quantidade mínima de créditos de extensão que o aluno precisa cumprir.
  
• Nº de créditos: pode-se definir a quantidade de créditos desta grade.
  
• Carga horária presencial: pode-se definir uma carga horária presencial mínima que o aluno precisa cumprir.
  
• Carga horária EAD: pode-se definir uma carga horária EAD mínima que o aluno precisa cumprir.
  

Informações adicionais

O aluno não ficará com ingresso concluído caso possua pendências acadêmicas e financeiras. Para as turmas que utilizam grade curricular, são consideradas pendências acadêmicas:

• Pendência de atividade complementar;
• Pendência de TCC;
• Pendência de estágio;
• Pendência de Enade;
• Pendência de carga horária mínima realizada;
• Pendência de disciplinas obrigatórias;
• Pendência de créditos realizadas;
• Pendência de documentos obrigatórios para conclusão do ingresso.

As pendências de disciplinas, TCC, estágio, atividade complementar e carga horária mínima realizada, podem ser definidas no cadastro da grade curricular, aba controle de disciplina. As demais, podem ser configuradas conforme documentações: Documentos e Enade.

Configurações no Moodle

1. Administração do Site > Plugins > Instalar Plugins > Liberação ao MentorWeb

Pré-requisito:

• Regra de cálculo exclusiva para critério que não utiliza diário eletrônico
• Critério de avaliação com a opção “Utiliza diário eletrônico” desmarcado
• Turmas/disciplinas com critério que não utiliza diário eletrônico

Para o recebimento de médias EAD - Moodle é necessário que um serviço faça essa importação para o Mentor Web, inseri-las como a nota da primeira avaliação do critério de avaliação e realizar o cálculo da média. Sendo assim, foi desenvolvido um plugin que fará este procedimento.

Para instalar o plugin no Moodle, primeiramente baixe-o clicando aqui.

Após baixar o arquivo, acesse o Moodle com perfil de administrador, clique na opção Administração do site > Plugins > Instalar Plugins.

Clique em Escolha um arquivo, selecione o arquivo baixado no inicio e clique em Instalar plugin do arquivo ZIP:

Após isso, o Moodle validará se a instalação pode continuar, clique em Continuar:

O Moodle não exibe nenhuma mensagem de conclusão de instalação, apenas exibe a página inicial.

Feita a instalação, deve-se configurar este plugin.

Com o perfil de Administrador, acesse novamente a opção Administração do site > Plugins.

Nesta aba será exibida a opção Módulos de Atividades. Localize a atividade Liberação ao Mentor Web e clique em Configurações:

Ao abrir esta atividade, será carregada a tela abaixo. Deve-se alterar o parâmetro URL do Mentor Web (URL_MENTOR) para a URL da Instituição:

O restante dos parâmetros não devem ser alterados. Clique em Salvar mudanças após informar URL.

2. Criar tarefa Concluir disciplina

Para que seja possível receber as médias EAD - Moodle, após cadastrar provas e trabalhos no Moodle, deve-se cadastrar uma última tarefa do tipo Liberação ao Mentor Web.

Esta tarefa será responsável por chamar o serviço que envia as médias para o Mentor Web então ela deve ser a última tarefa do aluno. A mesma não deve ter nota, deve-se selecionar tipo de nota Nenhum e sua nomenclatura deve ser instrutiva, de forma que o aluno entenda que é necessário concluir esta tarefa.

No cadastro do Curso, deve-se clicar em “Adicionar uma atividade ou recurso”:

Na aba Todos, deve-se selecionar a opção “Liberação ao MentorWeb”:

Deve-se preencher o campo Nome e na aba Nota, alterar o campo Tipo, selecionando a opção Nenhum:

Após realizar o ajuste acima, deve-se Salvar as alterações. A atividade será exibida como uma atividade ou recurso:

Funcionalidade:

1. Enviar médias EAD para Mentor Web

Quando o aluno concluir todas as provas e trabalhos, a última tarefa a ser respondida será Concluir disciplina, serviço responsável por enviar as médias EAD para o Mentor Web. O Aluno deve clicar na tarefa, onde será solicitado a confirmação da operação.

No Mentor Web a nota será recebida, e o serviço de cálculo da média será disparado. Definindo a Situação/Resultado calculado pelo sistema de acordo com as notas e faltas digitadas e o critério de avaliação configurado.

Conclusão do Ingresso

A conclusão do ingresso do aluno no Mentor Web, não ocorrerá caso o aluno possua pendências acadêmicas ou financeiras.

• Pendências acadêmicas

São consideradas pendências acadêmicas:

• Para turmas que utilizam grade curricular:
  • Pendência de atividade complementar
  • Pendência de TCC
  • Pendência de estágio
  • Pendência de carga goraria mínima realizada
  • Pendência de disciplinas obrigatórias
  • Pendência de créditos feita
  • Pendência de documentos obrigatórios para conclusão do ingresso
  • Pendência do Enade

• Para turmas que não utilizam grade curricular:
  • Pendência de disciplina
  • Pendência do Enade
  • Pendência de documentos obrigatórios para conclusão do ingresso

No procedimento de Concluir disciplinas, após confirmar a finalização do curso, será exibido uma opção para visualizar as pendências de documentos:

• Pendências financeiras

Para pendências financeiras, o sistema vai observar a opção definida nas configurações de subnivel de ensino, opção “Bloqueia emissão de certificação com débitos”, localizada nas configurações do Diploma Digital:

Quando houver pendências financeiras, o Moodle exibirá a seguinte mensagem: “Outra(s) pendência(s). Entre em contato com a instituição para regularizar a sua situação”:

A titulo de curiosidade:

• Quando a disciplina do aluno foi alterada manualmente. Exemplo: Aluno estava dispensado na disciplina X e foi alterado manualmente para cursando, ao disparar a nota do Moodle para o Mentor Web, o sistema não vai alterar sua situação, apenas enviará a nota. Podendo ocorrer a não conclusão do aluno no curso.
• Quando o aluno conclui a tarefa “Concluir disciplina” no Moodle, a nota do aluno sempre é enviada para o Mentor Web, com pendências ou não. Se houver pendências apenas seu ingresso não ficará como concluído, mas as médias serão enviadas.
• A tela de Notas e faltas por aluno permitirá alterar a nota do aluno, mesmo para as turmas que não utilizam diários.
• Quando o aluno concluir o ingresso, o Mentor Web não fará processo de certificação de forma automática.

Documentação técnica

Enviar médias EAD para o Mentor Web

Este serviço receberá um código de turma/disciplina, código do aluno e nota:
1. Ao receber a turma/disciplina, o sistema irá buscar no critério de avaliação dessa turma/disciplina a avaliação de menor ordem que não seja nota calculada;
1. O sistema gravará a nota como média da avaliação encontrada no passo anterior;
2. O sistema calculará a média final para esse aluno e turma/disciplina e atualizar a situação de resultado.

Obs.: Para calcular a média o diário desta turma/disciplina/tipo de nota precisa estar fechado.

Nome do serviço externo: integracaoMediaEAD

Para ver como montar a URL de chamada para esse serviço externo, acesse a página referente à execução de serviços externos clicando aqui.

Parâmetros para chamada do serviço

Exemplo da passagem de parâmetros por Json:

{
  "aluno" : "123456",
  "disciplinas" : [ {
    "idTurmaDisciplina" : "123456",
    "nota" : 1.0
  } ]
}

Exemplo do retorno do serviço em formato Json:

{
 "resultado":"SUCESSO",
 "log": [
   "Mensagem de aviso (opcional)"
   ]
}

Neste caso não houve erro, porém o processo não atendeu uma das validações internas, que é o caso de obrigar todos os diários a estarem fechados no momento de realizar o cálculo de média.

Exemplo do retorno do serviço em formato Json caso ocorra erro no processo:

"resultado":"ERRO",
"erro":
  {
    "operacao":"br.com.edusoft.mentorweb.servico.controller.ServicoExternoAcademicoImplJava.calculaMedia",
    "valores":"{\"parametro1\":29572 , \"alunoId\":4041475 , \"disciplinaId\":2420 , \"recalculaMediasAlteradasManualmente\":0}",
    "motivo":"Mensagem de erro"
  }
}

Para realizar o agendamento automático da integração poderá ser criado um processo utilizando o Mentor Agendador.

Deve-se cadastrar um processo agendado do tipo “Processo Batch” para realizar a integração. Na aba “Processo Batch” do cadastro do processo selecionar o campo “Urls” e adicionar a seguintes ordem de URLs:

http://CaminhoAplicacao/ICoruja/inicial.do?evento=cookie;
http://CaminhoAplicacao/ICoruja/trocaModulo.do?evento=trocaModulo&moduloID=32;
http://CaminhoAplicacao/ICoruja/aca/integrarcomead.do?evento=integracaoMoodle&PERLET=?&CURID=?&TURID=?&DISID=?

Obs.: Se o a aplicação usa HTTPs, troque o “http” para “https”.

• Na ultima URL é aplicado os seguintes filtros:
  1. PERLET: Este filtro é obrigatório, é o período letivo dos cursos que serão integrados..
  2. CURID: Este filtro aplica o curso das turmas que serão integradas.
  3. TURID: Turma que será integrada.
  4. DISID: Disciplina que será integrada.

Obs.: O filtro PERLET é obrigatório.

Informar um usuário e senha validos no sistema.

Para o processo agendamento de integração do Moodle, deve ser feito um usuário especifico para rodar esta rotina.
Este usuário deverá ter um perfil de usuário que tenha permissão apenas no modulo de Graduação, com acesso a todas as telas utilizadas.

Esta tela é utilizada para integrar alunos, turma/disciplina, professores e responsáveis no Moodle.

Quando se usa agrupamento de turmas, as turmas vinculadas a um agrupamento são exibidas normalmente no campo turma.

Exemplo: Criamos um agrupamento chamado “Turmas 3” com as turmas/disciplinas vinculadas:

TurmaA/Administração (13 alunos)
TurmaB/Administração (15 alunos)
TurmaC/Administração (18 alunos)

No campo de seleção de turmas não é apresentado o agrupamento “Turma 3”. São apresentadas as turmas vinculadas “Turma A”, “Turma B” e “Turma C”.
Ao integrar a turma/disciplina que está em um agrupamento, como “Turma A/Administração”, “Turma B/Administração” ou “Turma C/Administração” serão enviados para o Moodle os alunos/professores da turma/disciplina, porém no EAD é apresentado o agrupamento.

Exemplo:

Abaixo para integrar no Moodle selecionamos uma turma/disciplina que está em um agrupamento de turma/disciplina.


Ao integrar, no Moodle é apresentado o agrupamento. No Moodle o agrupamento é apresentado apenas com 13 alunos pois a turma/disciplina integrada tinha esse numero de alunos.


Se for integrada outra disciplina do mesmo agrupamento no Moodle, como a “Turma B/Administração” são adicionados os alunos/professores no agrupamento já adicionado.


Ao integrar todas as turmas/disciplinas do agrupamento, o agrupamento no Moodle vai estar com todos os alunos.
Se ao integrar não for selecionado um filtro de turma e disciplina, o agrupamento será completamente integrado diretamente, integrando às vinculadas no agrupamento.

Informações que são integradas:
Pessoa: Login, senha, nome, e-mail, identificação da pessoa do Mentor Web (id), cidade.
Categoria: Nome da categoria (conforme os níveis configurados), chave (identificação da categoria no Mentor Web)
Curso: Nome conforme configurado, nome curto (código turma / código disciplina), identificação da turma/disciplina, e data inicial da turma/disciplina.
Movimentação: matrícula do aluno e o vínculo do professor no curso.

Obs.: Atente-se como serão divulgados os logins pois o Moodle não aceita letras maiúsculas no login, portanto para entrar no Moodle deverá informar o login em minúsculo.

O processo de Sincronizar Categorias é reponsavél por montar a estrutura de “árvore das categorias”, organizando os níveis enviados pelo Mentor dentro do Moodle. Os níveis de categorias são definidos na tela de Configuração EAD.

Conforme exemplo abaixo, na tela de Configuração EAD > Aba Categorias, foi definido que as categorias a serem sincronizadas seriam: Subnível, Unidade, Período letivo, Curso, Fase e Turma.

Dessa forma, após a sincronização, essas categorias são enviadas para o Moodle, como estrutura de “árvore das categorias”:

Caso a categoria tenha sido criado manualmente no Moodle, na tela de Sincronização de Categoria, é possível preencher o ID de categoria manualmente.

Para realizar a sincronização das categorias, deverá utilizar a rotina que está disponível em “Acadêmico > EAD > Sincronizar categorias” e informar o código da categoria no EAD.

Deve-se inserir no campo de “Código do EAD” o identificador da categoria no Moodle que pode ser visualizado na tela de Gerenciamento de curso e categoria.

Recurso utilizado para sincronizar dados da pessoa cadastrada no Mentor Web para o Moodle.

A Sincronização de Pessoas compara os usuários já existentes no moodle, com os usuários do Mentor, conforme os campos de comparação definidos. Ao identificar pessoas que existam no Mentor e que existam no Moodle, a integração irá realizar a sincronização definindo o código EAD para a pessoa sincronizada.

Os campos de comparação são usados para localizar as pessoas do Mentor e do Moodle, comparando os dados que são iguais entre ambos os sistemas (E-mail, login, primeiro nome, último nome iguais)

Para realizar a sincronização é necessário preencher os seguintes campos:

• Período Letivo deve-se informar o período letivo que será realizada a sincronização.
  
• Curso deve-se informar o curso que será realizada a sincronização.
  
• Turma deve-se informar a turma que será realizada a sincronização.
  
• Disciplina deve-se informar a disciplina que será realizada a sincronização.
  
• Somente pessoas que não foram encontradas quando marcada, serão exibidas somente pessoas que não foram encontradas no Moodle.