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 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. 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, 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 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 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.
- 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é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 joint à 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 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:
- 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.