Pular para o conteúdo

Puzzel.org no Canvas

Adicione uma atividade do Puzzel a um curso do Canvas, e a pontuação de cada aluno volta sozinha para o diário de classe desse curso. Seu administrador conecta o Puzzel.org ao Canvas uma única vez; depois disso, todos os professores da escola podem usá-lo.

Canvas

LTI 1.3 · Assignment and Grade Services
Pronto para conectar

O próprio Canvas registra o Puzzel.org: seu administrador cola uma URL e responde a um assistente rápido. Os professores então adicionam atividades de dentro dos próprios cursos, e os alunos jogam sem precisar de uma conta Puzzel.org.

Para o administrador de TI

Conecte o Canvas uma vez

O Canvas chama isso de registro dinâmico: você fornece uma URL e ele busca tudo o que precisa no Puzzel.org. Não há chaves nem segredos para trocar, nada para baixar.

  1. Abra Apps na sua conta do Canvas Na Global Navigation, escolha Admin e depois o nome da sua conta, depois Apps. Na aba Manage, clique em Install a New App. Admin → sua conta → Apps → Manage → Install a New App
  2. Escolha LTI 1.3 e Dynamic Registration Selecione LTI version 1.3, defina Install Method como Dynamic Registration, cole a URL acima e clique em Next. LTI version 1.3 → Install Method: Dynamic Registration
  3. Deixe as permissões ativadas São elas que permitem que o Puzzel.org crie a coluna do diário de classe para uma atividade que um professor adiciona e grave as pontuações nela. Desative-as e o app ainda será instalado, mas nenhuma pontuação chegará ao Canvas. Set Permissions
  4. Compartilhe os nomes dos alunos “User's name only” já é suficiente. As pontuações também chegam corretamente com “None (Anonymized)”, mas nesse caso os professores veem jogadores anônimos nos resultados do Puzzel.org em vez de nomes. O Puzzel.org nunca pede ao Canvas as suas listas de turma. User Data Shared With This App
  5. Escolha onde os professores vão encontrá-lo Ative os placements onde os professores devem encontrar o Puzzel.org: o de escolher conteúdo em uma tarefa, e o botão do editor de texto, se você também quiser isso lá. Cada placement tem um ícone de informação mostrando exatamente onde ele aparece no Canvas. Set Placements
  6. Revise, instale e defina quem pode usá-lo Dê um apelido a ele se quiser, depois clique em Install App. O Puzzel.org aparece na aba Manage, e é lá também que você escolhe se ele fica disponível para toda a conta ou apenas em determinados cursos. Review and install → Manage
URL de registro dinâmico
https://puzzel.org/lti/register

É a única coisa que você cola. Não é uma página para abrir no navegador: ela entrega a configuração ao Canvas.

O que você precisa

Um administrador da conta do Canvas com a permissão “LTI Registrations - Manage”, e uma conta Puzzel.org para entrar no meio do caminho — crie essa conta em puzzel.org antes de começar, em vez de no meio do assistente. Contas Canvas Free-for-Teacher não conseguem criar a chave de desenvolvedor necessária para isso, então o LTI 1.3 não está aberto a elas — a rota mais simples no fim desta página está.

No meio do caminho, o Puzzel.org pergunta quem você é

Depois que você cola a URL, o Canvas abre uma janela do Puzzel.org dentro do assistente — é a nossa tela, não uma tela do Canvas. Ela mostra o nome do Canvas que está prestes a se conectar: entre, clique em Conectar, e o Canvas continua de onde parou. Estar conectado ao Puzzel.org em outra aba não vale dentro dessa janela, então e-mail e senha é a forma mais segura de entrar.

Qual conta Puzzel.org?

Qualquer uma — a da própria escola, ou a do professor que pediu para você fazer isso. Ela só é registrada para sabermos quem configurou a conexão. Nunca se torna um login compartilhado e não é dona de nada: cada professor entra com a própria conta, depois, no próprio curso.

Adicionar uma atividade
O Canvas diz “Invalid XML Configuration”?

Nesse caso, a URL foi colada na tela mais antiga do LTI 1.1 — External Apps, + App, By URL — que só aceita um arquivo XML. A URL de registro não é XML, então o Canvas a recusa. Não há nada quebrado de nenhum dos dois lados; é a tela errada.

Use Apps → Manage → Install a New App, como acima. Se você realmente quis dizer a rota mais simples, sem diário de classe, pegue a URL de configuração no fim desta página.

As instruções do próprio Canvas

A Instructure documenta esse assistente tela por tela, com uma imagem de cada uma. As mesmas etapas, do lado deles.

