يتيح Google Classroom استيراد قائمة الطلاب المسجّلين ومزامنة دفتر العلامات لعدد من "أنظمة معلومات الطالب" (SIS) المتوافقة مع OneRoster. تتعاون Google مع منصات "نظام معلومات الطالب" التي تستوفي متطلبات OneRoster المحدّدة من Google.
الشكل 1: عندما تصبح "أنظمة معلومات الطالب" (SIS) شريكة لـ Classroom، يمكن للمشرفين اختيار نظام معلومات الطالب في القائمة المنسدلة.
رحلة إعداد شريك "نظام معلومات الطالب"
في ما يلي نظرة عامة سريعة على رحلة إعداد شركاء "نظام معلومات الطالب":
إبداء الاهتمام: إذا كنت مهتمًا بالشراكة مع Classroom، يُرجى ملء نموذج إبداء الاهتمام.
استكشاف اختبارات المطابقة وإجراؤها: لمعرفة ما إذا كان "نظام معلومات الطالب" جاهزًا للدمج مع Classroom، يمكنك مراجعة اختبارات المطابقة للتعرّف على متطلبات Google. يمكنك إجراء اختبارات المطابقة قبل إبداء اهتمامك لفريق Google Classroom لتحديد مدى توافق منتجك مع متطلبات Google.
التواصل مع فريق Google Classroom: سيتواصل معك فريق Classroom بعد إرسال نموذج إبداء الاهتمام إذا كانت هناك فرصة للشراكة.
مشاركة نتائج الاختبار وإنشاء عملية الدمج الشاملة: بعد أن يتواصل معك فريق Classroom، شارِك نتائج اختبار المطابقة. سيتعاون فريقك مع Google للتحقّق من عملية الدمج وإكمالها.
اختبارات المطابقة
تتوفّر اختبارات المطابقة التي تحدّدها Google لتزويد شركاء "نظام معلومات الطالب" بطريقة لتحديد ما إذا كان منتجهم يستوفي متطلبات استهلاك OneRoster من Google وللحدّ من الأخطاء التي قد يواجهها المستخدمون عند استخدام عمليات دمج "نظام معلومات الطالب" في Classroom. يتم نشر الاختبارات على GitHub.
الوصول إلى الاختبارات وإجراؤها
لإجراء الاختبارات، تحتاج إلى ما يلي:
- عنوان URL للرمز المميّز من أجل استرداد بيانات اعتماد OAuth 2.0
- عنوان URL لـ OneRoster ينتهي بـ
/ims/oneroster/v1p2 - معرِّف العميل
- سر العميل
- عنوان البريد الإلكتروني الخاص بالمعلّم
يمكنك إجراء الاختبارات باستخدام Google Colab أو ورقة ملاحظات Jupyter. يتيح لك كل من Colab وJupyter notebook إجراء جميع الاختبارات في وقت واحد. يساعدك ذلك في إنشاء نتائج الاختبارات لمشاركتها مع فريق Google 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 حرف. |
| النتيجة: تعديل | يجب أن يكون من الممكن ضبط السمة score على قيمة أكبر من السمة resultValueMax لتمثيل الرصيد الإضافي. |
| النتيجة: حذف | يجب إدخال نقطة نهاية DELETE /results/{result_sourced_id}. |
| LineItem (Optional / Cleanup): Delete and Get | نقطة النهاية DELETE /lineItems/{line_item_sourced_id} غير مطلوبة. وهو اختياري ويُستخدَم لتنظيف البيانات. نقطة النهاية اللاحقة GET /classes/{class_sourced_id}/lineItems اختيارية أيضًا، وتختبر ما إذا تم حذف البند الإعلاني. |
مشاركة نتائج الاختبار مع فريق Google Classroom
بعد إجراء الاختبارات، يتم إنشاء تقرير كامل يتضمّن نتائج كل اختبار. تُستخدَم النتائج لتحديد ما إذا كان منتجك يستوفي متطلبات استهلاك OneRoster 1.2 من Google. نزِّل التقرير الذي تم إنشاؤه أو خُذ لقطة شاشة له لمشاركته مع جهات الاتصال في فريق Google Classroom.
الحصول على نطاق تجريبي للمطوّرين
بعد أن يراجع فريق Google Classroom نتائج اختبار المطابقة، يتيح لك نطاق الإصدار التجريبي للمطوّرين التحقّق من صحة عملية الدمج الشاملة. يُرجى العِلم أنّ اجتياز اختبارات المطابقة بنجاح لا يضمن الموافقة على الشراكة أو الدمج.
نطاق العرض التوضيحي للمطوّرين هو بيئة اختبارية مباشرة في Google Classroom لمساعدتك في التأكّد من أنّ عملية الدمج تعمل على النحو المتوقّع. أكمِل الخطوات للحصول على نطاق تجريبي للمطوّرين وطلب ترقية النطاق التجريبي. توفّر الترقية لنطاقك 10 تراخيص من Google Workspace for Education Plus. يجب منح هذه التراخيص للمستخدمين التجريبيين في نطاق المطوّر الخاص بك ليتمكّنوا من اختبار ميزات التكامل مع "نظام معلومات الطالب" في Classroom.
الأسئلة الشائعة
1. ما هو نموذج البيانات الذي يتوقّعه Classroom من "نظام معلومات الطالب"؟
يتوافق Classroom مع مواصفات OneRoster 1.2. إذا كان نظام معلومات الطالب يستخدم بنية بيانات مختلفة، قد تواجه سلوكًا غير متوقّع. على سبيل المثال، إذا كان نظامك يتيح علاقة متداخلة بين فترات وضع الدرجات وفئات تقسيم الدرجات، فإنّ ذلك يقع خارج مواصفات OneRoster 1.2، وعليك اختبار عملية الدمج بدقة لضمان التوافق المناسب.
2. ما هي الدرجات وحالات الواجبات التي يتم تصديرها إلى "نظام معلومات الطالب"؟
يتم تصدير الدرجات التي تم إرجاعها أو المهام المرسَلة التي تم وضع علامة "متأخرة" أو "تم الإعفاء" عليها فقط إلى "نظام معلومات الطالب". ولا يتم تصدير الدرجات الأولية.
3. ماذا يحدث للعنصر في "نظام معلومات الطالب" إذا تم حذف واجب في Classroom؟
لا يؤدي حذف واجب دراسي في Classroom إلى حذف البند المقابل له في نظام معلومات الطالب. يمنع هذا فقدان البيانات غير المقصود وعمليات الحذف المتتالية غير المقصودة.