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