כדי לשלב את מערכת ה-SIS עם Classroom, צריך להריץ את מבחני התאימות שסופקו כדי לוודא שהמוצר עומד בדרישות השותפות של Classroom.
גישה להרצת הבדיקות
אפשר לגשת לבדיקות התאימות ב-GitHub. כדי להריץ את הבדיקות, נדרשים הדברים הבאים:
- כתובת ה-URL של הטוקן לאחזור פרטי הכניסה של OAuth 2.0
- כתובת URL של One Roster שמסתיימת ב-
/ims/oneroster/v1p1 - Client-ID
- סוד לקוח
- כתובת אימייל של מורה
חבילת הבדיקות מורכבת משלושה קטעים:
- סנכרון ציונים בסיסי
- קטגוריות למתן ציונים
- תקופות למתן ציונים
אפשר להריץ את הבדיקות באמצעות Google Colab או Jupyter notebook. גם ב-Colab וגם ב-Jupyter notebook אפשר להריץ את כל הבדיקות בבת אחת. כך תוכלו ליצור את תוצאות הבדיקה ולשתף אותן עם צוות Google Classroom.
הדרישות וההתנהגות הצפויה של מערכת SIS
הבדיקות שהוגדרו על ידי Google נועדו לשמור על עקביות ולצמצם את מספר השגיאות שעשויות להתרחש אצל משתמשים שמשתמשים בשילובים של מערכת ניהול נתונים של בית ספר (SIS) עם Classroom. כדאי לקרוא את ההנחיות הבאות לגבי הבדיקות. ב-GitHub, לכל בדיקה יש כותרת שמופיעה בהפניות. חשוב לזכור שההפניות יכולות לעזור להבהיר שאלות, אבל הן לא רשימה מקיפה של הבדיקות. חשוב לוודא שרץתם את כל הבדיקות שזמינות ב-GitHub.
סנכרון ציונים בסיסי
| בדיקה | מצביעים |
|---|---|
| מורים: GetAllTeachers | נקודת הקצה GET /teachers נקראת עם פרמטר השאילתה limit. בבדיקות הבאות, הפרמטר הזה משמש כדי לוודא שהמוצר יכול לתמוך בגודל דף של 10,000. |
| מורים: GetAllTeachers עם מסנן אימייל | נקודה GET /teachers בקצה העורפי נקראת עם פרמטר שאילתה filter שמשמש לסינון על סמך כתובת האימייל של המורה. המערכת תשתמש בכתובת האימייל של המורה שסיפקתם בקטע 'פרטי כניסה' בבחינות. |
| כיתות: GetClassesForTeacher | נקרא לנקודת הקצה /teachers/{teacher_sourced_id}/classes עם פרמטר שאילתה filter שמשמש לסינון על סמך כיתות פעילות. |
| תלמידים: GetStudentsForClass | נקודת הקצה GET /classes/{class_sourced_id}/students נקראת. יש להחזיר את כתובת האימייל של התלמיד/ה בתשובה. |
| LineItem: Create | אין צורך לציין קטגוריות או תקופות למתן ציונים כשקוראים לפונקציה PUT /lineItems/{line_item_sourced_id}. |
| LineItem: עריכה | קריאת ה-API לא אמורה להחזיר שגיאה אם כותרת מטלה ארוכה כלולה. הבדיקה כוללת כותרת של מטלה באורך של יותר מ-100 תווים. |
| תוצאה: עריכה | צריך להיות אפשר להגדיר את score לערך גדול מ-resultValueMax כדי לייצג קרדיט נוסף. |
| תוצאה: מחיקה | חובה לציין את נקודת הקצה DELETE /results/{result_sourced_id}. |
| LineItem (אופציונלי / ניקוי): מחיקה וקבלה | אין צורך בנקודת הקצה DELETE /lineItems/{line_item_sourced_id}. השדה הזה הוא אופציונלי ומשמש לניקוי נתונים. גם נקודת הקצה הבאה GET /classes/{class_sourced_id}/lineItems היא אופציונלית, והיא בודקת שהפריט נמחק. |
קטגוריות למתן ציונים
| בדיקה | מצביעים |
|---|---|
| GetAllCategories או GetCategoriesForClass | נדרשת רק נקודת קצה אחת מסוג GET /categories, GetAllCategories או GetCategoriesForClass. אם מריצים את כל הבדיקות בבת אחת, צריך להוסיף הערה על הבדיקה שלא משתמשים בה. |
| DeleteLineItem (אופציונלי / ניקוי) | הבדיקה DeleteLineItem היא אופציונלית וניתן להשתמש בה לניקוי נתונים. |
תקופות למתן ציונים
| בדיקה | מצביעים |
|---|---|
| GetGradingPeriodsForTerm | כדי לבדוק את התמיכה בתקופות למתן ציונים, מאחזרים את term_sourced_id בבדיקת GetAllClasses עם מסנן. הערך של term_sourced_id משמש לאחזור תקופות למתן ציונים בסמסטר, באמצעות קריאה לנקודת הקצה GET terms/{term_sourced_id}/gradingPeriods בבדיקת GetGradingPeriodsForTerm. |
שיתוף תוצאות הבדיקה עם צוות Google Classroom
אחרי שתפעילו את הבדיקות, ייווצר דוח מלא עם התוצאות של כל בדיקה. הבדיקות האלה משמשות לקביעת אם המוצר עומד בדרישות של Google לשימוש ב-OneRoster 1.1. מורידים את הדוח שנוצר או מצלמים את המסך שלו. שולחים את הדוח ואת הקישור להסמכת OneRoster 1.1 של המוצר לכתובת classroom-sis-external@google.com.
קבלת תמיכה
אם יש לכם שאלות או בעיות, תוכלו לשלוח אימייל לכתובת classroom-sis-external@google.com.