ה-iframe של Attachment Discovery הוא התצוגה הראשונית שמוצגת למורים כשהם פותחים תוסף במהלך יצירת מטלה ב-Classroom. קובץ מצורף הוא התוכן או הפעילות שאתם רוצים שהתלמידים יתכתבו איתם.
מתוך קורס ב-Classroom, המורה יוצר פוסט חדש (למשל מטלה, הודעה או שאלה) ובוחר תוסף מהתפריט הנפתח של התוספים. למשך זמן קצר (כמה שעות), Classroom מאפשר לתוסף להוסיף קבצים מצורפים לפרסום.
איור 1. תצוגה של יצירה של מטלה, כולל האפשרויות הנוספות שהמורה יכול לצרף.
אחרי שמורה בוחר תוסף, מערכת Classroom יוצרת iframe של Attachment Discovery ומטעינה את כתובת ה-URL להפעלת התוסף. כל פרמטר של שאילתה ב-iframe רלוונטי מועבר לכתובת ה-URL של ההשקה.
איור 2. דוגמה לממשק משתמש של גילוי קבצים מצורפים ב-iframe.
המורה משתמש באפליקציית האינטרנט של השותף, בתוך iframe, כדי לבחור קובץ מצורף. האפליקציה מבצעת קריאות ל-API של Classroom כדי לצרף את הקובץ למטלה. כשהמורה מסיים לבחור את הקבצים המצורפים, התוסף שולח עומס נתונים (payload) מסוג postMessage עם בקשה לסגירת ה-iframe.
ה-iframe נסגר והמורה יכול לראות עכשיו את הקבצים המצורפים. הוא יכול לצפות בתצוגה המקדימה שלהם או להסיר אותם מהמטלה.
איור 3. תצוגה של יצירת מטלה עם שלושה קבצים מצורפים מסוג 'פעילות'.
שיקולים לגבי חוויית המשתמש בתוך ה-iframe
- בפתיחה הראשונית, התוסף צריך להציג למורה בקשה להיכנס לחשבון.
- צריך להשתמש ב-Google SSO לכל הקריאות ל-Classroom API. אם למוצר יש מערכת כניסה נפרדת, צריך לקשר את החשבונות.
- המורים צריכים להיות מסוגלים לראות תצוגה מקדימה של הקובץ המצורף בתוך ה-iframe לפני שהם מבצעים את הבחירה הסופית.
- המורים אמורים להיות מסוגלים לחפש תוכן שאפשר לצרף או לעיין בו.
- התוסף עשוי לספק מגוון תצוגות, כמו 'תוכן מהזמן האחרון', 'התוכן שלי' ואפשרות לסנן לפי מיומנויות למידה.
- התוסף חייב לספק אפשרות ליצור פריט חדש שניתן לצרף מתוך ה-iframe.
פרטים נוספים על דרישות ממשק המשתמש מופיעים ברשימת המשימות של דרישות התוספים ל-Classroom.
הצגת סטטוס הרישוי בתוך ה-iframe
אם נדרש רישיון כדי להשתמש בתוסף והמורה לא מחזיק ברישיון, חובה להציג למורה הודעה ברורה עם השלבים הבאים שצריך לבצע כדי לפתור את הבעיה. המטרה היא למנוע בלבול שעלול להיגרם כתוצאה מהגבלות הרישוי.
בנוסף, המלצנו שהתוסף:
- הצגת רמת הרישוי של המורה בתוך ה-iframe של Attachment Discovery.
- הסתרה או השבתה של תוכן שלא זמין למורה בגלל הגבלות ברמת הרישוי.