Este documento fornece instruções para integrar a plataforma Panorama ao seu sistema de gerenciamento de aprendizagem (LMS) Moodle. Antes de seguir as etapas abaixo, verifique se você tem acesso total, como administrador, à sua instância do Moodle. Se tiver dúvidas sobre as etapas deste processo, entre em contato com o seu gerente de contas dedicado.
Como obter a chave do consumidor e o segredo LTI
Antes de seguir as etapas abaixo, você precisará ter recebido um e-mail do seu gerente de contas pedindo que você crie a sua conta de administrador do Panorama.
- Faça login na sua conta do Panorama.
- Clique em Configurações no menu do lado esquerdo e, em seguida, selecione Configurações de integração.
- Em Selecione integração (menu suspenso), selecione LTI 1.1.
- Anote a sua chave do consumidor e o seu segredo LTI. Eles são necessários para a próxima seção deste guia.
Adicionando o aplicativo Panorama ao Moodle
Depois de obter a sua chave do consumidor e o seu segredo LTI, você poderá adicionar o Panorama à sua instância do Moodle.
- Faça login no Moodle como Administrador. No painel lateral, clique em Administração do site.
- Selecione a guia Plugins na linha superior e, em seguida, clique em Gerenciar ferramentas.
- Clique em configurar uma ferramenta manualmente.
- Preencha as informações a seguir conforme mostrado abaixo, role a tela para baixo, clique em Salvar mudanças, e continue para a próxima seção deste guia.
- Nome da ferramenta: Panorama LTI 1.1
-
URL da ferramenta: Copie e cole o URL de acordo com a sua zona.
- Zona dos EUA: https://panorama-api.yuja.com/lti.lti-app
- Zona do Canadá: https://panorama-api-cz.yuja.com/lti/lti-app
- Zona da UE: https://panorama-api-ez.yuja.com/lti/lti-app
- Zona da Austrália: https://panorama-api-az.yuja.com/lti/lti-app
- Descrição da ferramenta: Panorama LTI 1.1 APP
- Versão do LTI: LTI 1.0/1.1
- Chave do consumidor: Obtida na seção anterior deste guia.
- Segredo compartilhado: O segredo LTI obtido na seção anterior deste guia.
- Contêiner de lançamento padrão: Recomendamos selecionar Nova janela.
Ativando o link LTI do Panorama em um curso do Moodle
Depois de adicionar o aplicativo Panorama ao Moodle, você poderá ativar o Panorama em um curso de sua escolha.
- Faça login no Moodle e, no painel lateral, clique no curso ao qual você deseja adicionar o Panorama.
- Clique em Ativar edição no canto superior direito.
- Clique em Adicionar uma atividade ou recurso.
- Clique em Ferramenta externa.
- No campo Nome da atividade insira Panorama, ou qualquer nome identificável que você queira usar.
- Em Ferramenta pré-configurada (menu suspenso), selecione o Panorama LTI 1.1 criado anteriormente.
- Clique em Salvar e voltar ao curso.
- O link LTI do Panorama agora estará disponível no curso escolhido. Continue para a próxima seção deste guia.
Obtendo o token do serviço web do Moodle
O Panorama - LMS Connector exige que um Token de acesso seja gerado para acessar a API fornecida pelo Moodle. Para obter o Token de acesso, siga as instruções abaixo.
- Faça login no Moodle como Administrador. No painel lateral, clique em Administração do site.
- Selecione a guia Plugins na linha superior.
- Role a tela para baixo até Serviço web, e selecione Visão geral.
- Verifique se o Status de Habilitar serviços web está definido como Sim, e se Habilitar protocolos está definido como rest.
- Volte para Serviços web, e selecione Serviços externos.
- Em Serviços personalizados clique em Adicionar.
- Insira o Nome, Panorama, e verifique se a caixa de seleção Habilitado está marcada.
- Clique em Mostrar mais.
- Verifique se Pode baixar arquivos e Pode enviar arquivos estão marcados.
- Em Capacidade necessária (menu suspenso), pesquise e adicione repository/url:view.
- Clique em Adicionar serviço.
- Após o redirecionamento para Serviços externos (página), localize o serviço recém-adicionado Serviço externo, e selecione Funções.
- Role a tela para baixo e clique em Adicionar funções.
- Na barra de pesquisa, adicione as funções a seguir e clique em Adicionar funções.
core_enrol_get_enrolled_users_with_capability
core_enrol_get_enrolled_users
core_course_get_courses
core_files_get_files
mod_page_get_pages_by_courses
mod_assign_get_assignments
- core_course_get_categories
core_course_get_contents
mod_forum_get_forums_by_courses
mod_glossary_get_glossaries_by_courses
mod_data_get_databases_by_courses
mod_folder_get_folders_by_courses
mod_lesson_get_lessons_by_courses
mod_quiz_get_quizzes_by_courses
mod_survey_get_surveys_by_courses
mod_workshop_get_workshops_by_courses
mod_book_get_books_by_courses
- mod_label_get_labels_by_courses
- Volte para Serviços web, e selecione Gerenciar tokens.
- Clique em Adicionar.
- Em Usuário (menu suspenso), selecione um usuário com permissões administrativas.
- Em Serviço, selecione o serviço Panorama criado anteriormente e clique em Salvar mudanças.
- Depois de salvar o token, você será redirecionado para a página Gerenciar tokens . Anote o token, pois ele será necessário, e continue para a próxima seção deste guia.
Integrando o Moodle ao Panorama
Depois de anotar o seu token de acesso da seção anterior, você precisará estabelecer uma conexão entre a sua instância do Moodle e o Panorama, para que o Panorama possa recuperar dados.
- Acesse a plataforma Panorama, clique em Configurações, e, em seguida, selecione Configurações de integração.
- Em Selecione integração (menu suspenso), selecione LMS API.
- Clique em Adicionar chave de acesso.
- Em Token de acesso, cole o token de acesso obtido na seção anterior deste guia.
- Clique em Adicionar chave de acesso.
- Clique em Salvar alterações. O Panorama agora poderá recuperar informações da sua instância do Moodle.
Instalando o plugin Panorama Visualizer
O plugin Panorama Visualizer permite que você veja os ícones do Panorama nos cursos.
- Faça login na sua conta do Panorama.
- Clique em Configurações no menu do lado esquerdo e, em seguida, selecione Configurações de integração.
- Em Selecione integração (menu suspenso), selecione LMS Visualizer e clique em Baixar plugins.
- Localize o arquivo ZIP baixado no seu dispositivo e extraia-o. Você verá dois arquivos ZIP que precisarão ser enviados ao Moodle mais adiante neste guia: filter_panorama e local_panorama
- Para enviar os arquivos, faça login no Moodle como administrador, clique em Administração do site no painel do lado esquerdo e, em seguida, clique em Plugins na linha superior.
- Clique em Instalar plugins.
- Clique em Escolher um arquivo.
- Selecione a guia Enviar um arquivo no menu do lado esquerdo e clique em Escolher arquivo.
- Selecione o arquivo local_panorama.zip e clique em Enviar este arquivo.
- Clique em Instalar plugin a partir do arquivo ZIP.
- Clique em Continuar para instalar o plugin.
- Repita as etapas 6 a 11 para instalar o arquivo filter_panorama.zip também. Depois de concluir, continue para a próxima seção deste guia.
Definindo as configurações do Panorama
Depois de instalar os plugins, você precisará definir as configurações do Panorama. Isso exige obter informações da sua conta do Panorama.
- Faça login na sua conta do Panorama.
- Clique em Configurações no menu do lado esquerdo e, em seguida, selecione Informações da instituição.
- Anote a sua Chave identificadora primária e a sua Chave identificadora secundária.
- Em seguida, faça login no Moodle e, no menu de navegação do lado esquerdo, clique em Administração do site, e depois clique na guia Plugins na linha superior.
- Role a tela para baixo até Panorama, e selecione Configurações do Panorama para Moodle.
- Insira as informações mostradas abaixo e clique em Salvar mudanças. Quando terminar, continue para a próxima seção deste guia.
- Chave identificadora primária: Obtida na etapa 3 desta seção.
- Chave identificadora secundária: Obtida na etapa 3 desta seção.
- Chave do consumidor LTI: A chave do consumidor obtida na primeira seção deste guia.
-
Chave LTI: O segredo LTI obtido na primeira seção deste guia.
Ativando o filtro do Panorama
Ativar o filtro do Panorama permite que o Panorama seja exibido no Moodle.
Faça login no Moodle como administrador. No painel lateral, clique em Administração do site.
- Selecione a guia Plugins na linha superior.
- Role a tela para baixo até Filtros, e selecione Gerenciar filtros.
- Localize e ative o filtro Panorama para Moodle selecionando Ativado no menu suspenso. O filtro do Panorama agora estará ativado para as versões do Moodle acima de 3.5.
- A próxima etapa só deve ser concluída para as versões do Moodle 3.5 e anteriores.
- Clique em Administração do site no painel do lado esquerdo e, em seguida, clique na guia Aparência na linha superior.
- Clique em HTML adicional.
- No espaço fornecido, adicione o script a seguir à seção Dentro de HEAD e, em seguida, role a tela para baixo e clique em Salvar mudanças para ativar o filtro do Panorama nas versões 3.5 e anteriores.
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script>
Desinstalando o Panorama de uma instância do Moodle
- Faça login no Moodle como Administrador. No painel lateral, clique em Administração do site.
- Selecione a guia Plugins na linha superior e, em seguida, clique em Visão geral dos plugins.
- Localize o plugin filter_panorama, e clique em Desinstalar.
- Clique em Confirmar para desinstalar o plugin.
- Na página Visão geral dos plugins (exibida após o redirecionamento), localize e desinstale também o plugin local_panorama.
- Por fim, remova as ferramentas externas do Panorama que estão nos seus cursos. No painel lateral, clique no curso que contém uma ferramenta externa do Panorama.
- Clique em Ativar edição no canto superior direito.
- Clique em Editar ao lado da ferramenta LTI do Panorama.
- Clique em Excluir.
- Clique em Sim para remover a ferramenta externa do Panorama do curso. Repita as etapas para quaisquer outros cursos que contenham a ferramenta externa do Panorama, a fim de concluir a desinstalação do Panorama do Moodle.