L'iFrame de découverte de pièces jointes est la vue initiale qui s'affiche lorsque l'enseignant ouvre un module complémentaire pendant la création d'une tâche Classroom. Une pièce jointe désigne le contenu ou l'activité avec lesquels vous souhaitez que les élèves interagissent.
Dans 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 quelques heures), Classroom permet au module complémentaire d'ajouter des pièces jointes au post.
Figure 1. Vue de la création d'un devoir avec les éventuels modules 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 de 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 des 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 maintenant 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 modules complémentaires de type activité.
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 de pouvoir effectuer sa sélection finale.
- L'enseignant doit pouvoir rechercher ou parcourir les contenus pouvant être joints.
- Le module complémentaire peut fournir différents affichages, tels que "Contenus récents", "Mon contenu" et filtrer par compétences acquises.
- 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 concernant 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 alors que l'enseignant n'en possède pas, un message clair doit lui être présenté pour l'informer des prochaines étapes à suivre pour remédier à la situation. Cela permet d'éviter toute confusion due aux restrictions de licence.
Nous vous recommandons également d'utiliser ce module complémentaire:
- Affiche le niveau de licence de l'enseignant dans l'iFrame de découverte de pièces jointes.
- Masque ou désactive le contenu qui n'est pas disponible pour un enseignant en raison de restrictions liées au niveau de licence.