שותפי SIS המעוניינים יכולים להשתמש בבדיקות התאימות ב-GitHub כדי לקבוע אם המוצר שלהם עומד בדרישות השימוש ב-OneRoster ב-Google Classroom.
גישה להרצת הבדיקות
כדי להריץ את הבדיקות, נדרשים הדברים הבאים:
- כתובת ה-URL של הטוקן לאחזור פרטי הכניסה של OAuth 2.0
- כתובת URL של One Roster שמסתיימת ב-
/ims/oneroster/v1p1 - Client-ID
- סוד לקוח
- כתובת אימייל של מורה
אפשר להריץ את הבדיקות באמצעות Google Colab או Jupyter notebook. גם ב-Colab וגם ב-Jupyter notebook אפשר להריץ את כל הבדיקות בבת אחת. כך תוכלו ליצור את תוצאות הבדיקה ולשתף אותן עם צוות Google Classroom.
הדרישות וההתנהגות הצפויה של מערכת SIS
המבחנים שהוגדרו על ידי Google נועדו לספק לשותפי SIS מעוניינים דרך לקבוע אם המוצר שלהם עומד בדרישות של Google לשימוש ב-OneRoster, ולצמצם את מספר השגיאות שהמשתמשים עשויים להיתקל בהן כשהם משתמשים בשילובים של 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 נקראת. יש להחזיר את כתובת האימייל של התלמיד/ה בתשובה. |
| GetGradingPeriodsForTerm | התמיכה בתקופות למתן ציונים נבדקת באמצעות term_sourced_id. המזהה term_sourced_id משמש לאחזור התקופות למתן ציונים בסמסטר באמצעות קריאה לנקודת הקצה GET terms/{term_sourced_id}/gradingPeriods. |
| 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 היא אופציונלית, והיא בודקת שהפריט נמחק. |
שיתוף תוצאות הבדיקה עם צוות Google Classroom
אחרי שמריצים את הבדיקות, נוצר דוח מלא עם התוצאות של כל בדיקה. הבדיקות האלה משמשות לקביעת אם המוצר עומד בדרישות של Google לשימוש ב-OneRoster 1.1. מורידים את הדוח שנוצר או מצלמים את המסך שלו כדי לשתף אותו עם צוות Google Classroom.
קבלת תמיכה
אם יש לכם שאלות או בעיות, תוכלו לשלוח אימייל לכתובת classroom-sis-external@google.com.