برای ادغام SIS خود با Classroom، با اجرای مجموعه تست‌های انطباق ارائه شده، تأیید کنید که محصول شما با الزامات مشارکت Classroom مطابقت دارد.
به تست ها دسترسی پیدا کرده و اجرا کنید
می توانید به تست های انطباق در GitHub دسترسی داشته باشید. برای اجرای تست ها به موارد زیر نیاز دارید:
- نشانی اینترنتی رمز برای بازیابی اطلاعات کاربری OAuth 2.0
- یک URL فهرستی که به
/ims/oneroster/v1p1ختم می‌شود - شناسه مشتری
- راز مشتری
- آدرس ایمیل معلم
در مجموعه تست سه بخش وجود دارد:
- همگام سازی درجه پایه
- دسته بندی های درجه بندی
- دوره های درجه بندی
با استفاده از Google Colab یا Jupyter notebook می توانید تست ها را اجرا کنید. هر دو نوت بوک کولب و ژوپیتر به شما امکان می دهند همه تست ها را یکجا اجرا کنید. این به شما کمک می‌کند نتایج آزمایش را برای اشتراک‌گذاری با تیم Google Classroom ایجاد کنید.
الزامات SIS و رفتار مورد انتظار
تست‌های تعریف‌شده توسط Google برای حفظ ثبات و به حداقل رساندن خطاهایی که کاربران ممکن است در هنگام استفاده از ادغام‌های SIS با Classroom تجربه کنند وجود دارد. نکات زیر را در مورد آزمون ها بخوانید. در GitHub، هر آزمون دارای عنوانی است که در اشاره گرها به آن اشاره شده است. به خاطر داشته باشید که اشاره گرها می توانند به روشن شدن سؤالات کمک کنند، اما فهرست جامعی از آزمون ها نیست. مطمئن شوید که تمام تست های ارائه شده در GitHub را اجرا کرده اید.
همگام سازی درجه پایه
| تست کنید | اشاره گرها |
|---|---|
| معلمان: GetAllTeachers | نقطه پایانی GET /teachers با یک پارامتر query limit فراخوانی می شود. در آزمایش‌های بعدی، از این پارامتر برای اطمینان از اینکه محصول شما می‌تواند از اندازه صفحه ۱۰۰۰۰ پشتیبانی کند استفاده می‌شود. |
| معلمان: GetAllTeachers با فیلتر ایمیل | نقطه پایانی GET /teachers با یک پارامتر پرس و جو filter که برای فیلتر کردن بر اساس آدرس ایمیل معلم استفاده می شود، فراخوانی می شود. برای این کار از آدرس ایمیل معلمی که در بخش اعتبارنامه آزمون ها ارائه کرده اید استفاده می شود. |
| کلاس ها: GetClassesForTeacher | نقطه پایانی /teachers/{teacher_sourced_id}/classes با پارامتر کوئری filter که برای فیلتر کردن بر اساس کلاس‌های فعال استفاده می‌شود، فراخوانی می‌شود. |
| دانش آموزان: GetStudentsForClass | نقطه پایانی GET /classes/{class_sourced_id}/students فراخوانی می شود. ایمیل دانش آموز باید در پاسخ برگردانده شود. |
| LineItem: ایجاد کنید | هنگام تماس با PUT /lineItems/{line_item_sourced_id} به دسته‌های درجه‌بندی یا دوره‌های درجه‌بندی نیازی نیست. |
| Line Item: ویرایش | اگر طول عنوان تخصیص طولانی گنجانده شود، تماس 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 به اشتراک بگذارید
پس از اجرای تست ها، یک گزارش کامل با نتایج هر آزمون تولید می شود. این آزمایش‌ها برای تعیین اینکه آیا محصول شما با الزامات مصرف OneRoster 1.1 Google مطابقت دارد یا خیر استفاده می‌شود. گزارش تولید شده را دانلود یا اسکرین شات بگیرید. گزارش و پیوندی به گواهینامه OneRoster 1.1 محصول خود را به classroom-sis-external@google.com ایمیل کنید.
پشتیبانی دریافت کنید
برای هر گونه سوال یا نگرانی به classroom-sis-external@google.com ایمیل بزنید.