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 (figure 1).
Figure 1 Vue de la création d'un devoir, y compris les options de modules complémentaires qu'un enseignant peut joindre.
Lorsqu'un enseignant sélectionne un module complémentaire, Classroom crée une 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 d'iframe pertinents sont transmis à l'URL de lancement (figure 2).
Figure 2. Exemple d'UI de détection d'une pièce jointe dans un iFrame.
Considérez la vue "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 à associer à son élément de flux. L'application du module complémentaire peut limiter les contenus affichés en fonction de la nature de l'élément de flux (annonce, devoir ou support de cours). L'application du module complémentaire effectue ensuite des appels d'API Classroom pour créer et joindre le fichier à l'exercice.
Lorsque 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 les pièces jointes, qu'il peut ensuite prévisualiser ou supprimer de l'exercice (figure 3). L'enseignant termine le flux 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 modules complémentaires de type activité.
Éléments à prendre en compte concernant l'expérience utilisateur
- 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 son choix final.
- Un enseignant doit pouvoir rechercher ou parcourir des contenus pouvant être joints.
- Le module complémentaire peut proposer 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 concernant l'expérience utilisateur, consultez la checklist des exigences pour les modules complémentaires Classroom.
État des licences
Si votre module complémentaire nécessite une licence pour votre produit, un message clair doit être affiché pour expliquer comment un enseignant sans licence peut remédier à la situation. Pensez également à masquer ou à désactiver les contenus qui ne sont pas disponibles pour un enseignant en raison de restrictions de licence.