MÓDULO DE MATRICULA UNASUS Guia de Instalação e Configuração (Moodle 2.x) Resumo Este documento lista o fluxo para aquisição do modulo de matricula, geração de chaves para acesso ao webservice do Arouca e a respectiva configuração do Moodle.
Histórico de Revisões Data Versão Autor Descrição 1.0 Salvador Melo, Versão inicial Márcio Batista, Lino Muniz, Ricardo Zago 23/04/2013 1.5 Salvador Melo, Adequações no documento Márcio Batista, Lino Muniz, Ricardo Zago 16/07/2013 1.6 Heider Maciel Adequações no documento para a versão 2.5 do Moodle 24/07/2013 1.65 Heider Maciel Adequações no documento para a versão 2.5 do Moodle 27/11/2013 1.7 Márcio Batista/ Revisão do manual Salvador 1
Sumário 1 Histórico da Solução... 3 2 Requisitos necessario... 3 2.1 Requisitos para Instalação do módulo de matrícula... 3 2.2 Adquisição do módulo de matrícula... 4 3 Instalação e Configuração do Módulo de Matricula no Moodle... 4 3.1 Instalação do plug-in... 4 3.2 Configuração do módulo de Matricula... 7 3.3 Configuração do arquivo config.php... 7 3.4 Cadastrando regra da matrícula... 7 3.5 Modo de processamento... 9 3.6 Configurações de mensagens... 10 3.7 Configuração da função Cron... 12 3.8 Matrícula manual... 13 3.9 Campos de perfil... 14 4 Seleção do módulo de matricula no curso... 14 2
1 Histórico da Solução Os cursos oferecidos pelo Sistema UNA-SUS são desenvolvidos por Instituições de Ensino Superior de excelência do país e têm enfoque prático, baseado no dia a dia de trabalho dos profissionais do SUS e nas suas reais necessidades, ofertados na modalidade a distância, tendo o Moodle como plataforma de oferta dos mesmos. Médicos, enfermeiros, dentistas, agentes comunitários de saúde, gestores, entre outros trabalhadores do SUS, são certificados em diversos níveis de capacitação, de acordo projeto pedagógico de cada curso. Para que a matrícula pudesse ser feita de forma automática, foi necessário desenvolver um módulo de matrícula para o Moodle, que se conecta à plataforma Arouca, via WebService e é capaz de realizar consultas pelo CBO (Classificação Brasileira de Ocupações) dos usuários utilizando essa base de dados. A principal funcionalidade desse módulo é aceitar ou recusar as solicitações de matrícula em um curso disponibilizado no Moodle, tendo como critério o CBO dos usuários. O filtro de matrícula por CBO garante que apenas as categorias de profissionais, que constituem o público alvo, tenham a sua solicitação de matrícula aceita. Hoje, esse módulo de matrícula é utilizado por 16 instituições de ensino e pesquisa, ligadas ao Sistema UNA-SUS, distribuídas por todo o Brasil. O módulo de matrícula UNA-SUS foi desenvolvido inicialmente para a versão 1.9.x do Moodle, porém atualmente o referido módulo, também suporta as verões 2.3.x, 2.4.x e 2.5.x do Moodle. 2 Requisitos necessario 2.1 Requisitos para Instalação do módulo de matrícula O sistema de login da sua plataforma moodle deverá esta integrado a federação ou os campos id number e ou user name, padrões do moodle, deverá ser preenchido com o CPF dos usuários da plataforma. Certificado digital adquirido junto a equipe da Plataforma Arouca. Obrigatoriamente, o órgão deverá criar dois certificados SSL com chave privadas diferentes. Um para acesso ao ambiente de homologação e outro para acesso ao ambiente de produção da plataforma Arouca. Para saber como gerar os certificados SSL. Somente depois da geração siga os demais passos deste guia. Cada ambiente possui uma CA (Autoridade Certificadora) diferente. Ambas servem apenas para autenticação do Web Service. Primeiramente o órgão deve solicitar assinatura para o certificado de acesso ao ambiente de homologação, a fim de fazer testes de inserção e pesquisa pelos métodos do Web Service Arouca. Finalizado os testes, o órgão deve solicitar outra assinatura de certificado para acesso ao ambiente de produção. Para marres informação contate o suporte técnico https://sistemas./suporte/ 3
2.2 Adquisição do módulo de matrícula Para obter o módulo de matrícula, você deve ter acesso ao GT de TI da Secretaria Executiva da UNA-SUS, no endereço abaixo indicado. https://moodle./comunidades/mod/data/view.php?id=453 Caso você não tenha um cadastro nesse ambiente, favor contactar nosso suporte e solicitar o acesso através deste endereço e solicite acesso para obtenção do modulo: https://sistemas./suporte/ 3 Instalação e Configuração do Módulo de Matricula no Moodle A instalação do módulo de matricula segue o procedimento padrão de instalação de outros módulos na Plataforma Moodle. 3.1 Instalação do plug-in Para efetuar a instalação siga estes passos: De posse do arquvo unasus.zip baixado confome descrito em 2.2 Adquisição do módulo de matrícula descrito na página 4, acesse o moodle como administrador e selecione no bloco Administrador do site a opção: Plug-ins - Instalar o complemento conforme a tela abaixo: 4
Figura 1:tela de instalação do plugin. Selecione a opção Método de inscrição (enrol) em Tipo do Plugin ; Na opção Pacote ZIP clique em Escolha um arquivo... e selececione o arquivo unasus.zip ou arraste o arquivo para área quadriculada; Clique em Instalar o complemento do arquivo ZIP ; Caso você esteja usando a versões 2 do moodle e mesma seja inferior a 2.5, ou seja, 2.3 ou 2.4, você poderá realizar a instalação tradicional seguindo estes passos: Descompacte os o arquivos unasus.zip dentro da pasta \enrol na raiz do moodle; Após descompartar oquivo unasus.zip acesso o moodle como adminstrador e no menu administraçaõ do site clica sobre a opção avisos; 5
Figura 2:tela da opção avisos. Clique em Instalar o complemento e a tela abaixo será apresentada: Figura 3: tela para instalar o complemento. Ative o módulo Sistema de Matricula UNA-SUS clicando em. Clique na opção Configurações a tela abaixo será exibida: 6
3.2 Configuração do módulo de Matricula Figura 4: tela de acesso ao Sistema de Matricula UNA-SUS. A instalação foi finalizada no moodle. Agora clique em Sistema de Matricula UNA-SUS para cadastrar as regras conforme o item 3.3 Cadastrando regra da matrícula na página 7. 3.3 Configuração do arquivo config.php Após a instalação do modulo, independe da forma de instalação adotado, para que o mesmo funcione corretamente serão necessários renomear o arquivo config_dist.php para confg.php; editar o arquivo confi.php; Este procedimento só poderá ser realizado pelo administrador do servidor, caso você seja apenas administrador do moodle, deverá entra em contato com o administrador do seu servidor para que ele possa configura o referido arquivo. Obs.: você não pode deixar de renomear o arquivo config_dist.php, caso contrário sua conexão com a plataforma Arouca não será estabelecida. Para configurar o arquivo config.php será necessário primeiramente a obtenção do certificado digital junto a equipe da plataforma Arouca. Caso tenha alguma dificuldade para obter o referido certificado, entre em contato com a UNA-SUS, pelo sistema de suporte técnico abaixo indicado. https://sistemas./suporte 3.4 Cadastrando regra da matrícula Atualmente, só é possível definir regra de matrícula com base no CBO. A regra do CBO consiste em definir uma lista de códigos CBO s como requisito para matrícula. Quando um usuário tenta se matricular em um curso, o sistema faz uma consulta à plataforma Arouca, verificando se o usuário possui CBO válido para matrícula. Se houver, a matrícula será efetivada, caso contrário, será negada. 7
Para cadastrar a regra de matrícula, acesse o menu Regra da Matrícula do módulo, e selecione uma opção para definir a regra. Figura 5: tela de cadastramento das regras de matrícula. As regras de matrícula podem ser cadastradas nos níveis: Contexto do sistema: as regras se aplicam para todas as categorias e cursos; Categoria de cursos: as regras se aplicam em nível de categoria, ou seja, se aplica apenas aos cursos vinculados às categorias específicas; Contexto de curso: neste contexto podemos configurar as regras de matrícula apenas para um curso específico. Após escolher os contextos desejados, clique na opção Cadastrar na coluna Regra de Matrícula. Na tela de configuração da regra de matrícula, a parte mais importante, e que requer bastante atenção, é o campo CBO. Nele deverá ser inserido o código de Classificação Brasileira de Ocupações CBO s dos profissionais que terão a sua solicitação de matrícula permitida no curso. 8
Figura 6: tela para edição das regras de matrícula. Você deve ter observado na Figura 6 acima que alguns códigos possuem XX no final. Os casos dos CBOs com XX no final se trata da seguinte situação, o código 225151 representa a profissão Médico anestesiologista e código 225122 Médico cancerologista pediátrico. Ao inserir no campo de regra de matricula do módulo o código 2251XX (onde XX substitui os dois últimos digitos) o sistema matriculará em um curso tanto o Médico anestesiologista quanto o Médico cancerologista pediátrico. A mesma regra se aplica às demais profissões. Após definir as regras de matrícula, clique na opção Salvar. 3.5 Modo de processamento O Módulo unasus permite três tipos de processamento: manual, automático e manual-automático. Manual: essa opção só permite matricula manual, onde o administrador do moodle deverá efetivar as matriculas manualmente atraves do módulo de matrícula; Automático: essa opção permite apenas as matriculas automáticas, não permitindo que o administrador do moodle possa ralizar matricuals manuais atraves do modulo; Manual automático: essa opção é a mais recomendada, pois matricula os usuários automaticamente, com base nas regras de matricula, mas também permite que o administrador realize, excepcionalmente, matriculas manuais através do módulo de matrícula. 9
Figura 7: tela de escolha do tipo de processamento. Para selecionar uma das opções listadas, clique na aba configurações, em seguida no modo de processamento e por último em cadastrar. Selecione um dos modos, manual, automático ou manual- automático. 3.6 Configurações de mensagens A configuração de mensagens é obrigatória e sem esta o módulo não funcionará. Há vários tipos de mensagens que são exibidas na tela e enviadas por e- mail durante o processo de matrícula. As mesmas devem ser configuradas no contexto em que a regra foi definida: Contexto do sistema, Categoria de cursos ou Contexto de curso. Observação: a mensagem não pode ser definida em um contexto diferente do que foi definido para a regra de matricula. Clique sobre o contexto e cadastre as mensagens conforme figura abaixo. Mensagem de Apresentação: o texto deste campo é apresentado ao aluno que ira tentar se matricular no curso, aqui pode ser apresentado a ele os requisitos necessários para se matricular no mesmo; Mensagem de Aprovação: texto apresentado ao aluno que passou pelo filtro do módulo de matrícula e conseguiu se matricular no curso; Mensagem de Rejeição: texto que que é apresentado ao usuário quando ele tem a sua matrícula recusada por não atender os requisitos (naõ possui CBO compativél na base da Plataforma Arouca). É importante nesta mensagem deixar algum endereço de contato, email, telefone, etc. Dessa forma, caso algum aluno se sinta prejudicado, por julgar que atende aos requisistos de matricula e mesmo assim teve a matrícula recusada, ele poderá entrar em contato, via suporte técnico, e apresentar comprovantes e assim ter a sua matricula efetivada de forma manual pelo administrador do Moodle; Mensagem de Revisão Automática: caso um usuário tenha a sua matricula recusada, seja por falha de conexão com a Plataforma Arouca ou por desatualização entre a base de dados do CNES e a referida plataforma, posteriormente o módulo de matrícula tentará matricular novamente de forma automática os usuários anteriormente recusados (para isso a função reprocessamente 10
automatico tem que ser configurada). Assim que o módulo de matrícula identicar que o referido usuário passou a atender os requisitos, o mesmo efetivará a matrícula. Nesse caso, o usuário receberá receberá a mensagem desse campo, informando ao referido aluno que sua matrícula foi reprocessada e que o mesmo foi aceito no curso; Mensagem de revisão manual : neste campo você deve escrever apenas a frase com justificativa para a matrícula manual conforme exelmplo: {justificativa}. Com isso o sistema enviará para os usuários a justificativa que é inserida no momento da realização da matricula manual. Figura 8: definição do contexto desejado e cadastramento das mensagens. 11
3.7 Configuração da função Cron Figura 9: visualização das mensagens. A configuração da função Cron é necessária caso o modo de processamento automático ou manual/automatico seja habilitado. O uso do cron possibilita que o módulo de matrículas reprocesse as matrículas recusadas nos casos: Erro de conexão com Arouca, CBO não conste na Plataforma Arouca, Não existe nenhuma regra de inscrição cadastrada na base de dados ou o CBO não consta na lista de requisitos. Para efetuar essa configuração, acesse o módulo de matricula e clique no menu Configuração -> Cron. Em seguida, escolha um contexto (sistema, categoria, curso). Lembrando que o contexto dever ser o mesmo no qual você cadastrou as regras de matricula. Outra coisa a ser definida é o Intervalo de processamento. Essa configuração define o intervalo de tempo, em horas, que o cron de revisão da matrícula deve ser processado. Se não for definido nenhum valor ou se for definido o valor zero, o processamento ficará desabilitado. Se for definido um valor acima de zero, a funcionalidade do cron relativo à revisão da matrícula será executada sempre com a carência do valor definido. Por exemplo: se for definido intervalo de 12 horas, a execução será feita duas vezes ao dia. A configuração deste intervalor de tempo dever ser igual ou superior a rotina do cron do seu Moodle. Caso não tenho conhecimento deste intervalo de tempo se informe com o administrador do servidor. Figura 10: tela de configuração do cron 12
3.8 Matrícula manual O processo de matrícula manual foi pensado para casos específicos em que uma matrícula tenha sido recusada através do processo automático. Porém, a função só poderá ser usada caso a matrícula tenha sido recusada pelo processo automático. Nesses casos, o administrador da plataforma Moodle poderá acessar o módulo e realizar a matrícula do usuário manualmente, clicando na aba de pesquisa e localizando o usuário desejado. Use o campo de busca (usuário) ou os demais filtros para localizar a pessoas a qual pretende realizar a matricula manual. Figura 11: tela de localização Após localizar o usuário desejado, clique sobre o número do ID e uma nova janela será aberta conforme figura abaixo. Figura 12:tela de justificativa para a matrícula manual. 13
Insira uma justificativa para a matrícula manual e clique em Salvar. Com isso, o usuário será matriculado no curso e receberá um email de confirmação com o texto inserido na justificativa. Observação: ficará registrada no sistema a justificativa e o nome da pessoa que realizou a matrícula manual, bem como data, hora e o curso em que a matricula foi realizada. 3.9 Campos de perfil A função campos de perfil foi desenvolvida para coletar dados de usuários para fins estatísticos no momento da matrícula. Ao clicar na aba configurações do módulo de matrícula, você poderá criar uma categoria e adicionar um item escolhendo a opção na caixa de seleção. Os itens a serem criados para o formulário serão os mesmos do formulário padrão do Moodle com as opções de campo: caixa de seleção, menu de escolha, texto de entrada e área de texto. Observação: o formulário para coleta de dados não é obrigatório. O plugin pode ser usado sem essa função configurada. 4 Seleção do módulo de matricula no curso Acesse o ambiente do seu curso como Administrador e selecione Usuários no bloco Administração e em seguida selecione Método de Inscrição Selecione a opção Sistema de Matricula UNA-SUS ; Nomeie o método e clique em Adicionar metodo 14