الملخص
يتيح تكامل xAPI لـ KnowledgeCity إعادة توجيه نشاط التعلم إلى مخزن سجلات تعلم خارجي (Learning Record Store - LRS) لحظة حدوثه. باستخدام معالج xAPI الصادر، تُنشئ KnowledgeCity وترسل عبارات xAPI لأحداث التعلم الرئيسية بحيث يستقبل نظام إعداد التقارير الخاص بك سجلًا مباشرًا لتقدّم المتعلمين. تشرح هذه المقالة كيفية تفعيل xAPI، وتوجيهه إلى مخزن سجلات التعلم (LRS) الخاص بك، وتأمين الاتصال، واختيار الأحداث التي يتم إرسالها.
مقدمة
xAPI (المعروف أيضًا باسم Tin Can) هو معيار لوصف تجارب التعلم في صورة عبارات (statements) وتسليمها إلى مخزن سجلات تعلم. في KnowledgeCity، يراقب معالج xAPI الصادر أحداث التعلم، ويترجم كل حدث إلى عبارة xAPI، وينشرها إلى مخزن سجلات التعلم (LRS) الذي تُهيّئه. يحافظ هذا على تزامن نظام تحليلات أو امتثال خارجي مع ما يفعله المتعلمون فعليًا داخل المنصة.
يُدار هذا التكوين من قبل المسؤولين العامين (Super Admins) والمسؤولين المسؤولين عن ربط KnowledgeCity بأنظمة إعداد التقارير الخارجية. وهو مفيد كلما دمجت مؤسستك بيانات التعلم من مصادر متعددة في مخزن سجلات تعلم واحد، أو احتاجت إلى سجل قائم على المعايير وطويل الأمد لنشاط المتعلمين خارج KnowledgeCity.
المفاهيم الأساسية
- عبارة xAPI (xAPI statement): سجل موحّد لحدث تعلم واحد، يصف المتعلم (الفاعل)، والإجراء (الفعل)، والعنصر الذي تم التصرف بشأنه (الموضوع)، والذي ترسله KnowledgeCity إلى مخزن سجلات التعلم الخاص بك.
- مخزن سجلات التعلم (Learning Record Store - LRS): النظام الخارجي الذي يستقبل ويخزّن العبارات التي ترسلها KnowledgeCity، حتى تتمكن من إعداد التقارير عن النشاط هناك.
- مضيف LRS (LRS host): عنوان نقطة النهاية لمخزن سجلات التعلم الخاص بك حيث تنشر KnowledgeCity العبارات.
- مصادقة Bearer: خيار يُصادق كل طلب إلى مخزن سجلات التعلم برمز Bearer يوفره مزوّد LRS الخاص بك.
- مصادقة Basic: خيار يُصادق كل طلب باستخدام زوج اسم مستخدم وكلمة مرور يصدرهما مخزن سجلات التعلم الخاص بك.
- رؤوس مخصصة (Custom headers): رؤوس طلب إضافية يمكنك إضافتها حتى تُضمّن KnowledgeCity أي قيم إضافية يتطلبها مخزن سجلات التعلم الخاص بك في كل استدعاء.
- تخطيط الأحداث (Event mapping): التحديد الذي يتحكم في أحداث التعلم التي تتحول إلى عبارات، ويشمل
REGISTEREDوATTEMPTEDوCOMPLETEDوPASSEDوPROGRESSوINITIALIZED.
الخطوات التي يجب اتباعها
فتح صفحة التكاملات
سجّل الدخول بصفتك مسؤولًا عامًا (Super Admin)، وافتح قائمة الإعدادات في اللوحة العلوية من الواجهة، واختر التكاملات. سيفتح ذلك صفحة تفاصيل التكاملات، حيث تُجمَّع الاتصالات بالأنظمة الخارجية في أقسام.
تفعيل xAPI
حدد موقع تهيئة xAPI وفعّل خيار التفعيل (Enable). يُنشِّط تفعيل xAPI المعالج الصادر بحيث تصبح أحداث التعلم، من هذه النقطة فصاعدًا، مؤهلة للإرسال إلى مخزن سجلات التعلم الخاص بك.
تعيين مضيف LRS
في حقل مضيف LRS (LRS host)، أدخل عنوان نقطة النهاية لمخزن سجلات التعلم الخاص بك. تنشر KnowledgeCity كل عبارة xAPI إلى هذا العنوان، لذا تأكد من صحة القيمة مع مزوّد LRS الخاص بك قبل الاعتماد على الاتصال.
اختيار طريقة المصادقة
اختر كيفية مصادقة KnowledgeCity لمخزن سجلات التعلم الخاص بك:
- اختر Bearer وقدّم رمز Bearer الذي يوفره مخزن سجلات التعلم الخاص بك.
- اختر Basic وقدّم اسم المستخدم وكلمة المرور الصادرين عن مخزن سجلات التعلم الخاص بك.
استخدم الطريقة التي يحددها مزوّد LRS الخاص بك، وتعامل مع الرمز واسم المستخدم وكلمة المرور كأسرار لا ينبغي مشاركتها علنًا.
إضافة رؤوس مخصصة
إذا كان مخزن سجلات التعلم الخاص بك يتطلب قيمًا إضافية في كل طلب، أضفها كـ رؤوس مخصصة (custom headers). لكل رأس، قدّم اسمه وقيمته. تُضمّن KnowledgeCity هذه الرؤوس في كل عبارة ترسلها، إلى جانب المصادقة التي هيّأتها.
تخطيط الأحداث المطلوب إرسالها
اختر أحداث التعلم التي تحولها KnowledgeCity إلى عبارات. يمكن للمعالج إرسال عبارات للأحداث التالية:
REGISTERED: يتم تسجيل المتعلم في عنصر تعلّم.INITIALIZED: يبدأ المتعلم عنصر تعلّم.ATTEMPTED: يقوم المتعلم بمحاولة على عنصر تعلّم.PROGRESS: يتقدّم المتعلم في عنصر تعلّم.COMPLETED: يُنهي المتعلم عنصر تعلّم.PASSED: يحقق المتعلم معايير النجاح لعنصر تعلّم.
اختر فقط الأحداث التي تحتاجها تقاريرك، بحيث يستقبل مخزن سجلات التعلم العبارات المهمة ولا يمتلئ بنشاط لا تتتبعه.
الحفظ والتحقق
احفظ تهيئتك. بعد الحفظ، أنشئ نشاط تعلّم ذا صلة وتأكد من وصول العبارات المطابقة إلى مخزن سجلات التعلم الخاص بك. إذا لم تظهر العبارات، أعد التحقق من مضيف LRS، وقيم المصادقة، وأي رؤوس مخصصة مطلوبة.
الخاتمة
تهيئة تكامل xAPI تربط KnowledgeCity مباشرة بمخزن سجلات التعلم الخاص بك، بحيث تتدفق أحداث التسجيل والبدء والمحاولة والتقدّم والإنجاز والنجاح إلى الخارج في صورة عبارات موحّدة أثناء عمل المتعلمين. من خلال تفعيل xAPI، وتعيين مضيف LRS، وتأمين الاتصال بمصادقة Bearer أو Basic وأي رؤوس مخصصة، وتخطيط الأحداث التي تهمك، تمنح نظام إعداد التقارير الخارجي الخاص بك رؤية موثوقة وفي الوقت الفعلي لنشاط التعلم.