Integração com o Ambiente Virtual...

16

Transcript of Integração com o Ambiente Virtual...

Page 1: Integração com o Ambiente Virtual desag1.gvdasa.com.br/docs/downloads/Manuais/Integrações...Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 4 1. Apresentação
Page 2: Integração com o Ambiente Virtual desag1.gvdasa.com.br/docs/downloads/Manuais/Integrações...Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 4 1. Apresentação

Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 2

Integração com o Ambiente Virtual de

Aprendizagem Moodle

Page 3: Integração com o Ambiente Virtual desag1.gvdasa.com.br/docs/downloads/Manuais/Integrações...Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 4 1. Apresentação

Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 3

Sumário

1. Apresentação .................................................................................................................... 4

1.1. O Moodle .......................................................................................................................... 4

1.2. Objetivo da integração ..................................................................................................... 4

1.3. Recursos da integração .................................................................................................... 4

2. Instalação dos plugins de integração no Moodle ............................................................ 5

3. Configuração da integração no Moodle .......................................................................... 6

3.1. Autenticação GVcollege ................................................................................................... 6

3.2. Inscrição GVcollege ........................................................................................................... 7

3.3. Parâmetros da integração ................................................................................................ 8

3.3.1. Autenticação do ambiente ............................................................................................... 8

3.3.2. Criação e categorização dos cursos .................................................................................. 8

3.3.3. Atribuição de funções ....................................................................................................... 9

3.3.4. Logs de sincronização ..................................................................................................... 10

4. Configuração da integração no Portal GVcollege .......................................................... 11

4.1. Base de dados ................................................................................................................. 11

4.2. Geral ................................................................................................................................ 12

4.3. Exportação automática de turmas ................................................................................. 13

5. Exportação manual de turmas para o Moodle .............................................................. 14

6. Acesso ao ambiente Moodle pelos Portais ................................................................... 15

7. Agendamento da tarefa de sincronização automática ................................................. 16

Page 4: Integração com o Ambiente Virtual desag1.gvdasa.com.br/docs/downloads/Manuais/Integrações...Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 4 1. Apresentação

Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 4

1. Apresentação

1.1. O Moodle

O Moodle é um ambiente de aprendizado virtual que oferece diversos recursos

como disponibilização de material e conteúdo de aulas, chats, fóruns de discussão, aplicação e

controle de avaliações, troca de mensagens e registro de aprendizado entre alunos e

professores, entre outros.

O ambiente não possibilita somente o ensino à distância, mas também serve

como apoio ao ensino presencial, e pode ser utilizado tanto por pequenas, médias ou grandes

instituições de ensino, sejam voltadas à educação básica, cursos técnicos ou ensino superior.

1.2. Objetivo da integração

Possibilitar a integração do ambiente de aprendizado virtual Moodle com o ERP

GVcollege, facilitando a utilização dos recursos oferecidos pela ferramenta, aos professores e

alunos, através da sincronização de dados do ERP.

1.3. Recursos da integração

• Autenticação centralizada: Os dados de acesso utilizados por alunos e

professores serão únicos, centralizados no ERP GVcollege.

• Exportação de turmas: O professor terá disponível, no portal, a

ferramenta de exportação de turmas para o Moodle. Também será

possível utilizar a exportação automática por curso.

• Exportação da programação de aulas: O professor terá disponível, no

portal, a ferramenta de exportação da sua programação de aula, que irá

gerar um novo tópico no Moodle para cada dia programado.

• Sincronização automática individual: A cada acesso do aluno ou

professor realizado no Moodle, seus dados poderão ser sincronizados.

• Sincronização automática agendada: Através de uma tarefa agendada,

todas as turmas, alunos e professores poderão ser sincronizados

automaticamente.

Page 5: Integração com o Ambiente Virtual desag1.gvdasa.com.br/docs/downloads/Manuais/Integrações...Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 4 1. Apresentação

Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 5

2. Instalação dos plugins de integração no Moodle

A integração entre Moodle e GVcollege ocorre com o auxílio de plugins, criados

especificamente para este ambiente de aprendizagem virtual.

Para realizar a instalação, será necessário copiar um conjunto de arquivos e

diretórios, que podem ser encontrados no local onde o Portal GVcollege foi instalado,

disponíveis em <raiz do portal>/modulos/moodle, para a raiz da instalação do Moodle. O

conteúdo a ser copiado pode ser visto na imagem abaixo:

Page 6: Integração com o Ambiente Virtual desag1.gvdasa.com.br/docs/downloads/Manuais/Integrações...Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 4 1. Apresentação

Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 6

3. Configuração da integração no Moodle

3.1. Autenticação GVcollege

