Interfaces de Gestão de Integração de Matrículas

Nesta seção, apresentaremos as interfaces de gestão da matrícula, incluindo o mapeamento de sincronização de perfis e os dados relacionados ao processo de matrícula. Para fins de demonstração, utilizaremos o módulo GC2. O processo de gestão e sincronização da matrícula nesse módulo é semelhante ao realizado no módulo SGA.

1 - Mapeamento das Chaves dos Perfis de Matrícula

A plataforma Moodle, por padrão, oferece um conjunto de chaves e identificadores de perfis de matrícula. Essas chaves identificam perfis como aluno, tutor, professor e gerente. Além dessas chaves padrão, que já vêm configuradas na instalação inicial, é possível criar novas chaves para identificar outros perfis adicionais, conforme a necessidade.

A tabela a seguir ilustra as chaves de identificação padrão para os principais perfis do Moodle:

Na plataforma Badiu.Net, essas chaves são mapeadas e cadastradas para cada perfil equivalente no módulo GC2. O painel responsável por esse mapeamento pode ser acessado no seguinte endereço: BADIUNET_URL/tms/role/index. Ao acessar esse endereço, será exibido o mapeamento de cada perfil, conforme ilustrado na figura abaixo.

Como mostrado na figura, para cada perfil de inscrição definido no GC2, é associado um perfil equivalente na plataforma Moodle, utilizando a chave padrão de identificação. Essa configuração é utilizada para definir o perfil com o qual a matrícula será sincronizada, ou seja, replicada na instância da plataforma Moodle.

2 -  Mapeamento dos Status da Matrícula

Na plataforma Moodle, as inscrições podem ter status ativo ou inativo. Inscrições com status ativo são matrículas que têm acesso ao conteúdo e podem realizar as atividades do curso, enquanto as inativas indicam que a inscrição está cancelada.

A camada de sincronização das matrículas, no nível da plataforma Badiu.Net, precisa considerar essa configuração ao efetuar a replicação. O Moodle possui um registro bastante simplificado do status das matrículas: elas podem estar ativas (habilitadas) ou suspensas (desabilitadas). Já no módulo GC2, há vários tipos de status, que podem se equivaler a habilitado ou desabilitado no Moodle, por exemplo: cursando, inativo, desligamento por aprovação, desligamento por processo administrativo, desligamento por reprovação, etc. Para cada status no módulo GC2, é preciso atribuir uma classificação que será utilizada no processo de replicação das matrículas no Moodle.

Há um painel de gerenciamento dessa classificação no módulo GC2, acessível pelo link: BADINET_URL/tms/enrol/status/index.

Ao acessar esse link, o painel de gerenciamento será exibido, conforme ilustrado na figura a seguir.

Nesse painel, para cada status é possível definir se ele será considerado ativo ou inativo no Moodle. Além disso, há uma classificação que determina se o aluno poderá ou não acessar o Moodle, dependendo do status atribuído.

Essa classificação é carregada no momento da sincronização das matrículas no curso do Moodle, determinando se a matrícula deve ser ativada ou inativada.

3 - Configurar Sincronização no Nível da Turma

Nesta seção, vamos explorar como a sincronização da matrícula pode ser configurada no nível da turma. Trata-se de demonstrar as variáveis que devem ser manipuladas ao criar uma turma no GC2 para habilitar o processo de sincronização com a plataforma Moodle. Essa mesma regra se aplica a outras instâncias que sincronizam matrícula com o Moodle, como a sincronização no nível da oferta ou da disciplina usando módulo SGA.

No módulo GC2, para criar uma turma é necessário navegar até um curso específico; a partir desse curso, gerencia-se o cadastro da turma. Para acessar a lista de cursos, basta navegar até BADIUNET_URL/tms/discipline/index e, em seguida, adicionar uma nova turma no curso desejado.

No formulário de cadastro da turma, existem duas abas que merecem atenção no que diz respeito ao processo de sincronização. A primeira é a aba de configuração da matrícula. A figura a seguir ilustra os campos que compõem essa aba.

Os campos ilustrados na figura são atributos de configuração de inscrição no módulo GC2. As configurações disponíveis nos campos Replicar cadastro da matrícula, definem se a matrícula deve ou não ser replicada na plataforma Moodle. Essa configuração é fundamental para habilitar o processo de sincronização.

Além dessas configurações, há outra aba que também deve ser ajustada: a aba de integração com a plataforma Moodle, conforme ilustrado na figura a seguir.

Para melhor compreensão desta aba, a tabela a seguir explica alguns dos campos apresentados.

A tabela acima especifica a lógica de ligação de uma turma no GC2 à sua instância equivalente no Moodle, que pode ser um curso (sala de aula) ou um grupo dentro de uma sala de aula.

Nesta aba, define-se a instância do curso na plataforma Moodle na qual as inscrições serão efetivadas. Essa integração é essencial para que a camada de sincronização de inscrições funcione adequadamente. Ou seja, ao realizar uma inscrição em uma turma no GC2, a mesma inscrição deve ser replicada no curso do Moodle, conforme mapeado no processo de cadastro da turma.

Para mapear, no GC2, todas as turmas em que a configuração com a plataforma Moodle foi habilitada, basta navegar até o endereço BADIUNET_URL/tms/offer/classeg/synclms/index. Feito isso, será exibido um relatório de configuração de todas as turmas, conforme ilustra a figura a seguir.

A figura acima mostra as turmas configuradas no GC2 e as suas correspondentes vinculadas no Moodle. Isso significa que qualquer inscrição realizada nas turmas do GC2 será replicada na turma equivalente no Moodle.

4 -  Falha na Sincronização de Matrícula

O processo de sincronização da matrícula vem registrando algumas falhas. Quando o aluno acessa a plataforma Moodle, ele recebe a mensagem de que não está inscrito no curso. Isso geralmente ocorre devido a falhas na sincronização de matrícula.

Esse erro costuma acontecer quando a sincronização do usuário já foi efetivada, no entanto, a sincronização da matrícula não foi realizada. O cenário típico em que isso ocorre é quando o aluno é alocado na turma no módulo de GC2, mas a replicação no Moodle falha. A falha pode ocorrer por diversos motivos. O mais comum é o serviço da plataforma Moodle estar indisponível ou sobrecarregado, não realizando a operação solicitada.

Quando isso acontece, a solução atual é o administrador do sistema acessar a turma no GC2 e editar a matrícula do usuário com problema, forçando assim uma nova sincronização com o Moodle. Para isso, deve-se acessar o endereço BADIUNET_URL/tms/enrol/classe/index para visualizar o relatório geral da matrícula, conforme ilustrado na figura a seguir.

Nesta tela, basta pesquisar a matrícula do aluno que apresentou o problema e clicar no ícone de edição.

Feito isso, será exibido o formulário de inscrição.

Nesse formulário, verifique se a configuração de matrícula está habilitada para replicação no Moodle e, em seguida, clique no botão Alterar. Concluída essa ação, a matrícula será replicada novamente, caso a replicação anterior tenha falhado.

A alternativa de automatizar a solução deste problema — ou seja, mapear a falha de sincronização da matrícula no momento em que ocorre, registrá-la no log e processá-la em segundo plano (via cron) ou automaticamente quando o usuário acessar o sistema — já está no backlog. A implementação está prevista para o primeiro semestre de 2025.