כדי לשלב את מערכת ה-SIS עם Classroom, צריך להריץ את מבחני התאימות שסופקו כדי לוודא שהמוצר עומד בדרישות השותפות של Classroom.
גישה לבדיקות והרצה שלהן
אפשר לגשת לבדיקות התאימות ב-GitHub. כדי להריץ את הבדיקות:
- כתובת ה-URL של הטוקן לאחזור פרטי הכניסה של OAuth 2.0
- כתובת URL של One Roster שמסתיימת ב-
/ims/oneroster/v1p1 - Client-ID
- סוד לקוח
- כתובת אימייל של מורה
חבילת הבדיקות מורכבת משלושה קטעים:
- סנכרון ציונים בסיסי
- קטגוריות למתן ציונים
- תקופות למתן ציונים
אפשר להריץ את הבדיקות באמצעות Google Colab או Jupyter notebook. גם ה-notebook של Jupyter וגם של Colab מאפשרים להריץ את כל הבדיקות בבת אחת. כך תוכלו ליצור את תוצאות הבדיקה ולשתף אותן עם צוות Google Classroom.
הדרישות וההתנהגות הצפויה של מערכת SIS
הבדיקות שמוגדרות על ידי Google קיימות כדי לשמור על עקביות ולצמצם את כמות השגיאות שמשתמשים עשויים להיתקל בהן במהלך שימוש בשילובים של SIS עם Classroom. כדאי לקרוא את ההנחיות הבאות לגבי הבדיקות. ב-GitHub, לכל בדיקה יש כותרת שמופיעה בהפניות. חשוב לזכור שההפניות יכולות לעזור להבהיר שאלות, אבל הן לא רשימה מקיפה של הבדיקות. חשוב לוודא שרץתם את כל הבדיקות שזמינות ב-GitHub.
סנכרון של ציונים בסיסיים
| בדיקה | מצביעים |
|---|---|
| מורים: GetAllTeachers | נקודת הקצה GET /teachers נקראת עם פרמטר השאילתה limit. בבדיקות הבאות, הפרמטר הזה משמש כדי לוודא שהמוצר יכול לתמוך בגודל דף של 10,000. |
| מורים: GetAllTeachers עם מסנן אימייל | מתבצעת קריאה לנקודת הקצה (endpoint) GET /teachers באמצעות פרמטר השאילתה filter שמשמש לסינון לפי כתובת אימייל של מורה. המערכת תשתמש בכתובת האימייל של המורה שסיפקתם בקטע 'פרטי כניסה' בבחינות. |
| כיתות: GetClassesForTeacher | נקרא לנקודת הקצה /teachers/{teacher_sourced_id}/classes עם פרמטר שאילתה filter שמשמש לסינון על סמך כיתות פעילות. |
| סטודנטים: GetסטודנטsForClass | נקודת הקצה GET /classes/{class_sourced_id}/students נקראת. יש להחזיר את כתובת האימייל של התלמיד/ה בתשובה. |
| LineItem: Create | אין צורך לציין קטגוריות או תקופות למתן ציונים כשקוראים לפונקציה PUT /lineItems/{line_item_sourced_id}. |
| LineItem: עריכה | קריאת ה-API לא אמורה להחזיר שגיאה אם כותרת מטלה ארוכה כלולה. הכותרת של הבחינה כוללת יותר מ-100 תווים. |
| תוצאה: עריכה | צריך להיות אפשר להגדיר את score לערך גדול מ-resultValueMax כדי לייצג קרדיט נוסף. |
| תוצאה: מחיקה | חובה לציין את נקודת הקצה DELETE /results/{result_sourced_id}. |
| פריט (אופציונלי / ניקוי): מחיקה והורדה | לא חובה לציין את נקודת הקצה 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.