Vai al contenuto

Puzzel.org in Canvas

Aggiungi un'attività Puzzel a un corso Canvas e il punteggio di ogni studente torna da solo nel registro di quel corso. Il tuo amministratore collega Puzzel.org a Canvas una volta sola; da quel momento ogni insegnante della scuola può usarlo.

Canvas

LTI 1.3 · Assignment and Grade Services
Pronto per la connessione

È Canvas stesso a registrare Puzzel.org: il tuo amministratore incolla un URL e risponde a una breve procedura guidata. Gli insegnanti aggiungono poi le attività direttamente dai propri corsi, e gli studenti giocano senza un account Puzzel.org.

Per l'amministratore IT

Collega Canvas una volta sola

Canvas la chiama registrazione dinamica: gli dai un URL e lui recupera tutto ciò che gli serve da Puzzel.org. Nessuna chiave né segreto da scambiare, niente da scaricare.

  1. Apri Apps nel tuo account Canvas Nella Global Navigation scegli Admin e poi il nome del tuo account, quindi Apps. Nella scheda Manage, premi Install a New App. Admin → your account → Apps → Manage → Install a New App
  2. Scegli LTI 1.3 e Dynamic Registration Seleziona LTI version 1.3, imposta Install Method su Dynamic Registration, incolla l'URL qui sopra e premi Next. LTI version 1.3 → Install Method: Dynamic Registration
  3. Lascia attivi i permessi Sono questi permessi a permettere a Puzzel.org di creare la colonna del registro per un'attività aggiunta da un insegnante e di scrivervi i punteggi. Se li disattivi l'app si installa comunque, ma nessun punteggio arriverà mai a Canvas. Set Permissions
  4. Condividi i nomi degli studenti “User's name only” basta. I punteggi arrivano correttamente anche con “None (Anonymized)”, ma in quel caso gli insegnanti vedono nei risultati di Puzzel.org giocatori anonimi invece dei nomi. Puzzel.org non chiede mai a Canvas gli elenchi delle tue classi. User Data Shared With This App
  5. Scegli dove gli insegnanti lo troveranno Attiva i posizionamenti in cui vuoi che gli insegnanti trovino Puzzel.org: quello per scegliere il contenuto in un compito, e il pulsante dell'editor di testo se lo desideri anche lì. Ogni posizionamento ha un'icona informativa che mostra esattamente dove compare in Canvas. Set Placements
  6. Rivedi, installa e imposta chi può usarlo Se vuoi, dagli un nome, poi premi Install App. Puzzel.org comparirà nella scheda Manage, che è anche dove scegli se renderlo disponibile per l'intero account o solo per alcuni corsi. Review and install → Manage
URL di registrazione dinamica
https://puzzel.org/lti/register

È l'unica cosa che devi incollare. Non è una pagina da aprire nel browser: fornisce a Canvas la configurazione.

Cosa ti serve

Un amministratore dell'account Canvas con il permesso “LTI Registrations - Manage”, e un account Puzzel.org con cui accedere a metà procedura — crealo su puzzel.org prima di iniziare, invece che a metà della procedura guidata. Gli account Canvas Free-for-Teacher non possono creare la chiave sviluppatore necessaria, quindi LTI 1.3 non è disponibile per loro — lo è invece il percorso più semplice, in fondo a questa pagina.

A metà procedura, Puzzel.org ti chiede chi sei

Dopo aver incollato l'URL, Canvas apre una finestra di Puzzel.org dentro la procedura guidata — è la nostra schermata, non una di Canvas. Indica il Canvas a cui sta per collegarsi: accedi, premi Collega, e Canvas riprende da dove si era interrotto. Essere già connesso a Puzzel.org in un'altra scheda non si trasferisce in quella finestra, quindi e-mail e password restano il modo più sicuro per entrare.

Quale account Puzzel.org?

Uno qualsiasi — quello della scuola stessa, oppure quello dell'insegnante che te lo ha chiesto. Viene registrato solo per sapere chi ha configurato la connessione. Non diventa mai un accesso condiviso e non possiede nulla: ogni insegnante accede in seguito con il proprio account, nel proprio corso.

Aggiungi un'attività
Canvas dice “Invalid XML Configuration”?

Allora l'URL è stato inserito nella vecchia schermata LTI 1.1 — External Apps, + App, By URL — che accetta solo un file XML. L'URL di registrazione non è XML, quindi Canvas lo rifiuta. Non c'è nulla di rotto da nessuna delle due parti: è semplicemente la schermata sbagliata.

Usa invece Apps → Manage → Install a New App, come sopra. Se invece intendevi il percorso più semplice senza registro, prendi l'URL di configurazione in fondo a questa pagina.

Le istruzioni ufficiali di Canvas

Instructure documenta questa procedura guidata schermata per schermata, con un'immagine per ciascuna. Gli stessi passaggi, visti dal loro lato.

