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
1.0
23/04/2013
1.5
16/07/2013
1.6
24/07/2013
1.65
27/11/2013
1.7
Autor
Salvador Melo,
Márcio Batista,
Lino
Muniz,
Ricardo Zago
Salvador Melo,
Márcio Batista,
Lino
Muniz,
Ricardo Zago
Heider Maciel
Descrição
Versão inicial
Adequações no documento
Adequações no documento para a versão 2.5
do Moodle
Heider Maciel
Adequações no documento para a versão 2.5
do Moodle
Márcio Batista/ Revisão do manual
Salvador
Campus Universitário Darcy Ribeiro Av. L3 Norte
Gleba A, SC 04 | CEP 709010-970
1
Fone: +55 (61)3329-4598 | Fax: +55 (61)3329-4590
unasus.gov.br
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
Campus Universitário Darcy Ribeiro Av. L3 Norte
Gleba A, SC 04 | CEP 709010-970
2
Fone: +55 (61)3329-4598 | Fax: +55 (61)3329-4590
unasus.gov.br
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.unasus.gov.br/suporte/
Campus Universitário Darcy Ribeiro Av. L3 Norte
Gleba A, SC 04 | CEP 709010-970
3
Fone: +55 (61)3329-4598 | Fax: +55 (61)3329-4590
unasus.gov.br
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.unasus.gov.br/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.unasus.gov.br/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:
Campus Universitário Darcy Ribeiro Av. L3 Norte
Gleba A, SC 04 | CEP 709010-970
4
Fone: +55 (61)3329-4598 | Fax: +55 (61)3329-4590
unasus.gov.br
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;
Campus Universitário Darcy Ribeiro Av. L3 Norte
Gleba A, SC 04 | CEP 709010-970
5
Fone: +55 (61)3329-4598 | Fax: +55 (61)3329-4590
unasus.gov.br
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:
Campus Universitário Darcy Ribeiro Av. L3 Norte
Gleba A, SC 04 | CEP 709010-970
6
.
Fone: +55 (61)3329-4598 | Fax: +55 (61)3329-4590
unasus.gov.br
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.unasus.gov.br/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.
Campus Universitário Darcy Ribeiro Av. L3 Norte
Gleba A, SC 04 | CEP 709010-970
7
Fone: +55 (61)3329-4598 | Fax: +55 (61)3329-4590
unasus.gov.br
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.
Campus Universitário Darcy Ribeiro Av. L3 Norte
Gleba A, SC 04 | CEP 709010-970
8
Fone: +55 (61)3329-4598 | Fax: +55 (61)3329-4590
unasus.gov.br
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.
Campus Universitário Darcy Ribeiro Av. L3 Norte
Gleba A, SC 04 | CEP 709010-970
9
Fone: +55 (61)3329-4598 | Fax: +55 (61)3329-4590
unasus.gov.br
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 email 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
Campus Universitário Darcy Ribeiro Av. L3 Norte
Gleba A, SC 04 | CEP 709010-970
10
Fone: +55 (61)3329-4598 | Fax: +55 (61)3329-4590
unasus.gov.br
•
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.
Campus Universitário Darcy Ribeiro Av. L3 Norte
Gleba A, SC 04 | CEP 709010-970
11
Fone: +55 (61)3329-4598 | Fax: +55 (61)3329-4590
unasus.gov.br
Figura 9: visualização das mensagens.
3.7 Configuração da função Cron
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
Campus Universitário Darcy Ribeiro Av. L3 Norte
Gleba A, SC 04 | CEP 709010-970
12
Fone: +55 (61)3329-4598 | Fax: +55 (61)3329-4590
unasus.gov.br
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.
Campus Universitário Darcy Ribeiro Av. L3 Norte
Gleba A, SC 04 | CEP 709010-970
13
Fone: +55 (61)3329-4598 | Fax: +55 (61)3329-4590
unasus.gov.br
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”
Campus Universitário Darcy Ribeiro Av. L3 Norte
Gleba A, SC 04 | CEP 709010-970
14
Fone: +55 (61)3329-4598 | Fax: +55 (61)3329-4590
unasus.gov.br