Ir para o conteúdo
VCOSTAEDU, página inicial

Integração com o Moodle.

O VCOSTAEDU mantém o Moodle da instituição atualizado com o que a secretaria registra. A ligação é feita por um plugin instalado no Moodle, que prepara o site e entrega o endereço e a chave que o VCOSTAEDU usa.

Miniatura da tela: o portal do aluno, com o botão Entrar no Moodle

O que a integração faz

O plugin no Moodle

O plugin local_vcostaedu é instalado como qualquer plugin do Moodle, pelo envio do pacote em Administração do site > Plugins > Instalar plugins. Depois, a página Conectar ao VCOSTAEDU confere item por item o que a integração precisa e corrige o que falta.

Tela redesenhada para leitura no celular.

A página "Conectar ao VCOSTAEDU"O diagnóstico confere cada item da integração e diz a situação e o que fazer: os web services, o protocolo REST, o usuário de serviço, o papel com as 29 permissões, o serviço com as 17 funções, a autorização e a chave. A imagem mostra a página com todos esses itens em Certo, o estado a que levam os botões de correção da própria página quando falta algo.Ver a tela inteira em tamanho real

Tela redesenhada para leitura no celular.

A correção pelos botõesQuando falta algo, a página lista os passos na ordem e oferece um botão para cada um. Cada botão pede confirmação antes de mudar algo, e "Corrigir papel e serviço" só acrescenta o que falta, sem apagar nada.Ver a tela inteira em tamanho real

Tela redesenhada para leitura no celular.

Os dados para colar no VCOSTAEDUCom tudo certo, a página mostra o endereço do Moodle e a chave, cada um com o botão Copiar. A chave fica escondida na tela e só aparece pelo botão de mostrar.Ver a tela inteira em tamanho real

O que o plugin cria no Moodle

  • Um serviço web chamado "VCOSTAEDU", com as 17 funções que a integração usa, liberado só para usuários autorizados.
  • Um papel, vcostaedu_ws, com as 29 permissões que essas funções exigem e mais nenhuma.
  • Um usuário de serviço, também vcostaedu_ws, com esse papel, uma senha que ninguém conhece e um e-mail que não recebe mensagens.
  • Uma chave de acesso, gerada pelo administrador na página do plugin e colada no VCOSTAEDU, onde fica guardada cifrada.

O que o plugin não faz

  • Não liga os web services sozinho: o administrador do Moodle decide, pelo botão da página.
  • Não envia dados a servidor nenhum: é o VCOSTAEDU que chama o Moodle, nunca o contrário.
  • Não muda as configurações de e-mail nem de inscrição do Moodle.
  • Não guarda dado pessoal em tabelas próprias.
  • Não abre sessão por link para administradores do site, visitantes nem para a conta de serviço, e nunca gera link para conta suspensa, excluída, não confirmada ou bloqueada.

Ao ser desinstalado, o plugin remove o serviço com as suas chaves, os links de entrada pendentes e o papel e o usuário que ele criou.

Compatibilidade e licença

A integração é compatível com o Moodle 4.5 a 5.3. O plugin foi testado nas versões 4.5.16, 5.0.12, 5.1.9, 5.2.5 e 5.3.1, com MySQL, MariaDB ou PostgreSQL, e não depende de outro plugin nem de ferramenta de linha de comando.

O plugin é distribuído sob a licença GNU GPL, versão 3 ou posterior, a mesma família de licenças do Moodle, em dois pacotes: um só em inglês e outro com os textos em português.

Quando o Moodle está indisponível

Se o Moodle estiver indisponível, o cadastro é preservado e o envio aguarda em fila, com o motivo de cada falha descrito em linguagem clara.

A gravação acadêmica nunca depende do Moodle: a matrícula, a nota e a enturmação ficam gravadas no VCOSTAEDU, e o envio é anotado depois. A tela Envios ao Moodle mostra cada envio com a situação, o motivo e o que fazer, e oferece "Tentar de novo" em cada linha e "Enviar tudo o que falta", que segue em passos curtos com a janela de andamento.

Tela redesenhada para leitura no celular.

Envios ao MoodleQuando o aluno já tem conta suspensa no Moodle, o sistema liga a conta existente, registra o envio com aviso e informa o que fazer e quem deve fazer.Ver a tela inteira em tamanho real

Tela redesenhada para leitura no celular.

A entrada do aluno pelo portalNo portal, o cartão do Moodle leva às disciplinas do aluno no Moodle, sem uma segunda senha.Ver a tela inteira em tamanho real