L'iFrame de découverte de pièces jointes est la vue initiale qui s'affiche pour un enseignant lorsque ouvrir un module complémentaire pendant la création d'une tâche Classroom. Une attachment : contenu ou activité que les élèves doivent suivre avec lesquelles interagir.
À partir d'un cours Classroom, un enseignant crée un post (par un devoir, une annonce ou une question, par exemple) et sélectionne un module complémentaire parmi la liste déroulante des modules complémentaires. Pendant une courte période (de l'ordre de quelques heures), Classroom permet au module complémentaire d'ajouter des pièces jointes au post.
Figure 1. Vue d'un
création d'un devoir, y compris les éventuels modules complémentaires qu'un enseignant peut joindre
Lorsqu'un enseignant sélectionne un module complémentaire, Classroom crée une pièce jointe Discovery iFrame et charge l'URL de lancement du module complémentaire. Toute requête iFrame pertinente sont transmis à l'URL de lancement.
Figure 2. Exemple d'interface utilisateur de détection de pièces jointes dans un iFrame
L'enseignant utilise l'application Web du partenaire, dans un iFrame, pour sélectionner une
en pièce jointe. L'application effectue des appels vers l'API Classroom pour joindre la pièce jointe.
au devoir. Lorsque l'enseignant a terminé de sélectionner des pièces jointes, la
Le module complémentaire envoie une charge utile postMessage demandant la fermeture de l'iFrame.
L'iFrame se ferme et l'enseignant peut maintenant voir les pièces jointes prévisualisez ou supprimez le devoir.
Figure 3. Vue de la création d'un devoir avec un module complémentaire à trois types d'activités et les pièces jointes.
Considérations relatives à l'expérience utilisateur dans l'iFrame
- Lors de l'ouverture initiale, le module complémentaire doit inviter l'enseignant à se connecter.
- L'authentification unique Google est requise pour tous les appels d'API Classroom. Si votre produit dispose d'un système de connexion distinct, vous devez associer les comptes.
- L'enseignant doit pouvoir prévisualiser une pièce jointe dans l'iFrame avant effectuant leur sélection finale.
- L'enseignant doit pouvoir rechercher ou parcourir les fichiers contenus.
- Le module complémentaire peut proposer différents affichages, comme des contenus récents, mon contenus et filtrer par compétence d'apprentissage.
- Le module complémentaire doit permettre de créer un élément pouvant être joint à partir de dans l'iFrame.
Pour en savoir plus, consultez la checklist des exigences concernant les modules complémentaires Classroom. sur les exigences UX.
Afficher l'état des licences dans l'iFrame
Si le module complémentaire nécessite une licence alors que l'enseignant n'en possède pas, un message doit être présenté à l'enseignant pour l'informer de la les mesures à prendre pour remédier à la situation. Cela permet d'éviter toute confusion éventuelle des restrictions de licence.
Nous vous recommandons également d'utiliser ce module complémentaire:
- Affiche le niveau de licence de l'enseignant dans la découverte de pièces jointes iFrame.
- Masque ou désactive le contenu qui n'est pas disponible pour un enseignant en raison d'une licence ou des restrictions de niveau.