O primeiro passo a ser seguido é a configuração da Autenticação GVcollege,

devendo primeiramente ser habilitada através do menu Administração > Usuários >

Autenticação > Gerenciar Autenticação, clicando sobre o ícone da coluna Ativar, conforme

imagem:

Após ativar esta autenticação, deverá ser feita sua configuração, conforme

exemplo na imagem que segue, de acordo com os campos, explicados mais adiante.

Page 7: Integração com o Ambiente Virtual desag1.gvdasa.com.br/docs/downloads/Manuais/Integrações...Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 4 1. Apresentação

Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 7

• WSDL: URL do WebService do Portal GVcollege, configurada no formato:

http://<endereço do servidor>/portal/services/integracaoMoodle.php5?wsdl

• Sincronizar: Indicador do tipo de sincronização a ser feita quando o usuário autenticar-se

no Moodle, podendo ser nenhuma (não sincronizar), somente de dados pessoais ou dados

pessoais e matrículas/vínculos com as turmas.

• Bloquear campos de usuário: Esta configuração, realizada para cada campo

individualmente, irá indicar se o usuário poderá alterar a informação no Moodle sempre

(desbloqueado), somente quando não for importada do GVcollege (desbloqueado se vazio)

ou nunca (bloqueado). Nenhuma alteração realizada será replicada para o GVcollege, assim

como será sobrescrita quando ocorrer uma nova sincronização.

3.2. Inscrição GVcollege

Para que os vínculos de usuários com suas turmas (cursos) sejam mantidos, faz-se

necessário ativar o tipo de inscrição GVcollege, devendo ser feita através do menu

Administração > Cursos > Inscrições, marcando o checkbox da coluna Ativar, e então em

Salvar mudanças, conforme a imagem:

Page 8: Integração com o Ambiente Virtual desag1.gvdasa.com.br/docs/downloads/Manuais/Integrações...Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 4 1. Apresentação

Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 8

3.3. Parâmetros da integração

A parametrização da integração deve ser feita com as informações necessárias e

selecionando as opções disponíveis, que irão refletir, por exemplo, em que tipos de papéis

serão importados e em como serão categorizadas as turmas (cursos), de acordo com cada

campo, conforme poderá ser observado nas imagens. O acesso a esta página é feito através

do menu Administração > Miscelânea > Integração GVcollege.

3.3.1. Autenticação do ambiente

• Chave de autenticação do ambiente: Sequência de caracteres, composta da forma

desejada, podendo ser informada da primeira vez utilizando a chave Padrão, exibida ao

lado do campo. Será utilizada para autenticar o ambiente Moodle com o Portal GVcollege.

3.3.2. Criação e categorização dos cursos

Page 9: Integração com o Ambiente Virtual desag1.gvdasa.com.br/docs/downloads/Manuais/Integrações...Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 4 1. Apresentação

Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 9

• Categoria padrão: Categoria, criada no Moodle, onde deverão ser mantidos os cursos

importados (turmas). Somente utilizada quando Usa categoria padrão estiver marcado.

• Modelo de curso: Curso, criado no Moodle, que deverá ser utilizado como modelo para os

novos criados.

• Usa categoria padrão: Indicador que definirá se será usada a categoria padrão ou estrutura

de categorias por níveis.

• Categoria nível 1/2/3/4/5: Informação, referente ao curso importado (turma), que irá

compor a estrutura de categorias, organizada em cinco níveis.

• Atualizar categoria da turma: Indicador que definirá se deverá ser atualizada a categoria de

um curso (turma) já importado, ao ser processado em nova exportação ou sincronização.

3.3.3. Atribuição de funções

• Função do aluno: Função que será atribuída aos alunos das turmas.

• Função do professor titular: Função que será atribuída ao professor titular das turmas.

• Importar auxiliares: Indicador que definirá se deverão ser importados professores

vinculados às turmas que não forem titulares.

• Função dos professores auxiliares: Função que será atribuída aos professores não titulares

das turmas.

• Importar coordenadores: Indicador que definirá se deverão ser importados os

coordenadores do curso à qual as turmas pertencem.

Page 10: Integração com o Ambiente Virtual desag1.gvdasa.com.br/docs/downloads/Manuais/Integrações...Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 4 1. Apresentação

Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 10

• Função dos coordenadores: Função que será atribuída aos coordenadores do curso das

turmas vinculadas.

• Importar integrantes do núcleo de coordenação: Indicador que definirá se deverão ser

importados os integrantes dos núcleos de coordenação do curso à qual as turmas

pertencem.

• Função dos integrantes do núcleo de coordenação: Função que será atribuída aos

integrantes dos núcleos de coordenação do curso das turmas vinculadas.

