Zum Inhalt springen

Puzzel.org in Canvas

Füg eine Puzzel-Aktivität zu einem Canvas-Kurs hinzu, und die Punktzahl jedes Schülers landet von selbst im Notenbuch dieses Kurses. Dein Admin verbindet Puzzel.org einmal mit Canvas; danach kann jede Lehrkraft der Schule es nutzen.

Canvas

LTI 1.3 · Assignment and Grade Services
Bereit zum Verbinden

Canvas registriert Puzzel.org selbst: Dein Admin fügt eine URL ein und beantwortet einen kurzen Assistenten. Lehrkräfte fügen danach Aktivitäten direkt in ihren eigenen Kursen hinzu, und Schüler spielen ohne Puzzel.org-Konto.

Für den IT-Admin

Canvas einmal verbinden

Canvas nennt das dynamische Registrierung: Du gibst eine URL an, und Canvas holt sich alles Nötige von Puzzel.org. Keine Schlüssel oder Secrets zum Austauschen, nichts herunterzuladen.

  1. Öffne Apps in deinem Canvas-Konto Wähl in der Global Navigation Admin und dann den Namen deines Kontos, danach Apps. Drück auf dem Tab Manage auf Install a New App. Admin → dein Konto → Apps → Manage → Install a New App
  2. Wähl LTI 1.3 und Dynamic Registration Wähl LTI-Version 1.3, setz Install Method auf Dynamic Registration, füg die URL von oben ein und drück auf Next. LTI version 1.3 → Install Method: Dynamic Registration
  3. Lass die Berechtigungen aktiviert Sie sind es, die Puzzel.org erlauben, die Notenbuch-Spalte für eine von einer Lehrkraft hinzugefügte Aktivität zu erstellen und Punktzahlen dort einzutragen. Schaltest du sie aus, installiert sich die App trotzdem, aber es kommt nie eine Punktzahl in Canvas an. Set Permissions
  4. Namen der Schüler teilen “User's name only” reicht. Punktzahlen kommen auch bei “None (Anonymized)” richtig an, aber dann sehen Lehrkräfte in ihren Puzzel.org-Ergebnissen anonyme Spieler statt Namen. Puzzel.org fragt Canvas nie nach deinen Klassenlisten. User Data Shared With This App
  5. Wähl, wo Lehrkräfte es finden Schalte die Placements ein, in denen Lehrkräfte Puzzel.org finden sollen: das für die Inhaltsauswahl in einer Aufgabe, und die Schaltfläche im Text-Editor, falls du sie auch dort willst. Jedes Placement hat ein Info-Symbol, das genau zeigt, wo es in Canvas erscheint. Set Placements
  6. Überprüfen, installieren und festlegen, wer es nutzen darf Gib ihm bei Bedarf einen Spitznamen und drück dann auf Install App. Puzzel.org erscheint auf dem Tab Manage, und dort legst du auch fest, ob es für das gesamte Konto oder nur für bestimmte Kurse verfügbar ist. Review and install → Manage
URL für die dynamische Registrierung
https://puzzel.org/lti/register

Das ist das Einzige, was du einfügst. Es ist keine Seite zum Öffnen im Browser: Sie übergibt Canvas die Konfiguration.

Was du brauchst

Ein Canvas-Kontoadmin mit der Berechtigung „LTI Registrations - Manage“ und ein Puzzel.org-Konto, mit dem du dich mittendrin anmeldest — leg dieses Konto vorher auf puzzel.org an, statt erst mitten im Assistenten. Canvas-Free-for-Teacher-Konten können den dafür nötigen Developer Key nicht erstellen, LTI 1.3 steht ihnen deshalb nicht offen — der einfachere Weg unten auf dieser Seite dagegen schon.

Mittendrin fragt Puzzel.org, wer du bist

Nachdem du die URL eingefügt hast, öffnet Canvas ein Puzzel.org-Fenster innerhalb des Assistenten — unser Bildschirm, nicht einer von Canvas. Es nennt das Canvas, das gleich verbunden wird: Melde dich an, drück auf Verbinden, und Canvas macht dort weiter, wo es aufgehört hat. Bist du in einem anderen Tab bei Puzzel.org angemeldet, überträgt sich das nicht auf dieses Fenster — E-Mail und Passwort sind deshalb der zuverlässige Weg hinein.

Welches Puzzel.org-Konto?

Ganz egal welches — das eigene der Schule oder das der Lehrkraft, die dich darum gebeten hat. Es wird nur festgehalten, damit wir wissen, wer die Verbindung eingerichtet hat. Es wird nie zu einem gemeinsamen Login und besitzt nichts: Jede Lehrkraft meldet sich später mit dem eigenen Konto in ihrem eigenen Kurs an.

Aktivität hinzufügen
Canvas meldet “Invalid XML Configuration”?

Dann ist die URL in den älteren LTI-1.1-Bildschirm gelandet — External Apps, + App, By URL —, der nur eine XML-Datei akzeptiert und sonst nichts. Die Registrierungs-URL ist kein XML, deshalb weist Canvas sie zurück. Auf keiner Seite ist etwas kaputt; es ist nur der falsche Bildschirm.

Nutz stattdessen Apps → Manage → Install a New App wie oben. Wolltest du eigentlich den einfacheren Weg ohne Notenbuch, nimm die Config-URL vom Ende dieser Seite.

Canvas' eigene Anleitung

Instructure dokumentiert diesen Assistenten Bildschirm für Bildschirm, mit einem Bild zu jedem. Dieselben Schritte, aus ihrer Sicht.

Canvas-Anleitung lesen
Wenn dein Canvas jede URL einzeln abfragt

