Google Classroom از وارد کردن فهرست ثبت‌نام‌شدگان و همگام‌سازی دفتر نمره برای تعدادی از «سیستم‌های اطلاعات محصلان» (SIS) سازگار با OneRoster پشتیبانی می‌کند. Google با پلاتفرم‌های «سیستم اطلاعات دانش‌آموزی» که الزامات OneRoster مشخص‌شده توسط Google را برآورده می‌کنند شریک می‌شود.
شکل ۱. وقتی «سیستم اطلاعات محصلان» (SIS) با Classroom شریک می‌شود، سرپرستان می‌توانند SIS را در منو کرکره‌ای انتخاب کنند.
مسیر آماده‌سازی شریک «سیستم اطلاعات دانش‌آموزی»
در زیر نمای کلی سریعی از سفر آماده‌سازی شریک «سیستم اطلاعات دانش‌آموزی» ارائه شده است:
ابراز علاقه: اگر به شراکت با Classroom علاقه دارید، فرم علاقه‌مندی را تکمیل کنید.
کاوش و اجرای آزمون‌های انطباق: برای اینکه بدانید آیا «سیستم اطلاعات دانش‌آموزی» شما برای ادغام با Classroom آماده است یا نه، می‌توانید آزمون‌های انطباق را مرور کنید تا با الزامات Google آشنا شوید. می‌توانید قبل‌از ابراز علاقه به تیم Google Classroom، آزمایش‌های انطباق را اجرا کنید تا مشخص شود محصولتان تا چه حد با الزامات Google مطابقت دارد.
با تیم Google Classroom تماس بگیرید: اگر فرصتی برای مشارکت وجود داشته باشد، تیم Classroom پس‌از ارسال فرم علاقه‌مندی با شما تماس خواهد گرفت.
نتایج آزمایشتان را هم‌رسانی کنید و ادغام سرتاسر را بسازید: وقتی تیم Classroom با شما تماس گرفت، نتایج آزمایش انطباق را هم‌رسانی کنید. تیم شما با Google همکاری خواهد کرد تا یکپارچه‌سازی را اعتبارسنجی و تکمیل کند.
آزمون‌های انطباق
آزمون‌های انطباق تعریف‌شده توسط Google برای ارائه راهی به شرکای «سیستم اطلاعات دانش‌آموزی» وجود دارد تا بتوانند تشخیص دهند که آیا محصولشان الزامات مصرف OneRoster در Google را برآورده می‌کند یا نه و خطاهایی را که ممکن است کاربران هنگام استفاده از ادغام‌های «سیستم اطلاعات دانش‌آموزی» در Classroom تجربه کنند به حداقل برسانند. آزمایش‌ها در GitHub منتشر شده‌اند.
دسترسی به آزمایش‌ها و اجرای آن‌ها
برای اجرای آزمایش‌ها، به موارد زیر نیاز دارید:
- نشانی وب کد برای بازیابی اعتبارنامه‌های OAuth 2.0
- نشانی وب One Roster که به
/ims/oneroster/v1p2ختم می‌شود - شناسه کارخواه
- رمز کارخواه
- نشانی ایمیل معلم
می‌توانید آزمایش‌ها را بااستفاده از Google Colab یا دفتر Jupyter اجرا کنید. هم Colab و هم دفترچه Jupyter به شما امکان می‌دهند همه آزمایش‌ها را به‌طور هم‌زمان اجرا کنید. این کار به شما کمک می‌کند نتایج آزمون را برای هم‌رسانی با تیم Google Classroom تولید کنید.
الزامات و رفتار موردانتظار
نکات زیر را درباره آزمایش‌ها بخوانید. در GitHub، هر آزمون دارای عنوانی است که در جدول به آن ارجاع داده شده است. این اشاره‌گرها می‌توانند به شفاف‌سازی سؤالات کمک کنند، اما فهرست کاملی از آزمایش‌ها نیستند. مطمئن شوید همه آزمایش‌های ارائه‌شده در GitHub را برای اطمینان از مطابقت اجرا کرده‌اید.
| آزمایش | اشاره‌گرها |
|---|---|
| معلمان: GetAllTeachers | نقطه پایانی GET /teachers با پارامتر پُرسمان limit فراخوانی می‌شود. در آزمایش‌های بعدی، از این پارامتر برای اطمینان از اینکه محصولتان می‌تواند از اندازه صفحه ۱۰٬۰۰۰ پشتیبانی کند استفاده می‌شود. |
| معلمان: GetAllTeachers با فیلتر ایمیل | نقطه پایانی GET /teachers با پارامتر پُرسمان filter فراخوانی می‌شود که برای فیلتر کردن براساس نشانی ایمیل معلم استفاده می‌شود. این کار از نشانی ایمیل معلمی که در بخش «اعتبارنامه‌ها» در آزمون‌ها ارائه کرده‌اید استفاده می‌کند. |
| کلاس‌ها: GetClassesForTeacher | نقطه پایانی /teachers/{teacher_sourced_id}/classes با پارامتر پُرسمان filter فراخوانی می‌شود که برای فیلتر کردن براساس کلاس‌های فعال استفاده می‌شود. |
| Students: 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 | اگر عنوان تکلیف طولانی باشد، فراخوانی میانای برنامه‌سازی کاربردی نباید خطا برگرداند. این آزمایش شامل طول عنوان تکلیف با بیش‌از ۱۰۰ نویسه است. |
| نتیجه: ویرایش | باید بتوان score را روی مقداری بیشتر از resultValueMax تنظیم کرد تا اعتبار اضافی را نشان دهد. |
| نتیجه: حذف | نقطه پایانی DELETE /results/{result_sourced_id} الزامی است. |
| LineItem (اختیاری / پاک‌سازی): حذف و دریافت | نقطه پایان DELETE /lineItems/{line_item_sourced_id} لازم نیست. این مورد اختیاری است و برای پاک‌سازی داده‌ها استفاده می‌شود. نقطه پایانی GET /classes/{class_sourced_id}/lineItems بعدی نیز اختیاری است و آزمایش می‌کند که خط سفارش حذف شده است یا نه. |
هم‌رسانی نتایج آزمایش با تیم Google Classroom
پس‌از اجرای آزمایش‌ها، گزارش کاملی با نتایج هر آزمایش تولید می‌شود. از نتایج برای تعیین اینکه آیا محصول شما الزامات مصرف OneRoster 1.2 Google را برآورده می‌کند یا نه استفاده می‌شود. گزارش تولیدشده را بارگیری کنید یا از آن نماگرفت بگیرید تا با مخاطبینتان در تیم Google Classroom هم‌رسانی کنید.
دریافت دامنه نمایشی توسعه‌دهنده
پس‌از اینکه نتایج آزمون انطباق شما توسط تیم Google Classroom بررسی شد، یک دامنه نمایشی توسعه‌دهنده به شما امکان می‌دهد تا یکپارچه‌سازی سرتاسری خود را اعتبارسنجی کنید. به‌خاطر داشته باشید که گذراندن موفقیت‌آمیز آزمون‌های انطباق، تضمینی برای تأیید مشارکت یا ادغام نیست.
دامنه نمایشی توسعه‌دهنده یک محیط آزمایشی زنده Google Classroom است که به شما کمک می‌کند تأیید کنید که ادغام شما طبق انتظار کار می‌کند. مراحل را تکمیل کنید تا دامنه نمایشی توسعه‌دهنده دریافت کنید و درخواست ارتقای دامنه نمایشی بدهید. این ارتقا دامنه شما را با ۱۰ پروانه Google Workspace for Education Plus تأمین می‌کند. این پروانه‌ها باید به کاربران آزمایشی در دامنه توسعه‌دهنده شما اختصاص داده شود تا بتوانند ویژگی‌های ادغام «سیستم اطلاعات دانش‌آموزی» را در Classroom آزمایش کنند.
پرسشگان
۱. Classroom چه مدل داده‌ای را از «سیستم اطلاعات دانش‌آموزی» انتظار دارد؟
Classroom از مشخصات OneRoster 1.2 پیروی می‌کند. اگر «سیستم اطلاعات دانش‌آموزی» شما از ساختار داده متفاوتی استفاده می‌کند، ممکن است با رفتار غیرمنتظره‌ای مواجه شوید. برای مثال، اگر سیستم شما از رابطه تودرتو بین دوره‌های نمره‌دهی و دسته‌های نمره‌دهی پشتیبانی می‌کند، این مورد خارج از مشخصات OneRoster 1.2 قرار می‌گیرد و باید ادغام خود را به‌طور کامل آزمایش کنید تا از سازگاری مناسب اطمینان حاصل کنید.
۲. کدام نمره‌ها و وضعیت‌های تکلیف به «سیستم اطلاعات دانش‌آموزی» صادر می‌شوند؟
فقط نمره‌های برگردانده‌شده یا موارد ارسالی علامت‌گذاری‌شده به‌عنوان «انجام‌نشده» یا «معاف‌شده» به «سیستم اطلاعات دانش‌آموزی» صادر می‌شوند. پیش‌نویس نمره‌ها صادر نمی‌شود.
۳. اگر تکلیفی در Classroom حذف شود، چه اتفاقی برای قلم کالا در «سیستم اطلاعات دانش‌آموزی» می‌افتد؟
حذف تکلیف در Classroom باعث حذف مورد سطری مربوطه در «سیستم اطلاعات دانش‌آموزی» نمی‌شود. این کار از حذف تصادفی داده‌ها و حذف آبشاری ناخواسته جلوگیری می‌کند.