L'iframe de découverte des pièces jointes est la vue initiale affichée à un enseignant lorsqu'il ouvre un module complémentaire lors de 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 (figure 1).
Figure 1. Vue de la création d'un devoir, y compris les options de module complémentaire qu'un enseignant peut joindre.
Une fois qu'un enseignant a sélectionné 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).
Figure 2. Exemple d'interface utilisateur de découverte des pièces jointes dans un iframe.
Considérez la vue de découverte des pièces jointes comme la page de destination des enseignants dans votre module complémentaire. En règle générale, l'enseignant utilise l'application Web du partenaire dans l'iframe pour sélectionner le contenu à joindre à son élément de flux. L'application du module complémentaire peut limiter le contenu affiché selon que l'élément de flux est une annonce, un devoir ou un matériel de cours. L'application du module complémentaire effectue ensuite des appels à l'API Classroom pour créer la pièce jointe et la joindre au devoir.
Une fois que l'enseignant a terminé de sélectionner et de créer 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 voit alors les pièces jointes, qu'il peut choisir de prévisualiser ou de supprimer du devoir (figure 3). L'enseignant termine le processus de création en attribuant l'élément de flux à ses élèves.
Figure 3. Vue de la création d'un devoir avec trois pièces jointes de module complémentaire de type activité.
Considérations sur l'expérience utilisateur
- 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 à l'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 son choix final.
- Un enseignant doit pouvoir rechercher ou parcourir le contenu joignable.
- Le module complémentaire peut proposer différentes vues, telles que le contenu récent, mon contenu et le filtrage par compétences d'apprentissage.
- Le module complémentaire doit permettre de créer un élément joignable dans l'iframe.
Pour en savoir plus sur les exigences concernant l'expérience utilisateur, consultez la checklist des exigences concernant les modules complémentaires Classroom.
État des licences
Si votre module complémentaire nécessite une licence pour votre produit, un message clair doit expliquer comment un enseignant sans licence peut résoudre le problème. Envisagez également de masquer ou de désactiver le contenu qui n'est pas disponible pour un enseignant en raison de restrictions de licence.