L'iFrame Discovery des pièces jointes est la vue initiale présentée à un enseignant lorsqu'il ouvre un module complémentaire pendant la création d'une tâche Classroom. Une pièce jointe correspond au contenu ou à l'activité avec lesquels vous souhaitez que les élèves interagissent.
Depuis un cours Classroom, un enseignant crée un post (par exemple, un devoir, une annonce ou une question) et sélectionne un module complémentaire dans la liste déroulante. Pendant une courte période (de l'ordre de plusieurs heures), Classroom autorise le module complémentaire à ajouter des pièces jointes au post.
Figure 1. Vue de la création d'un devoir, avec les éventuelles options complémentaires qu'un enseignant peut joindre
Lorsqu'un enseignant sélectionne un module complémentaire, Classroom crée un iFrame de découverte des pièces jointes et charge l'URL de lancement du module complémentaire. Tous les paramètres de requête iFrame pertinents sont transmis à l'URL de lancement.
Figure 2. Exemple d'interface utilisateur de détection des pièces jointes dans un iFrame.
L'enseignant utilise l'application Web du partenaire, dans un iFrame, pour sélectionner une pièce jointe. L'application effectue des appels d'API Classroom pour joindre la pièce jointe au devoir. Lorsque l'enseignant a terminé de sélectionner les pièces jointes, le module complémentaire envoie une charge utile postMessage demandant la fermeture de l'iFrame.
L'iFrame se ferme et l'enseignant peut voir les pièces jointes qu'il peut prévisualiser ou supprimer du devoir.
Figure 3. Vue de la création d'un devoir avec trois pièces jointes de module complémentaire de type activité.
Considérations relatives à l'expérience utilisateur dans l'iFrame
- Lors de la première ouverture, 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 des comptes.
- Un enseignant doit pouvoir prévisualiser une pièce jointe dans l'iFrame avant de procéder à sa sélection finale.
- Les enseignants doivent pouvoir rechercher ou parcourir les contenus pouvant être joints.
- Le module complémentaire peut proposer différentes vues, telles que les contenus récents ou mon contenu, et filtrer par compétences d'apprentissage.
- Le module complémentaire doit permettre de créer un élément pouvant être joint à partir de l'iFrame.
Pour en savoir plus sur les exigences liées à l'expérience utilisateur, consultez la checklist des exigences concernant le module complémentaire Classroom.
Afficher l'état des licences dans l'iFrame
Si le module complémentaire nécessite une licence et que l'enseignant n'en possède pas, vous devez lui présenter un message clair lui indiquant la marche à suivre pour résoudre le problème. Cela permet d'éviter toute confusion liée aux restrictions liées aux licences.
Nous vous recommandons également que votre module complémentaire:
- Affiche le niveau de licence de l'enseignant dans l'iFrame de découverte des pièces jointes.
- Masque ou désactive le contenu qui n'est pas accessible à un enseignant en raison des restrictions liées aux licences.