الملخص
يتيح تكامل Oracle Learning لـ KnowledgeCity العمل بصفة مزوّد محتوى (Content Provider)، بينما يكون Oracle Learning (جزء من Oracle Fusion Cloud HCM) هو المنصة التي يطلق منها المتعلمون التدريب ويتتبعون نتائجهم.
يدعم ثلاث تدفقات أساسية:
- استيراد المستخدمين: استيراد المستخدمين من Oracle HCM إلى KnowledgeCity
- تصدير الدورات: تصدير الدورات المؤهلة من KnowledgeCity إلى Oracle Learning
- تصدير إكمال الدورات: تصدير سجلات إكمال الدورات من KnowledgeCity إلى Oracle Learning
يمكن لبعض عمليات المزامنة أن تعمل تلقائيًا باستخدام مُجدول زمني (استنادًا إلى المنطقة الزمنية المحلية لنظام إدارة التعلم).
مقدمة
الغرض من هذا التكامل هو تبسيط عمليات التعلم المؤسسية من خلال تمكين المسؤولين من:
- الحفاظ على توافق حسابات المستخدمين بين Oracle HCM و KnowledgeCity
- نشر دورات KnowledgeCity في Oracle Learning لإطلاق الدورات
- إرسال بيانات الإكمال مرة أخرى إلى Oracle Learning لإعداد تقارير مركزية والامتثال
يقلل هذا من الإدارة اليدوية للحسابات ويحافظ على اتساق سجلات التعلم عبر الأنظمة.
المتطلبات
قبل إعداد تكامل Oracle Learning، تأكد من استيفاء المتطلبات الأساسية التالية.
صلاحيات المسؤول
- يجب أن تمتلك صلاحية وصول مسؤول (Administrator) في نظام KnowledgeCity LMS لتفعيل التكاملات وتهيئتها.
الوصول إلى Oracle API
يجب عليك الحصول على تفاصيل API المطلوبة من مسؤول Oracle Fusion Cloud HCM لديك:
- عنوان REST API الأساسي لـ Oracle Fusion Cloud
- اسم مستخدم Oracle API
- كلمة مرور Oracle API
أدوار مستخدم Oracle API
يجب أن يمتلك مستخدم API في Oracle Fusion HCM الأدوار الوظيفية التالية:
- Learning Specialist (
ORA_WLF_LEARNING_SPECIALIST_JOB) – مطلوب لجميع العمليات المتعلقة بالتعلم - HCM Integration Specialist (
ORA_HRC_HUMAN_CAPITAL_MANAGEMENT_INTEGRATION_SPECIALIST_JOB) – مطلوب لتكاملات REST و HDL - Human Resource Specialist (
ORA_PER_HUMAN_RESOURCE_SPECIALIST_JOB) – مطلوب لعرض سجلات العاملين والتحقق منها - Application Implementation Consultant (
ASM_APPLICATION_IMPLEMENTATION_CONSULTANT_JOB) – مطلوب للتحقق من صحة التهيئة
مهم: أمان البيانات مطلوب لكل من استيراد المستخدمين وتصدير الإكمال. يحتوي Oracle HCM على طبقتي أمان منفصلتين: أمان الوظائف (Function Security) (الأدوار الوظيفية أعلاه) — يتحكم فيما إذا كان بإمكان المستخدم استدعاء API أمان البيانات (Data Security) (HCM Data Role + Person Security Profile) — يتحكم في سجلات العاملين التي يمكن للمستخدم قراءتها أو الكتابة إليها تعيين الأدوار الوظيفية مباشرة لمستخدم API غير كافٍ. يجب تضمين كل دور وظيفي مطلوب داخل دور بيانات HCM (HCM Data Role) مع ملف تعريف أمان أشخاص (Person Security Profile) مناسب (مثل "عرض جميع العاملين"). بدون ذلك: ترجع واجهة/publicWorkers(استيراد المستخدمين) 0 مستخدم بدون أي خطأ. ترجع طلبات POST إلىlearnerLearningRecords(تصدير الإكمال) استجابة HTTP 400 بمحتوى فارغ (null) — حيث يرفض Oracle الطلب بصمت لأن سياسات أمان البيانات في الدور الوظيفي المُعيَّن مباشرة لا يتم تفعيلها أبدًا.
الوصول إلى API الخاص بـ KnowledgeCity
- يجب أن يكون لديك مفتاح سري/رمز API صالح لـ KnowledgeCity تم إنشاؤه في نظام إدارة التعلم (أو تم تقديمه من قبل أحد مسؤولي KnowledgeCity).
الجدولة (اختياري)
- إذا كنت تخطط لاستخدام المزامنة المجدولة، تأكد من أن الجدول الزمني يتوافق مع وتيرة تحديث بياناتك الداخلية واحتياجات إعداد التقارير لديك.
الخطوات المتبعة
1) تفعيل تكامل Oracle Learning
- سجّل الدخول إلى نظام KnowledgeCity LMS بصفتك مسؤولًا.
- انتقل إلى صفحة التكاملات (Integrations).
- ابحث عن بطاقة تكامل Oracle Learning.
- انقر على تفعيل (Enable).
2) تهيئة الإعدادات العامة
عبّئ إعدادات الاتصال العامة باستخدام القيم التي يقدّمها مسؤول Oracle Fusion Cloud HCM لديك:
- عنوان REST API الأساسي لـ Oracle Fusion Cloud
- اسم مستخدم Oracle API
- كلمة مرور Oracle API
- المفتاح السري لـ API الخاص بـ KnowledgeCity
- عنوان API الخاص بـ KnowledgeCity
احفظ التغييرات.
الخيار 1: استيراد المستخدمين (Oracle HCM ← KnowledgeCity)
يحافظ هذا الخيار على مزامنة مستخدمي KnowledgeCity مع Oracle HCM. يُعامَل Oracle كمصدر الحقيقة لهوية المستخدم.
كيف يعمل
تستدعي KnowledgeCity واجهة /publicWorkers REST API الخاصة بـ Oracle لاسترجاع سجلات الموظفين، وتنشئ أو تحدّث حسابات المستخدمين في نظام إدارة التعلم وفقًا لذلك.
التهيئة
فعّل استيراد المستخدمين وقم بتهيئة الخيارات التالية:
- إضافة مستخدمين: إنشاء حسابات KnowledgeCity جديدة للمستخدمين الموجودين في Oracle HCM
- إعادة تنشيط المستخدمين: إعادة تنشيط المستخدمين في KnowledgeCity إذا أصبحوا نشطين مرة أخرى في Oracle HCM
- إلغاء تنشيط المستخدمين غير النشطين: إلغاء تنشيط المستخدمين في KnowledgeCity إذا كانوا غير نشطين في Oracle HCM
- إزالة الترخيص للمستخدمين غير النشطين: إزالة الترخيص اختياريًا عند إلغاء التنشيط
- حقل اسم المستخدم: اختيار حقل Oracle HCM الذي سيُستخدم كاسم مستخدم في KnowledgeCity
- بادئة اسم المستخدم: بادئة اختيارية لتجنب تضارب أسماء المستخدمين
- تعيين ترخيص تلقائيًا للمستخدمين الجدد + الاشتراك: يتحكم في تعيين الترخيص للمستخدمين المستوردين حديثًا
متطلبات مسبقة من مسؤول Oracle (مطلوبة)
بالإضافة إلى الأدوار الوظيفية المذكورة في قسم المتطلبات، يجب على مسؤول Oracle لديك:
- تعيين دور بيانات HCM (HCM Data Role) لمستخدم API يتضمن الدور الوظيفي HCM Integration Specialist ويشمل ملف تعريف أمان أشخاص (Person Security Profile) يغطي العاملين الذين ينبغي أن يكونوا مرئيين (مثل "جميع العاملين" أو وحدة الأعمال ذات الصلة)
- التأكد من أن التكامل يشير إلى البيئة الصحيحة (بيئة الإنتاج مقابل البيئة التجريبية)
- التأكد من وجود عاملين نشطين في HCM ضمن وحدات الأعمال التي يمكن الوصول إليها
بدون دور بيانات HCM وملف تعريف أمان الأشخاص، سيعمل استيراد المستخدمين دون أخطاء ولكنه سيُرجع 0 مستخدم.
النتيجة المتوقعة
- يتم إنشاء/تحديث/إلغاء تنشيط المستخدمين من Oracle HCM في KnowledgeCity وفقًا للقواعد التي قمت بتهيئتها
- سيعرض سجل مهمة المزامنة عدد المستخدمين الذين تم استرجاعهم والإجراءات المتخذة
الخيار 2: تصدير الدورات (KnowledgeCity ← Oracle Learning)
ينشر هذا الخيار دورات KnowledgeCity في فهرس Oracle Learning بحيث يمكن للمتعلمين اكتشافها وإطلاقها من Oracle.
كيف يعمل
تدفع KnowledgeCity البيانات الوصفية للدورة إلى Oracle Learning باستخدام واجهة Oracle's Self-Paced Learning Items REST API. يخزّن Oracle Learning البيانات الوصفية ورابط الإطلاق الخاص بـ KC — بينما يبقى المحتوى الفعلي مستضافًا على KnowledgeCity.
التهيئة
- فعّل تصدير الدورات
- تأكد من أن دوراتك تستوفي معايير الأهلية (انظر النتيجة المتوقعة أدناه)
النتيجة المتوقعة
تصبح الدورات متاحة في Oracle Learning استنادًا إلى قواعد الأهلية التالية:
- الدورة نشطة في KnowledgeCity
- الدورة ضمن فئة مرئية
- جميع الفئات الأصلية (parent categories) للدورة مرئية أيضًا
لن يتم تصدير الدورات غير المؤهلة (غير النشطة، ذات الفئات المخفية).
الخيار 3: تصدير إكمال الدورات (KnowledgeCity ← Oracle Learning)
يرسل هذا الخيار سجلات إكمال التعلم من KnowledgeCity مرة أخرى إلى Oracle Learning، مما يحافظ على تحديث كشف درجات المتعلم في Oracle.
كيف يعمل
بعد أن يكمل متعلم دورة في KnowledgeCity، يُرسل سجل إكمال إلى Oracle Learning عبر واجهة learnerLearningRecords REST API (طلب POST). يحدّث Oracle Learning كشف درجات المتعلم بحالة الإكمال والبيانات الوصفية.
التهيئة
- فعّل تصدير إكمال الدورة
متطلبات مسبقة من مسؤول Oracle (مطلوبة)
بالإضافة إلى الأدوار الوظيفية المذكورة في قسم المتطلبات، يجب على مسؤول Oracle لديك إتمام ما يلي — وهذا هو السبب الأكثر شيوعًا لفشل تصدير الإكمال:
- تضمين الدور الوظيفي Learning Specialist داخل دور بيانات HCM. لا يكفي تعيين
ORA_WLF_LEARNING_SPECIALIST_JOB(أو نسخة مخصصة مثلLBT_LEARNING_SPECIALIST_CUSTOM) مباشرة لمستخدم API — حيث لا يتم تفعيل سياسات أمان البيانات داخل الدور الوظيفي إلا من خلال دور بيانات (Data Role). - إرفاق ملف تعريف أمان أشخاص (Person Security Profile) بدور البيانات، مع صلاحية الوصول لجميع العاملين الذين يمكنهم إكمال التدريب (مثل "عرض جميع العاملين").
- التأكد من أن دور البيانات يمنح صلاحيات الكتابة/POST على
learnerLearningRecords، وليس فقط صلاحية القراءة. يجب أن يتضمن الدور: Use REST Service - Learner Learning Records(نسخة الكتابة — وليس النسخة_RO_للقراءة فقط)Manage Learning Assignment/Manage Learning Record- بعد إجراء تغييرات الأمان، شغّل العملية المجدولة "Retrieve Latest LDAP Changes" وانتظر حتى تكتمل قبل الاختبار.
أعراض غياب دور البيانات وصلاحيات الكتابة: تفشل مهام تصدير الإكمال مع استجابةHTTP 400 — Response: nullمن Oracle. المحتوى الفارغ (null) مقصود من جانب Oracle عندما يفتقر المستخدم إلى سياق أمان البيانات المطلوب. يصل الطلب إلى Oracle Fusion (يتم إرجاعx-oracle-dms-ecidصالح في رؤوس الاستجابة)، لكن لا تُدرج أي رسالة خطأ.
النتيجة المتوقعة
- تُرسل سجلات الإكمال إلى Oracle Learning بعد انتهاء المتعلم من الدورة
- يعكس كشف درجات Oracle Learning حالة الإكمال والبيانات الوصفية المحدَّثة استنادًا إلى تهيئتك
- يجب أن يمتلك مستخدم Oracle API الدور Learning Specialist لقبول سجلات الإكمال — معيَّنًا عبر دور بيانات HCM بصلاحيات كتابة، وليس مباشرة
استكشاف الأخطاء وإصلاحها
| المشكلة | السبب | الحل |
|---|---|---|
| فشل التكامل في الاتصال / رفض بيانات الاعتماد | خطأ في عنوان REST API الخاص بـ Oracle، أو اسم المستخدم، أو كلمة المرور، أو المفتاح السري لـ KC | أعد التحقق من جميع القيم مع مسؤول Oracle لديك وتأكد من أن المفتاح السري لـ KC نشط وصالح. |
| لا يتم استيراد المستخدمين | استيراد المستخدمين معطّل، أو عدم تطابق حقل اسم المستخدم | فعّل استيراد المستخدمين وتحقق من أن حقل اسم المستخدم المحدد يطابق ما هو موجود في Oracle HCM. |
| يعمل استيراد المستخدمين بنجاح ولكنه يُرجع 0 مستخدم: بدون خطأ | تم تعيين الأدوار الوظيفية ولكن لم يتم تهيئة دور بيانات HCM بملف تعريف أمان أشخاص. يُرجع Oracle استجابة فارغة عندما لا تُمنح رؤية البيانات — وهذا صامت ولا ينتج عنه خطأ. | اطلب من مسؤول Oracle لديك تعيين دور بيانات HCM لمستخدم API يتضمن ملف تعريف أمان أشخاص يمنح الرؤية للعاملين ذوي الصلة (مثل "جميع العاملين"). هذا منفصل عن الأدوار الوظيفية ويجب تهيئته بالإضافة إليها. |
| يتم استيراد المستخدمين ولكنهم لا يحصلون على تراخيص | تعيين الترخيص التلقائي معطّل أو الاشتراك غير مُهيَّأ | فعّل تعيين الترخيص التلقائي واختر اشتراكًا للمستخدمين الجدد. |
| لا يتم تحديث/إعادة تنشيط/إلغاء تنشيط المستخدمين كما هو متوقع | قواعد التحديث/إعادة التنشيط/إلغاء التنشيط غير مفعّلة | راجع وفعّل قواعد حالة المستخدم المحددة التي تريد تطبيقها أثناء المزامنة. |
| لا يتم تصدير الدورات إلى Oracle Learning | تصدير الدورات معطّل، أو الدورة غير نشطة، أو قواعد رؤية الفئة غير مستوفاة | فعّل تصدير الدورات، وتأكد من أن الدورات نشطة، وتحقق من رؤية الفئة (بما في ذلك الفئات الأصلية). |
يفشل تصدير الإكمال مع استجابة HTTP 400: Response: null من Oracle | تم تعيين الدور الوظيفي Learning Specialist مباشرة لمستخدم API، وليس عبر دور بيانات HCM. يمر أمان الوظائف بنجاح لكن سياسات أمان البيانات لا يتم تفعيلها أبدًا، لذا يرفض Oracle طلب POST بصمت. | اطلب من مسؤول Oracle لديك: (1) تضمين الدور الوظيفي Learning Specialist داخل دور بيانات HCM، (2) إرفاق ملف تعريف أمان أشخاص بصلاحية الوصول لجميع العاملين ("عرض جميع العاملين")، (3) التأكد من أن الدور يمنح صلاحيات الكتابة/POST على learnerLearningRecords (وليس القراءة فقط)، و(4) تشغيل العملية المجدولة "Retrieve Latest LDAP Changes" بعد إجراء التغيير. |
يفشل تصدير الإكمال مع استجابة HTTP 400: "You don't have the required security privileges..." | يمتلك مستخدم API دور Learning Specialist ولكنه يفتقر إلى صلاحيات الكتابة على learnerLearningRecords. | تأكد من أن دور Learning Specialist يتضمن Use REST Service - Learner Learning Records (نسخة الكتابة، وليس النسخة _RO_ للقراءة فقط) وصلاحيات Manage Learning Assignment / Manage Learning Record. |
| لا تظهر سجلات الإكمال في Oracle Learning | تصدير الإكمال معطّل، أو يفتقر مستخدم Oracle API إلى دور Learning Specialist المعيَّن عبر دور بيانات | فعّل تصدير الإكمال وتأكد من أن مستخدم Oracle API يمتلك دور Learning Specialist معيَّنًا عبر دور بيانات HCM بملف تعريف أمان أشخاص وصلاحيات كتابة — وليس كدور وظيفي مباشر. |
| لا تعمل المزامنة وفق الجدول الزمني | المُجدول معطّل أو مُهيَّأ في أوقات غير متوقعة | فعّل المُجدول وتحقق من صحة الجدول الزمني بتوقيت المنطقة الزمنية المحلية لنظام إدارة التعلم. |