Leggi la guida di Canvas
Se il tuo Canvas chiede ogni URL separatamente

Le installazioni più vecchie registrano uno strumento manualmente. Ecco i tre URL che ti verranno richiesti. Sia il redirect URI sia il target link URI corrispondono all'URL di lancio, e le chiavi pubbliche vengono recuperate dall'URL JWKS — non c'è nessun segreto da incollare da nessuna parte.

Login URL https://puzzel.org/lti/login
Launch URL https://puzzel.org/lti/launch
Chiavi pubbliche (JWKS) https://puzzel.org/api/lti/jwks
Per gli insegnanti

Aggiungi un'attività al tuo corso

Una volta che il tuo amministratore ha collegato Canvas, Puzzel.org è disponibile in ogni corso. Accedi una volta con il tuo account Puzzel.org, scegli l'attività e i punti, e Canvas crea da sé la colonna del registro.

  1. Trasformalo in un compito Nel tuo corso vai su Assignments e aggiungine uno. Imposta Submission Type su External Tool e premi Find. Assignments → + Assignment → Submission Type: External Tool → Find
  2. Scegli Puzzel.org dall'elenco Canvas apre una finestra di Puzzel.org dentro il compito. È la finestra di Puzzel, non una schermata di Canvas, ed è per questo che ti chiede chi sei. Find → Puzzel.org
  3. Accedi con il tuo account Solo la prima volta, ed è qui che i due accessi si separano: l'account qui è il tuo, non quello che il tuo amministratore ha usato per collegare Canvas. Ogni insegnante accede con la propria identità e vede le proprie attività. Non hai ancora un account? La finestra ha un link per crearne uno — fallo nella scheda che si apre, poi torna qui e accedi.
  4. Scegli l'attività e i punti Scegli una delle tue attività e conferma. Il valore che inserisci in Points è quanto vale l'attività, e la colonna del registro viene creata quando salvi il compito.
  5. Gli studenti lo aprono in Canvas Premono sul compito e giocano subito: nessun account Puzzel.org da creare, nessun nome da digitare, nessun codice. Il punteggio arriva nel registro non appena finiscono, e se giocano di nuovo conta il loro tentativo migliore.
Da sapere

La tua prova personale non viene mai valutata: se apri l'attività come insegnante la giochi allo stesso modo, ma non viene scritto nulla nel registro. Funziona qualsiasi attività con un punteggio per studente; il gioco in squadra e in stanza no. L'invio dei punteggi fa parte di un piano a pagamento sull'account proprietario dell'attività — senza, le attività funzionano comunque in Canvas, semplicemente senza voto.

Non hai accesso da amministratore?

Il percorso più semplice, un corso alla volta

Canvas permette a un insegnante di aggiungere un'app esterna a un singolo corso senza dover chiedere all'IT. Puzzel.org si trova quindi nell'editor di testo di quel corso: premilo, scegli una delle tue attività, e viene inserita nella pagina per i tuoi studenti. È il vecchio metodo LTI 1.1, e non prevede un registro.

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

Chiamalo Puzzel.org, lascia vuoti Consumer Key e Shared Secret, e incolla l'URL di configurazione. È l'unica schermata in cui un URL di configurazione XML è la risposta giusta.

Tutto ciò che aggiungi in questo modo continua a funzionare anche dopo che il tuo amministratore collega la scuola, e ciò che aggiungerai da quel momento in poi invierà anche i punteggi.

Cosa ottieni
  • Le attività si giocano dentro la pagina del corso
  • I risultati restano in Puzzel.org, sotto il tuo account
Cosa perdi
  • Nessuna colonna nel registro, nessun punteggio in Canvas
  • Canvas non comunica a Puzzel.org chi sia lo studente
Privacy degli studenti

Quali dati degli studenti riceve e conserva Puzzel.org per i voti?

Leggi l'informativa sulla privacy
  • Entra solo ciò che serve

    L'ID dello studente in Google Classroom o nel sistema della tua scuola — con nome e indirizzo e-mail solo se il sistema li condivide. Mai elenchi di classe, altri studenti o altri lavori del corso.

  • Esce solo il punteggio

    Calcolato sui nostri server a partire dalle risposte date, e inviato solo alla voce di registro di quello studente. Nient'altro.

  • Rimosso quando interrompi

    Il record di uno studente scompare quando l'insegnante interrompe la sincronizzazione dell'attività o la elimina. I punteggi già inviati restano nel registro della scuola.

  • La scuola resta al comando

    È la tua scuola a decidere che cosa succede ai dati dei suoi studenti; Puzzel.org li tratta solo per conto della scuola.

Ti sei bloccato da qualche parte?

Dicci a quale passaggio ti trovi e cosa ha detto Canvas, e lo risolviamo insieme — gli screenshot sono benvenuti.

Altri sistemi