בדיקה שמערכת ה-SIS עומדת בדרישות של Google Classroom

כדי לשלב את SIS עם Classroom, עליכם לוודא שהמוצר עומד בדרישות השותפות של Classroom על ידי הרצת בדיקות התאימות שסופקו.

גישה לבדיקות והפעלה שלהן

אתם יכולים לגשת לבדיקות התאימות ב-GitHub. כדי להריץ את הבדיקות:

  • כתובת URL לאסימון לאחזור פרטי כניסה של OAuth 2.0
  • כתובת URL אחת של רשימת תלמידים המסתיימת ב-/ims/oneroster/v1p1
  • Client ID
  • סוד לקוח
  • כתובת האימייל של המורה

חבילת הבדיקה כוללת שלושה חלקים:

  • סנכרון ציונים בסיסי
  • קטגוריות ציונים
  • תקופות למתן ציונים

אתם יכולים להריץ את הבדיקות באמצעות Google Colab או Jupyter notebook. גם Colab וגם ה-notebook של Jupyter מאפשרים להריץ את כל הבדיקות בבת אחת. כך אפשר ליצור את תוצאות הבחינה כדי לשתף אותה עם צוות Google Classroom.

דרישות ב-SIS והתנהגות צפויה

מטרת הבדיקות שמוגדרות על ידי Google היא לשמור על עקביות ולצמצם את כמות השגיאות שהמשתמשים עשויים להיתקל בהן במהלך השימוש בשילובים של SIS עם Classroom. ריכזנו כאן כמה טיפים לגבי הבדיקות. ב-GitHub, כל בדיקה מסומנת ב-@title. הכותרות האלה מוזכרות בנקודות.

  1. שימו לב לקטעים הבאים לגבי הקטע סנכרון ציונים בסיסי:

    • בבדיקה של GetAllTeachers, נקודת הקצה GET /teachers מופעלת עם פרמטר שאילתה limit=. בבדיקות הבאות נעשה שימוש בפרמטר הזה כדי לוודא שהמוצר יכול לתמוך בגודל דף של 10,000 דפים.

    • בבדיקה של GetAllTeachers with email filter, נקודת הקצה GET /teachers מופעלת עם פרמטר שאילתה filter= שמשמש לסינון על סמך כתובת האימייל של המורה. תצטרכו לציין כתובת אימייל של מורה כשאתם מריצים את הבדיקות.

    • בבדיקה של GetClassesForTeacher, נקודת הקצה /teachers/{teacher_sourced_id}/classes מופעלת עם פרמטר שאילתה filter= שמשמש לסינון על סמך מחלקות פעילות.

    • בבדיקה של GetStudentsForClass מתבצעת קריאה לנקודת הקצה GET /classes/{class_sourced_id}/students?limit=10000. יש להחזיר את כתובת האימייל של התלמיד/ה בתשובה.

    • בבחינה של PutLineItem Create, לא צריך לציין קטגוריות של ציונים או תקופות למתן ציונים כשמתקשרים אל PUT /lineItems/{line_item_sourced_id}.

    • בבדיקה של PutLineItem Edit, הקריאה ל-API לא אמורה להחזיר שגיאה אם כולל אורך כותרת ארוך של ההקצאה. הבדיקה כוללת כותרת של המטלה באורך של יותר מ-100 תווים.

    • בבדיקה של PutResult Edit כדאי להגדיר ל-score ערך גדול יותר מ-resultValueMax כדי לייצג קרדיט נוסף.

    • נקודת הקצה DELETE /results/{result_sourced_id} נדרשת ונבדקת בבדיקה של DeleteResult.

    • לא חובה להזין את נקודת הקצה DELETE /lineItems/{line_item_sourced_id}. היא אופציונלית ומשמשת לניקוי נתונים.

  2. שימו לב לקטעים קטגוריות ציונים ותקופות למידה:

    • צריך רק נקודת קצה אחת של GET /categories. אם אתם מריצים את כל בדיקות התאימות בבת אחת, כדאי לכתוב על כך בהערה:
      • /categories?limit=10000
      • /classes/{class_sourced_id}/categories?limit=10000
    • התמיכה בתקופות למתן ציונים נבדקת על ידי אחזור הקריטריון term_sourced_id במבחן GetAllClasses w/ filter. term_sourced_id משמש לאחזור התקופות למתן ציונים במונח על ידי קריאה לנקודת הקצה GET terms/{term_sourced_id}/gradingPeriods?limit=10000 בבדיקה GetGradingPeriodsForTerm.

שיתוף תוצאות הבחינה עם צוות Google Classroom

אחרי שמריצים את הבדיקות, נוצר דוח מלא עם התוצאות של כל בדיקה. הבדיקות האלה עוזרות לקבוע אם המוצר עומד בדרישות הצריכה של OneRoster 1.1 של Google. מורידים או מצלמים צילום מסך של הדוח שנוצר. שולחים את הדוח וקישור לאישור של OneRoster 1.1 של המוצר לכתובת classroom-sis-external@google.com.

קבלת תמיכה

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