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