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