Der iFrame für die Anhangerkennung ist die erste Ansicht, die eine Lehrkraft sieht, wenn sie beim Erstellen einer Classroom-Aufgabe ein Add-on öffnet. Ein Anhang sind die Inhalte oder Aktivitäten, mit denen die Schüler und Studenten interagieren sollen.
Innerhalb eines Classroom-Kurses erstellt eine Lehrkraft einen neuen Beitrag (z. B. eine Aufgabe, Ankündigung oder Frage) und wählt ein Add-on aus der Drop-down-Liste aus. Für kurze Zeit (in der Reihenfolge von Stunden) kann das Add-on dem Beitrag in Classroom Anhänge hinzufügen.
Abbildung 1. Ansicht einer Aufgabenerstellung, einschließlich der möglichen Add-on-Optionen, die eine Lehrkraft anhängen kann.
Sobald eine Lehrkraft ein Add-on ausgewählt hat, erstellt Classroom einen iFrame für die Anhangerkennung und lädt die Start-URL des Add-ons. Alle relevanten iFrame-Abfrageparameter werden an die Start-URL übergeben.
Abbildung 2: Beispiel für eine UI zur Erkennung von Anhängen in einem iFrame
Die Lehrkraft verwendet die Webanwendung des Partners in einem iFrame, um einen Anhang auszuwählen. Die App führt Classroom API-Aufrufe aus, um den Anhang an die Aufgabe anzuhängen. Wenn die Lehrkraft die Anhänge ausgewählt hat, sendet das Add-on eine postMessage-Nutzlast, um das Schließen des iFrames anzufordern.
Der iFrame wird geschlossen und die Lehrkraft kann jetzt die Anhänge sehen, die sie in der Vorschau ansehen oder aus der Aufgabe entfernen kann.
Abbildung 3: Ansicht einer Aufgabenerstellung mit drei Add-on-Anhängen des Typs „Aktivität“.
UX-Aspekte innerhalb des iFrames
- Beim ersten Öffnen muss die Lehrkraft vom Add-on dazu aufgefordert werden, sich anzumelden.
- Die Einmalanmeldung (SSO) von Google ist für alle Classroom API-Aufrufe erforderlich. Wenn Ihr Produkt ein separates Anmeldesystem hat, müssen Sie die Konten verknüpfen.
- Eine Lehrkraft muss in der Lage sein, einen Anhang im iFrame als Vorschau anzusehen, bevor sie eine endgültige Auswahl trifft.
- Lehrkräfte sollten nach anhängbaren Inhalten suchen bzw. diese durchsuchen können.
- Das Add-on kann verschiedene Ansichten enthalten, z. B. aktuelle Inhalte und meine Inhalte. Außerdem kann es nach Lernfähigkeiten gefiltert werden.
- Das Add-on muss die Möglichkeit bieten, ein neues Element zu erstellen, das aus dem iFrame hinzugefügt werden kann.
Weitere Informationen zu Anforderungen an die Nutzerfreundlichkeit finden Sie in der Checkliste zu den Anforderungen des Classroom-Add-ons.
Lizenzstatus im iFrame anzeigen
Falls für das Add-on eine Lizenz erforderlich ist und die Lehrkraft keine hat, muss eine deutliche Meldung angezeigt werden, die sie über die nächsten Schritte zur Behebung des Problems informiert. So soll Unklarheiten aufgrund von Lizenzbeschränkungen vermieden werden.
Außerdem empfehlen wir Folgendes für Ihr Add-on:
- Zeigt die Lizenzstufe der Lehrkraft im iFrame der Anhangerkennung an.
- Blendet Inhalte ein oder aus, die für eine Lehrkraft aufgrund von Einschränkungen der Lizenzierungsstufe nicht verfügbar sind.