OneRoster למערכות מידע על תלמידים

ב-Google Classroom יש תמיכה בסנכרון של גיליון הציונים ובייבוא של רשימות תלמידים במספר מערכות לניהול מידע על תלמידים (SIS) שתואמות ל-OneRoster. Google עובדת בשיתוף עם פלטפורמות SIS שעומדות בדרישות OneRoster שנקבעו על ידי Google.

השותפות עם Classroom מאפשרת לאדמינים לקשר את הכיתות שלהם ב-Classroom למערכת ה-SIS שלכם.

איור 1. כשמערכת לניהול מידע על תלמידים (SIS) שותפה ל-Classroom, האדמינים יכולים לבחור את ה-SIS בתפריט הנפתח.

תהליך הפיתוח של שותפי SIS

אם אתם מעוניינים לשתף פעולה עם Classroom, תוכלו לפנות אלינו בכתובת classroom-sis-external@google.com כדי לקבל מידע נוסף.

צוות Classroom יצר קבוצה של בדיקות תאימות ששותפי SIS מעוניינים יכולים להשתמש בהן כדי להכיר את הדרישות של Google. אתם יכולים להריץ את בדיקות התאימות לפני שתיצרו קשר עם צוות Classroom כדי לקבוע עד כמה המוצר שלכם עומד בדרישות של Google.

גישה להרצת הבדיקות

כדי להריץ את הבדיקות, נדרשים הדברים הבאים:

  • כתובת ה-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: Edit קריאת ה-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.2. מורידים את הדוח שנוצר או מצלמים את המסך שלו כדי לשתף אותו עם צוות Google Classroom.

קבלת תמיכה

אם יש לכם שאלות או בעיות, תוכלו לשלוח אימייל לכתובת classroom-sis-external@google.com.