3.3.4. Logs de sincronização

• Caminho dos arquivos de log: Caminho físico onde deverão ser armazenados os arquivos

de log gerados pelo processo de sincronização automática.

• Prefixo do arquivo de log: Prefixo que deverá ser utilizado para gerar o nome dos arquivos

de log.

Page 11: Integração com o Ambiente Virtual desag1.gvdasa.com.br/docs/downloads/Manuais/Integrações...Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 4 1. Apresentação

Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 11

4. Configuração da integração no Portal GVcollege

4.1. Base de dados

A base de dados a ser acessada para obter os dados de turmas e usuários será a

definida, na Administração, na configuração Base de dados do item Geral, conforme imagem:

Em nenhum momento serão consideradas as bases definidas individualmente

para os módulos, devendo estar, esta, sempre configurada.

Page 12: Integração com o Ambiente Virtual desag1.gvdasa.com.br/docs/downloads/Manuais/Integrações...Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 4 1. Apresentação

Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 12

4.2. Geral

Estando o ambiente Moodle pronto para a integração, devem ser feitas as últimas

configurações, agora no ambiente do Portal, como pode ser observado nas imagens e é

explicado logo abaixo.

• Usa integração Moodle: Indicador que definirá se o Portal utilizará a integração, servindo

como parâmetro para exibição das funcionalidades para alunos e professores.

• URL Moodle: Endereço utilizado para acessar o ambiente Moodle, apontando para sua raiz.

• Chave de autenticação Moodle: Chave informada previamente na respectiva configuração

no Moodle, no item 2.3.1 Autenticação de ambiente.

• Permitir exportação de programas de aula para o Moodle: Indicador que definirá se o

professor poderá exportar sua programação de aulas para o Moodle, criando tópicos para

cada data em suas turmas.

Page 13: Integração com o Ambiente Virtual desag1.gvdasa.com.br/docs/downloads/Manuais/Integrações...Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 4 1. Apresentação

Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 13

4.3. Exportação automática de turmas

A integração oferece a possibilidade de configurar os cursos que deverão ter suas

turmas exportadas automaticamente para o ambiente Moodle, desta forma, não será

necessária a intervenção manual do professor.

A configuração se dá por unidade, bastando selecionar os cursos desejados,

conforme pode ser observado na imagem a seguir.

Page 14: Integração com o Ambiente Virtual desag1.gvdasa.com.br/docs/downloads/Manuais/Integrações...Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 4 1. Apresentação

Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 14

5. Exportação manual de turmas para o Moodle

A integração oferece a possibilidade de que as turmas sejam exportadas

manualmente pelo professor. Para isto, basta acessar através do menu a opção Exportar

turmas para o Moodle, que trará a listagem de turmas, selecioná-las, e clicar em Exportar

turmas selecionadas.

Page 15: Integração com o Ambiente Virtual desag1.gvdasa.com.br/docs/downloads/Manuais/Integrações...Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 4 1. Apresentação

Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 15

6. Acesso ao ambiente Moodle pelos Portais

Para facilitar o acesso ao ambiente Moodle, estará disponível, tanto para os

alunos como para os professores e coordenação, um atalho que irá direcionar o usuário já

autenticado. Nas imagens a seguir podem ser observados os locais deste atalho, em ambos os

portais, exibido como Acessar o ambiente Moodle:

Portal do Professor/Coordenador:

Portal do Aluno:

Page 16: Integração com o Ambiente Virtual desag1.gvdasa.com.br/docs/downloads/Manuais/Integrações...Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 4 1. Apresentação

Integração com o Ambiente Virtual de Aprendizagem Moodle · Página 16

7. Agendamento da tarefa de sincronização automática

Para que as turmas possam ser tanto exportadas como sincronizadas de forma

automática, deverá ser feito o agendamento, com a periodicidade desejada, de uma tarefa,

executante um script PHP que ficará na instalação do Moodle.

A forma de configuração irá variar de acordo com o sistema operacional, mas em

ambos os casos deverá ser feita a execução do arquivo <caminho físico do

Moodle>/auth/gvcollege/auth_gvcollege_sync_users.php, através do PHP disponível no

servidor. Exemplos:

• Windows: D:\www\moodle\auth\gvcollege\auth_gvcollege_sync_users.php

• Linux: /var/www/moodle/auth/gvcollege/auth_gvcollege_sync_users.php

IMPORTANTE: A execução deve ser feita de forma local, o PHP deve ser chamado

via linha de comando com o caminho acima via parâmetro para que seja interpretado.

Execuções via chamadas HTTP não serão aceitas. Em ambiente Linux, poderá ser feito

utilizando o Crontab, e em Windows, o Agendador de Tarefas.