OneRoster لأنظمة معلومات الطلاب

يتوافق Google Classroom مع مزامنة دفتر العلامات واستيراد قوائم الطلاب المسجّلين في الصف لعدد من "أنظمة معلومات الطالب" الممتثلة لمعيار OneRoster. تتعاون Google مع منصات "نظام معلومات الطالب" التي تستوفي متطلبات OneRoster التي تحدّدها Google.

تتيح الشراكة مع Classroom للمشرفين ربط صفوفهم في Classroom بـ "نظام معلومات الطالب".

الشكل 1: عندما تتعاون "أنظمة معلومات الطالب" مع Classroom، يمكن للمشرفين اختيار "نظام معلومات الطالب" في القائمة المنسدلة.

رحلة تطوير الشركاء في "نظام معلومات الطالب"

إذا كنت مهتمًا بالشراكة مع Classroom، يُرجى ملء نموذج إبداء الاهتمام.

أنشأ فريق Classroom مجموعة من اختبارات المطابقة التي يمكن لشركاء "نظام معلومات الطالب" المهتمين استخدامها للتعرّف على متطلبات Google. يمكنك إجراء اختبارات المطابقة قبل التواصل مع فريق Classroom لتحديد مدى استيفاء منتجك لمتطلبات Google.

الحصول على نطاق تجريبي للمطوّرين

قد تحتاج إلى الوصول إلى نسخة مباشرة من Google Classroom لإنشاء عملية تكامل والتحقق منها. يحتاج مستخدمو الاختبار المؤهّلون إلى إصدار Google Workspace for Education Plus. إذا لم يكن لديك إذن مشرف للوصول إلى نطاق Google Workspace for Education يتضمّن هذه التراخيص، أكمل الخطوات للحصول على نطاق اختبار للمطوّرين واطلب ترقية النطاق التجريبي. سيتم توفير نطاقك مع 10 تراخيص Google Workspace for Education Plus.

الوصول إلى الاختبارات وإجراؤها

لإجراء الاختبارات، تحتاج إلى ما يلي:

  • عنوان URL للرمز المميّز لاسترداد بيانات اعتماد OAuth 2.0
  • عنوان URL لمعيار OneRoster ينتهي بـ ‎/ims/oneroster/v1p2
  • معرِّف العميل
  • سر العميل
  • عنوان بريد إلكتروني خاص بمعلّم

يمكنك إجراء الاختبارات باستخدام Google Colab أو Jupyter notebook. يتيح لك كل من Colab وJupyter notebook إجراء جميع الاختبارات في آنٍ واحد. يساعدك ذلك في إنشاء نتائج الاختبارات لمشاركتها مع فريق Google Classroom.

متطلبات "نظام معلومات الطالب" والسلوك المتوقّع

تم إنشاء الاختبارات التي تحدّدها Google لتزويد شركاء "نظام معلومات الطالب" المهتمين بطريقة لتحديد ما إذا كان منتجهم يستوفي متطلبات Google المتعلقة باستخدام OneRoster ولتقليل الأخطاء التي قد يواجهها المستخدمون عند استخدام عمليات تكامل "نظام معلومات الطالب" في 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 يجب ألا يعرض طلب بيانات من واجهة برمجة التطبيقات خطأً إذا تم تضمين عنوان واجب طويل. يتضمّن الاختبار عنوان مهمة يتألف من 100 حرف أو أكثر.
Result: Edit يجب أن يكون من الممكن ضبط score على قيمة أكبر من resultValueMax لتمثيل الدرجات الإضافية.
Result: Delete نقطة النهاية DELETE /results/{result_sourced_id} مطلوبة.
LineItem (اختياري / تنظيف): Delete and Get نقطة النهاية DELETE /lineItems/{line_item_sourced_id} غير مطلوبة. وهي اختيارية وتُستخدَم لتنظيف البيانات. نقطة النهاية اللاحقة GET /classes/{class_sourced_id}/lineItems اختيارية أيضًا، وتختبر ما إذا تم حذف عنصر وضع الدرجات.

مشاركة نتائج الاختبارات مع فريق Google Classroom

بعد إجراء الاختبارات، يتم إنشاء تقرير كامل يتضمّن نتائج كل اختبار. تُستخدَم هذه الاختبارات لتحديد ما إذا كان منتجك يستوفي متطلبات Google المتعلقة باستخدام OneRoster 1.2. نزِّل التقرير الذي تم إنشاؤه أو خذ لقطة شاشة له لمشاركته مع جهات الاتصال في فريق Google Classroom.