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