L'iframe de découverte des pièces jointes est la vue initiale qui s'affiche pour un enseignant lorsqu'il ouvre un module complémentaire lors de la création d'un devoir Classroom. Une pièce jointe est le contenu ou l'activité avec lequel 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 des modules complémentaires. Pendant une courte période (de l'ordre de quelques heures), Classroom autorise le module complémentaire à ajouter des pièces jointes au post.
Figure 1 Vue de la création d'un devoir, y compris les options de modules complémentaires qu'un enseignant peut associer.
Lorsqu'un enseignant sélectionne un module complémentaire, Classroom crée une iframe de découverte de pièces jointes et charge l'URL de lancement du module complémentaire. Tous les paramètres de requête d'iframe pertinents sont transmis à l'URL de lancement.
Figure 2. Exemple d'UI de détection d'une pièce jointe 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 le fichier à l'exercice. 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 désormais 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.
- Un enseignant doit pouvoir prévisualiser une pièce jointe dans l'iframe avant de faire sa sélection finale.
- Un enseignant doit pouvoir rechercher ou parcourir des contenus pouvant être joints.
- Le module complémentaire peut fournir différentes vues, comme les contenus récents, mes contenus et le filtrage par compétences d'apprentissage.
- Le module complémentaire doit permettre de créer un élément pouvant être associé à partir de l'iframe.
Pour en savoir plus sur les exigences relatives à l'expérience utilisateur, consultez la checklist des exigences concernant les modules complémentaires Classroom.
Afficher l'état de la licence dans l'iframe
Si le module complémentaire nécessite une licence et que l'enseignant n'en dispose 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 pouvant découler de restrictions de licence.
Nous vous recommandons également de vérifier les points suivants:
- Indique le niveau de licence de l'enseignant dans l'iframe de découverte des pièces jointes.
- Masque ou désactive les contenus qui ne sont pas disponibles pour un enseignant en raison de restrictions au niveau de la licence.