Der iframe für die Suche nach Anhängen ist die erste Ansicht, die Lehrkräften angezeigt wird, wenn sie beim Erstellen einer Classroom-Aufgabe ein Add-on öffnen. Ein Anhang ist der Inhalt oder die Aktivität, mit dem bzw. der die Schüler interagieren sollen.
Ein Kursleiter erstellt in einem Classroom-Kurs einen neuen Beitrag (z. B. eine Aufgabe, eine Mitteilung oder eine Frage) und wählt ein Add-on aus der Drop-down-Liste für Add-ons aus. Für kurze Zeit (etwa ein paar Stunden) kann das Add-on dem Beitrag über Classroom Anhänge hinzufügen.
Abbildung 1 Ansicht der Erstellung einer Aufgabe mit den möglichen Add-on-Optionen, die ein*e Lehrkraft anhängen kann.
Sobald ein Pädagoge ein Add-on ausgewählt hat, wird in Classroom ein Attachment Discovery-Iframe erstellt und die Start-URL des Add-ons geladen. Alle relevanten Iframe-Suchparameter werden an die Start-URL übergeben.
Abbildung 2: Beispiel für die Benutzeroberfläche der Erkennung von Anhängen in einem iFrame.
Die Lehrkraft wählt über die Webanwendung des Partners in einem Iframe einen Anhang aus. Die App sendet Classroom API-Aufrufe, um den Anhang an die Aufgabe anzuhängen. Wenn die Lehrkraft mit der Auswahl der Anhänge fertig ist, sendet das Add-on eine postMessage-Nutzlast, in der der Iframe geschlossen werden soll.
Der Iframe wird geschlossen und die Lehrkraft kann sich nun die Anhänge ansehen, die sie sich in einer Vorschau anzeigen oder aus der Aufgabe entfernen kann.
Abbildung 3: Ansicht einer Aufgabe mit drei Add-on-Anhängen vom Typ „Aktivität“.
UX-Aspekte im iFrame
- Beim ersten Öffnen muss das Add-on die Lehrkraft auffordern, sich anzumelden.
- Für alle Classroom API-Aufrufe ist die Google-Einmalanmeldung erforderlich. Wenn Ihr Produkt ein separates Anmeldesystem hat, müssen Sie Konten verknüpfen.
- Lehrkräfte müssen sich eine Vorschau eines Anhangs im IFrame ansehen können, bevor sie eine endgültige Auswahl treffen.
- Lehrkräfte sollten nach anhängenbaren Inhalten suchen oder diese durchsuchen können.
- Das Add-on kann verschiedene Ansichten wie „Letzte Inhalte“, „Meine Inhalte“ und Filter nach Lernkompetenzen bieten.
- Das Add-on muss die Möglichkeit bieten, ein neues anpaßbares Element innerhalb des iframes zu erstellen.
Weitere Informationen zu den UX-Anforderungen finden Sie in der Checkliste für Anforderungen an Classroom-Add-ons.
Lizenzstatus im Iframe anzeigen
Wenn für das Add-on eine Lizenz erforderlich ist und die Lehrkraft keine hat, muss sie über die nächsten Schritte zur Behebung des Problems informiert werden. So werden Unklarheiten vermieden, die durch Lizenzbeschränkungen entstehen können.
Außerdem haben wir empfohlen, dass Ihr Add-on
- Die Lizenzierungsebene der Lehrkraft wird im IFrame für die Attachment Discovery angezeigt.
- Inhalte werden ausgeblendet oder deaktiviert, die aufgrund von Einschränkungen auf Lizenzebene für einen Lehrer nicht verfügbar sind.