Ler o guia do Canvas
Se o seu Canvas pedir cada URL separadamente

Instalações mais antigas registram uma ferramenta manualmente. Estas são as três URLs que serão pedidas. Tanto o redirect URI quanto o target link URI são a URL de lançamento, e as chaves públicas são buscadas na URL do JWKS — não há nenhum segredo para colar em lugar nenhum.

URL de login https://puzzel.org/lti/login
URL de lançamento https://puzzel.org/lti/launch
Chaves públicas (JWKS) https://puzzel.org/api/lti/jwks
Para professores

Adicione uma atividade ao seu curso

Depois que seu administrador conectar o Canvas, o Puzzel.org estará disponível em todos os cursos. Você entra uma vez com sua própria conta Puzzel.org, escolhe a atividade e os pontos, e o próprio Canvas cria a coluna do diário de classe.

  1. Transforme em uma tarefa No seu curso, vá em Assignments e adicione uma. Defina Submission Type como External Tool e clique em Find. Assignments → + Assignment → Submission Type: External Tool → Find
  2. Escolha o Puzzel.org na lista O Canvas abre uma janela do Puzzel.org dentro da tarefa. É a própria janela do Puzzel, não uma tela do Canvas — por isso ela pergunta quem você é. Find → Puzzel.org
  3. Entre com sua própria conta Só na primeira vez, e é aqui que os dois acessos se separam: a conta aqui é a sua, não a que seu administrador usou para conectar o Canvas. Cada professor entra com a própria conta e vê apenas suas próprias atividades. Ainda não tem conta? A janela tem um link para criar uma — crie a sua na aba que ele abre e depois volte para entrar.
  4. Escolha sua atividade e os pontos Escolha uma das suas atividades e confirme. O valor que você colocar em Points é quanto ela vale, e a coluna do diário de classe é criada quando você salva a tarefa.
  5. Os alunos abrem no Canvas Eles clicam na tarefa e já começam a jogar: sem precisar criar conta no Puzzel.org, sem digitar nome, sem código. A pontuação chega ao diário de classe assim que terminam, e se jogarem de novo, vale a melhor tentativa.
Bom saber

A sua própria tentativa nunca é avaliada: abra a atividade como professor e você joga do mesmo jeito, mas nada é gravado no diário de classe. Qualquer atividade com pontuação por aluno funciona; partidas em equipe e em sala não funcionam. O envio de pontuações faz parte de um plano pago na conta dona da atividade — sem ele, as atividades continuam funcionando no Canvas, só que sem avaliação.

Sem acesso de administrador?

A rota mais simples, um curso de cada vez

O Canvas permite que um professor adicione um app externo a um único curso sem precisar pedir para a TI. O Puzzel.org então fica disponível no editor de texto do curso: clique nele, escolha uma das suas atividades, e ela é inserida na página para os seus alunos. Esse é o jeito mais antigo, do LTI 1.1, e não tem diário de classe.

Config URL
https://puzzel.org/lti.xml
No curso: Settings → Apps → View App Configurations → + App → Configuration Type: By URL

Nomeie como Puzzel.org, deixe Consumer Key e Shared Secret vazios, e cole a URL de configuração. Essa é a única tela onde uma URL de configuração XML é a resposta certa.

Tudo o que você adicionar desse jeito continua funcionando depois que seu administrador conectar a escola, e o que você adicionar a partir daí também envia as pontuações.

O que você ganha
  • As atividades são jogadas dentro da página do curso
  • Os resultados ficam no Puzzel.org, na sua própria conta
O que você perde
  • Sem coluna no diário de classe, sem pontuações no Canvas
  • O Canvas não informa ao Puzzel.org quem é o aluno
Privacidade do aluno

Quais dados de alunos o Puzzel.org recebe e guarda para as notas?

Leia a política de privacidade
  • Só entra o que é necessário

    O ID do aluno no Google Classroom ou no sistema da sua escola — com nome e e-mail só se o sistema os compartilhar. Nunca listas de turma, outros alunos ou outros materiais do curso.

  • Só sai a pontuação

    Calculada em nossos servidores a partir das respostas dadas, e enviada para o registro desse aluno no diário de classe. Nada mais.

  • Removido quando você para

    O registro de um aluno desaparece quando o professor para de sincronizar a atividade ou a exclui. As notas já enviadas continuam no diário de classe da escola.

  • A escola continua no controle

    Sua escola decide o que acontece com os dados dos seus alunos; o Puzzel.org os processa apenas em nome da escola.