الرئيسية / التوثيق البرمجي / xapi

🏛️ الدليل الشامل لربط معايير xAPI مع المركز الوطني (NELC / FutureX) وبلاك بورد Ultra

💬 طلب خدمة تنصيب / استشارة

🏛️ الدليل الشامل لربط معايير xAPI مع المركز الوطني (NELC / FutureX) وبلاك بورد Ultra

هذا الدليل الفني يحدد كيفية ربط مزودي خدمات التعليم والتدريب (Education Providers) بنظام FutureX / NELC التابع للمركز الوطني للتعليم الإلكتروني في المملكة العربية السعودية باستخدام معيار xAPI (Tin Can API)، بالإضافة إلى قاموس المطابقة الشامل لنظام Blackboard Ultra.

🗂️ فهرس الدليل

  1. نظرة عامة على ربط NELC / FutureX
  2. جدول الأفعال والأنشطة والامتدادات المعيارية (Verbs & Activities)
  3. الاشتراطات الفنية والقواعد الإلزامية للاعتماد
  4. قاموس مطابقة Blackboard Ultra مع xAPI
  5. أمثلة الإفادات (xAPI Statement Samples)
  6. طلب خدمة التنصيب والربط المباشر من Bzzix

1. نظرة عامة

يتضمن التوافق مع المركز الوطني للتعليم الإلكتروني (NELC) إرسال إفادات تعلّم سياقية (Semantic Triples: Subject – Predicate – Object) عبر واجهة xAPI REST API إلى نظام FutureX LRS.

يجب أن توثق كل حركة تعلّم (تسجيل، مشاهدة، اختبار، إكمال، حصول على شهادة) بشكل دقيق وموحد.

2. جدول الأفعال والأنشطة والامتدادات (Concepts, Verbs & Activities)

📌 الأفعال الرسمية (Verbs)

اسم الفعل (Concept) الوصف بالعربية نوع الكيان الرمز الموحد (IRI)
registered تم تسجيل المتعلم رسمياً في المقرر أو البرنامج Verb http://adlnet.gov/expapi/verbs/registered
initialized بدأ المتعلم نشاطاً تعليمياً بنجاح Verb http://adlnet.gov/expapi/verbs/initialized
watched شاهد المتعلم مقطع فيديو أو محتوى تفاعلي Verb https://w3id.org/xapi/acrossx/verbs/watched
completed أتم المتعلم النشاط أو المقرر بشكل مكتمل Verb http://adlnet.gov/expapi/verbs/completed
attended حضر المتعلم جلسة تزامن رقمية أو افتراضية Verb http://adlnet.gov/expapi/verbs/attended
progressed تقدم المتعلم بنسبة معينة في المحتوى Verb http://adlnet.gov/expapi/verbs/progressed
rated قَيَّم المتعلم محتوى أو دورة تدريبية Verb http://id.tincanapi.com/verb/rated
earned حصل المتعلم على شهادة أو وسام Verb http://id.tincanapi.com/verb/earned
attempted حاول المتعلم أداء اختبار أو تمرين Verb http://adlnet.gov/expapi/verbs/attempted

📌 أنواع الأنشطة (Activity Types)

النشاط الوصف IRI
course دورة تدريبية كاملة https://w3id.org/xapi/cmi5/activitytype/course
module وحدة تعليمية فرعية داخل الدورة http://adlnet.gov/expapi/activities/module
lesson درس تعليمي http://adlnet.gov/expapi/activities/lesson
video مقطع فيديو تعليمي https://w3id.org/xapi/video/activity-type/video
assessment تقييم أو اختبار شامل https://w3id.org/xapi/tla/activity-types/assessment
virtual classroom قاعة افتراضية / بث مباشر https://w3id.org/xapi/virtual-classroom/activity-types/virtual-classroom
certificate شهادة إكمال معتمدة https://www.opigno.org/en/tincan_registry/activity_type/certificate

📌 الامتدادات والتوسيعات المعتمدة (Extensions)

امتداد NELC / TinCan الاستخدام والوصف الرمز الموحد (IRI)
LMS URL رابط منصة التعليم الإلكترونية https://nelc.gov.sa/extensions/lms_url
Program URL رابط الدورة أو البرنامج التدريبي https://nelc.gov.sa/extensions/program_url
JWS Certificate Location رابط الشهادة الموثقة رقمياً http://id.tincanapi.com/extension/jws-certificate-location
Attempt ID معرف المحاولة في الاختبار http://id.tincanapi.com/extension/attempt-id
Browser Information معلومات متصفح المتعلم http://id.tincanapi.com/extension/browser-info

3. الاشتراطات الفنية والقواعد الإلزامية للاعتماد لدى NELC

