الملخص
تعرّف على كيفية عمل التكامل والمعلومات التي يجب تقديمها ليتمكن فريقنا من تهيئة المزامنة التلقائية لبيانات الموظفين من ADP إلى نظام KnowledgeCity LMS الخاص بك.
مقدمة
يشرح هذا الدليل عملية التكامل ويقدّم تعليمات خطوة بخطوة حول كيفية إيجاد المعلومات المطلوبة ومشاركتها لتهيئة تكامل ADP. بمجرد الإعداد، سيستخدم التكامل نموذج "سحب" (Pull) حيث تسترجع KnowledgeCity البيانات بأمان من ADP. سيقوم التكامل تلقائيًا بما يلي:
- سحب الموظفين "النشطين" من واجهة برمجة تطبيقات إدارة العاملين في ADP (ADP Worker Management API) أثناء المزامنة الجماعية (قابل للتهيئة).
- إلغاء تنشيط المستخدمين في KnowledgeCity عند إنهاء خدمة موظف في ADP خلال دورة المزامنة التالية.
- ربط
homeOrganizationalUnits(الأقسام) من ADP بـ"المجموعات" في نظام KnowledgeCity LMS، مما يضمن وضع المستخدمين تلقائيًا في المجموعة الصحيحة لتعيينات التدريب المستهدفة.
يضمن ذلك بقاء منصة التدريب الخاصة بك متوافقة تمامًا مع بيانات الموارد البشرية لديك، مما يلغي الحاجة إلى التحديثات اليدوية ويحافظ على اتساق سجلات التعلم.
الخطوات المتبعة
الخطوة 1: منح صلاحيات API
للسماح لـ KnowledgeCity بسحب بيانات المستخدمين والمجموعات، يجب إعداد ما يلي في بوابة ADP:
- شراء/تفعيل ADP API Central: هذا مطلوب للتكاملات المخصصة (غير الموجودة في Marketplace) لإنشاء بيانات اعتماد API.
- نطاقات API (API Scopes): امنح الأذونات التالية لتطبيق المستهلك الخاص بـ KnowledgeCity:
| # | المعرّف | الحالة | نطاق API |
|---|---|---|---|
| 102 | 0039dd22-e684-4ea9-a0d3-75f080e82fef | complete | hr/workerInformationManagement/workerManagement/workerProfileManagement/worker.read (لبيانات المستخدم) |
| 103 | 5f0e7fcf-8b0a-4fce-88f7-b34834b99d23 | complete | core/organizationManagement/organizationInformationManagement/organizationDepartmentManagement/organizationDepartment.read (لبيانات المجموعة/القسم) |
الخطوة 2: تفعيل الوصول إلى API في ADP
- سجّل الدخول إلى ADP Workforce Now
- انتقل إلى: Setup > External Integrations > API Central
- أنشئ مشروعًا جديدًا باسم "KC Integration"
- اختر حالة الاستخدام "Employee Sync" لإضافة واجهات برمجة تطبيقات العاملين المطلوبة (Worker APIs) تلقائيًا.
الخطوة 3: مشاركة بيانات الاعتماد بأمان
- أنشئ Client ID وClient Secret الخاصين بك في ADP API Central
- شارك بيانات الاعتماد هذه مع فريق KnowledgeCity باستخدام رابط آمن
- أدرج تكرار المزامنة المفضل لديك (يوميًا أو أسبوعيًا)
الخطوة 4: الاختبار والانتقال إلى مرحلة التشغيل الفعلي
- اختبار البيئة التجريبية (Sandbox): سيتصل فريق KnowledgeCity أولاً ببيئة ADP التجريبية الخاصة بك للتحقق من مطابقة البيانات.
- التحقق من اختبار قبول المستخدم (UAT): ستقوم بإجراء اختبار قبول المستخدم ومراجعة نتائج الاختبار للتأكد من ظهور بيانات الموظفين بشكل صحيح.
- الإطلاق في بيئة الإنتاج: بمجرد التأكيد، سننتقل إلى بيئة ADP الفعلية الخاصة بك.
للانتقال من "الحالة المُدارة (Managed Status)" إلى "التشغيل الفعلي (Live)"، يجب على العميل تقديم المعلمات التالية من بوابة ADP الخاصة به إلى فريق KnowledgeCity:
| # | المكوّن | ما يجب تقديمه | أين يمكن إيجاده |
|---|---|---|---|
| 1 | بيانات اعتماد API | Client ID و Client Secret وعنوان API URL | تم إنشاؤها في ADP API Central |
| 2 | جدول المزامنة | التكرار المفضل: يوميًا أو أسبوعيًا | تفضيلك لتحديثات البيانات |
ملاحظة: نظرًا لأن هذا التكامل يعالج بيانات حساسة تتعلق بالموارد البشرية والرواتب، سيقوم فريق KnowledgeCity بإجراء المصافحة (handshake) الأولية في بيئة تجريبية للتحقق من أن الحقول المخصصة في ADP لديك مطابقة بشكل صحيح لنظام إدارة التعلم قبل نقل التكامل إلى بيئة فعلية.
مراحل التنفيذ والمسؤوليات
| المرحلة | المهمة | المسؤولية |
|---|---|---|
| المرحلة 1: إعداد المشروع | إنشاء مشروع التكامل في ADP API Central | العميل |
| المرحلة 2: تحديد النطاق | تحديد المتطلبات ومشاركة بيانات اعتماد API وتفضيلات المزامنة بأمان مع فريق KC | العميل |
| المرحلة 3: الاتصال بالبيئة التجريبية | تهيئة التكامل والتحقق منه في بيئة تجريبية | فريق KnowledgeCity |
| المرحلة 4: اختبار قبول المستخدم | إجراء ومراجعة نتائج الاختبار للتحقق من دقة البيانات | العميل |
| المرحلة 5: الإطلاق في بيئة الإنتاج | تفعيل الاتصال الفعلي لبدء التشغيل في بيئة الإنتاج | فريق KnowledgeCity |
الخاتمة
بمجرد أن يصبح التكامل فعّالاً، ستبقى منصة KnowledgeCity الخاصة بك متزامنة تلقائيًا مع ADP وفقًا للجدول الزمني المحدد. سيظهر الموظفون النشطون كمتعلمين، وسيتم إلغاء تنشيط المستخدمين الذين انتهت خدمتهم، وستصبح الأقسام التنظيمية مجموعات تدريبية. يضمن ذلك أن قائمة المستخدمين وتعيينات التدريب لديك دقيقة ومحدَّثة دائمًا، بما يعكس نظام الموارد البشرية لديك مباشرة.