Ältere Installationen registrieren ein Tool von Hand. Das sind die drei URLs, nach denen dabei gefragt wird. Sowohl die Redirect URI als auch die Target Link URI sind die Launch-URL, und die öffentlichen Schlüssel werden über die JWKS-URL abgerufen — es gibt nirgendwo ein Secret zum Einfügen.

Login-URL https://puzzel.org/lti/login
Launch-URL https://puzzel.org/lti/launch
Öffentliche Schlüssel (JWKS) https://puzzel.org/api/lti/jwks
Für Lehrkräfte

Füg deinem Kurs eine Aktivität hinzu

Sobald dein Admin Canvas verbunden hat, ist Puzzel.org in jedem Kurs verfügbar. Du meldest dich einmal mit deinem eigenen Puzzel.org-Konto an, wählst die Aktivität und die Punktzahl, und Canvas legt die Notenbuch-Spalte selbst an.

  1. Mach daraus eine Aufgabe Geh in deinem Kurs zu Assignments und füg eine hinzu. Setz Submission Type auf External Tool und drück auf Find. Assignments → + Assignment → Submission Type: External Tool → Find
  2. Wähl Puzzel.org aus der Liste Canvas öffnet ein Puzzel.org-Fenster innerhalb der Aufgabe. Es ist Puzzels eigenes Fenster statt eines Canvas-Bildschirms — deshalb fragt es, wer du bist. Find → Puzzel.org
  3. Melde dich mit deinem eigenen Konto an Nur beim ersten Mal, und hier trennen sich die beiden Anmeldungen: Das Konto hier ist deins, nicht das, mit dem dein Admin Canvas verbunden hat. Jede Lehrkraft meldet sich als sie selbst an und sieht ihre eigenen Aktivitäten. Noch kein Konto? Das Fenster hat einen Link zum Registrieren — leg eins im sich öffnenden Tab an und komm dann zurück, um dich anzumelden.
  4. Wähl deine Aktivität und die Punktzahl Wähl eine deiner Aktivitäten und bestätige. Was auch immer du bei Points einträgst, ist ihr Wert, und die Notenbuch-Spalte wird angelegt, sobald du die Aufgabe speicherst.
  5. Schüler öffnen sie in Canvas Sie drücken auf die Aufgabe und spielen sofort los: kein Puzzel.org-Konto anzulegen, kein Name einzutippen, kein Code. Die Punktzahl landet im Notenbuch, sobald sie fertig sind, und spielen sie erneut, zählt ihr bester Versuch.
Gut zu wissen

Dein eigener Durchlauf wird nie benotet: Öffnest du die Aktivität als Lehrkraft, spielst du sie genauso, aber es wird nichts ins Notenbuch geschrieben. Jede Aktivität mit einer Punktzahl pro Schüler funktioniert; Team- und Raum-Spiele nicht. Das Senden von Punktzahlen ist Teil eines kostenpflichtigen Tarifs auf dem Konto, dem die Aktivität gehört — ohne einen funktionieren Aktivitäten trotzdem in Canvas, nur eben unbenotet.

Kein Admin-Zugriff?

Der einfachere Weg, Kurs für Kurs

Canvas erlaubt es einer Lehrkraft, eine externe App zu einem einzelnen Kurs hinzuzufügen, ohne die IT zu fragen. Puzzel.org sitzt dann im Text-Editor dieses Kurses: draufdrücken, eine deiner Aktivitäten wählen, und sie wird auf der Seite für deine Schüler platziert. Das ist der ältere LTI-1.1-Weg, und er hat kein Notenbuch.

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

Nenn es Puzzel.org, lass Consumer Key und Shared Secret leer, und füg die Config-URL ein. Das ist der einzige Bildschirm, auf dem eine XML-Config-URL die richtige Antwort ist.

Alles, was du auf diesem Weg hinzufügst, funktioniert weiter, nachdem dein Admin die Schule verbunden hat, und alles, was du danach hinzufügst, sendet auch seine Punktzahlen.

Was du bekommst
  • Aktivitäten werden direkt auf der Kursseite gespielt
  • Ergebnisse bleiben in Puzzel.org, unter deinem eigenen Konto
Was dir fehlt
  • Keine Notenbuch-Spalte, keine Punktzahlen in Canvas
  • Canvas verrät Puzzel.org nicht, wer der Schüler ist
Datenschutz für Schüler

Welche Schülerdaten erhält und speichert Puzzel.org für Noten?

Datenschutzerklärung lesen
  • Es kommt nur rein, was nötig ist

    Die Schüler-ID in Google Classroom oder im System deiner Schule — mit Name und E-Mail-Adresse nur, wenn das System sie freigibt. Nie Klassenlisten, andere Schüler oder sonstige Unterrichtsinhalte.

  • Es geht nur die Punktzahl raus

    Berechnet auf unseren Servern aus den gegebenen Antworten und an den Notenbuch-Eintrag genau dieses einen Schülers gesendet. Sonst nichts.

  • Gelöscht, sobald du stoppst

    Der Eintrag eines Schülers verschwindet, sobald die Lehrkraft die Synchronisierung der Aktivität beendet oder die Aktivität löscht. Bereits gesendete Punktzahlen bleiben im Notenbuch der Schule.

  • Die Schule behält die Kontrolle

    Deine Schule entscheidet, was mit den Daten ihrer Schüler geschieht; Puzzel.org verarbeitet sie nur in ihrem Auftrag.

Hängst du irgendwo fest?

Sag uns, bei welchem Schritt und was Canvas gemeldet hat, dann finden wir es gemeinsam mit dir heraus — Screenshots sind willkommen.

Andere Systeme