[!IMPORTANT] يجب الالتزام التام بالتعليمات التالية لضمان قبول الربط واجتياز فحص الاعتماد التقني:

  1. المصادقة الخلفية (Backend Authentication Only): يجب أن تتم عملية المصادقة وإرسال الـ xAPI Statements من خلال السيرفر الخفي (Backend Server) حصراً. لا يُقبل إرسال الإفادات من متصفح العميل (Frontend JS).

  2. معرف المتعلم (Learner Unique ID): حقل actor.name يجب أن يحمل الهوية الوطنية أو رقم الإقامة للمتعلم بدقة (أو المعرف الوطني المعتمد).

  3. الوصف النظيف (No HTML in Course Description): وصف الدورة في إفادة التسجيل registered يجب أن يكون نصاً خندثاً نظيفاً خالياً تماماً من وسوم HTML.

  4. تنسيق المدة الزمنية (ISO 8601 Duration): حقل result.duration يجب أن يستخدم صيغة ISO 8601 الدولية، مثال: PT1H22M17S (ساعة و22 دقيقة و17 ثانية).

  5. تنسيق الوقت والرموز (Timestamp & ISO 639-1):

    • صيغة الوقت: 2026-07-30T07:18:32.829Z.
    • ترميز اللغة: استخدام ترميز ISO 639-1، مثل ar-SA للغة العربية و en-US للإنجليزية.

  6. صيغة معرف المنصة (Platform ID Format): تنسيق الرمز يكون حسب رمز المزود المعتمد، مثال: PROV-NUM (مثل GELS-001).

  7. شرط إكمال مشاهدة الفيديو: يُعتبر الفيديو مكتمل المشاهدة (watched) عندما يستجوب المتعلم 90% أو أكثر من طول الفيديو.

4. قاموس مطابقة Blackboard Ultra مع xAPI

يوفر هذا الجزء خريطة الربط الشاملة لنظام Blackboard Ultra لاستخراج البيانات وتحويلها لإفادات xAPI معتمدة:

4.1 الهيكل التنظيمي والمؤسسي (Institutional Metadata)

كيان Blackboard Ultra مصدر البيانات (API) نوع الكيان في xAPI الكيانات المستخرجة
الجامعة / المؤسسة Institutional Hierarchy Group org_id, name, code
الكلية / الفاكولتي Institutional Hierarchy Group college_id, name
القسم الأكاديمي Institutional Hierarchy Group dept_id, name
الفصل الدراسي (Term) Term API Activity term_id, title, start_date, end_date

4.2 المقررات والشعب (Courses & Sections)

  • object.type = "Activity"
  • object.definition.type = "https://w3id.org/xapi/cmi5/activitytype/course"
  • context.contextActivities.grouping = University → College → Department → Program → Term → Course

5. نموذج إفادة xAPI معتمدة (Sample Statement)

{
  "actor": {
    "objectType": "Agent",
    "name": "1098765432",
    "account": {
      "homePage": "https://academy.bzzix.com",
      "name": "1098765432"
    }
  },
  "verb": {
    "id": "http://adlnet.gov/expapi/verbs/completed",
    "display": {
      "ar-SA": "أكمل",
      "en-US": "completed"
    }
  },
  "object": {
    "id": "https://academy.bzzix.com/courses/CYBER-101",
    "definition": {
      "name": {
        "ar-SA": "أساسيات الأمن السيبراني",
        "en-US": "Cybersecurity Fundamentals"
      },
      "description": {
        "ar-SA": "دورة تدريبية شاملة تغطي مفاهيم الحماية والأمن الرقمي"
      },
      "type": "https://w3id.org/xapi/cmi5/activitytype/course"
    }
  },
  "result": {
    "completion": true,
    "success": true,
    "duration": "PT2H15M00S",
    "score": {
      "scaled": 0.95,
      "raw": 95,
      "min": 0,
      "max": 100
    }
  },
  "context": {
    "platform": "GELS-001",
    "extensions": {
      "https://nelc.gov.sa/extensions/lms_url": "https://academy.bzzix.com",
      "http://id.tincanapi.com/extension/jws-certificate-location": "https://academy.bzzix.com/certificates/verify/CERT-998822"
    }
  },
  "timestamp": "2026-07-30T03:00:00.000Z"
}

6. طلب خدمة التنصيب والربط المباشر من Bzzix

فريق Bzzix يقدم خدمة تنفيذ وتأهيل الربط الفوري لنظام FutureX / NELC لكافة المنصات (Blackboard Ultra, Moodle, WordPress LearnDash, و Laravel الأكاديمي).

هل تحتاج مساعدة في تنفيذ ما في الدليل؟ فريق Bzzix متاح لخدمتك.
تواصل معنا الآن