فهم نظرة عامة على إعدادات التكاملات

الملخص

تُعد صفحة Integrations منطقة الإدارة المركزية التي تتحكم فيها بكل اتصال بين KnowledgeCity والأنظمة الخارجية. وهي تُجمّع الإعدادات المرتبطة (Content Providers، وIntegration Platforms، وLTI Tools، وAPI Tokens، وWeb Hooks، وLogs) بحيث يمكنك إضافة التكاملات وتفعيلها وإلغاء تفعيلها وإزالتها من مكان واحد. يوضح هذا المقال الغرض من كل تجميع وكيفية التعامل معه.

مقدمة

تتصل KnowledgeCity بأنظمة خارجية عديدة بحيث يمكن للمستخدمين والدورات والشهادات والتقارير أن تتدفق تلقائيًا بين المنصات. تجمع صفحة Integrations كل هذه الاتصالات في مركز إداري واحد، مما يعطيك رؤية واضحة لما هو مُهيّأ، وما هو نشط، وأين يمكنك إجراء التغييرات.

يستخدم هذه الصفحة المسؤولون العليا (Super Admins) والمسؤولون المسؤولون عن ربط KnowledgeCity بأدوات الجهات الخارجية. وهي تحل مشكلة تشتت التهيئة عبر تجميع كل نوع من أنواع التكامل في مكان واحد، بحيث لا تحتاج إلى البحث في شاشات منفصلة لإضافة مصدر محتوى، أو تسجيل أداة خارجية، أو إصدار بيانات اعتماد API، أو التحقق من أن الاتصال يعمل.

المفاهيم الأساسية

• Content Providers: اتصالات بكتالوجات خارجية ومصادر دورات يمكن عرض محتواها داخل KnowledgeCity.
• Integration Platforms: اتصالات بأنظمة خارجية أوسع (مثل أنظمة الموارد البشرية ومنصات التعلّم الأخرى) تتبادل المستخدمين والتسجيلات والنتائج مع KnowledgeCity.
• LTI Tools: اتصالات تفاعلية لأدوات التعلّم (Learning Tools Interoperability) مُسجّلة، تُحدد كل منها بمنصة ومُعرّف عميل (client ID)، وتسمح لـ KnowledgeCity والمنصات الخارجية بالانتقال إلى بعضها البعض.
• API Tokens: بيانات اعتماد OAuth (مُعرّف عميل وسر عميل) تسمح للتطبيقات الخارجية والتكاملات المخصصة بالوصول إلى بياناتك من خلال واجهة API الخاصة بـ KnowledgeCity.
• Web Hooks: إشعارات صادرة تسمح لـ KnowledgeCity بإخبار الأنظمة الخارجية عند حدوث أحداث ذات صلة.
• Logs: سجل لنشاط التكامل يمكنك مراجعته للتأكد من ما حدث واستكشاف السلوك غير المتوقع.
• حالة التكامل (Integration status): يعكس كل تكامل ما إذا كان مُهيّأً ونشطًا، بحيث يمكنك تفعيله أو إلغاء تفعيله أو إزالته عند الحاجة.

الخطوات المطلوبة

فتح صفحة Integrations

سجّل الدخول كمسؤول علوي (Super Admin)، وافتح قائمة Settings في اللوحة العلوية لواجهة LMS، ثم اختر Integrations. يفتح هذا صفحة تفاصيل Integrations، حيث تُنظّم تجميعات التكامل المختلفة في أقسامها الخاصة.

اختيار تجميع تكامل

في صفحة Integrations، اختر القسم الذي يطابق ما تريد إدارته: Content Providers، أو Integration Platforms، أو LTI Tools، أو API Tokens، أو Web Hooks، أو Logs. يحتفظ كل تجميع بإعداداته الخاصة وقائمته الخاصة بالعناصر المُهيّأة بحيث يمكنك التركيز على نوع تكامل واحد في كل مرة.

إضافة تكامل وتفعيله

داخل أحد التجميعات، أضف التكامل الذي تحتاجه وقدّم تفاصيل اتصاله، ثم احفظ. بعد تهيئته، يمكن تفعيل التكامل ليصبح نشطًا ويبدأ بتبادل البيانات مع النظام الخارجي. تأكد من بيانات الاعتماد وأي معرّفات مطلوبة (مثل معرّف منصة أو معرّف عميل) مع الطرف المُتكامِل قبل الاعتماد على الاتصال.

التعامل مع API Tokens

افتح قسم API Tokens لإصدار بيانات اعتماد OAuth للتطبيقات الخارجية. أنشئ رمزًا (token)، وأعطه اسمًا وصفيًا بحيث يكون الغرض منه واضحًا لاحقًا، وأكّد بيان التفويض. بعد الإنشاء، انسخ مُعرّف العميل (client ID) وسر العميل (client secret) إلى أداتك الخارجية. عامل سر العميل كما تعامل كلمة مرور ولا تُشاركه علنًا مطلقًا.

التعامل مع LTI Tools

افتح قسم LTI Tools لتسجيل وإدارة اتصالات Learning Tools Interoperability. تُربط كل أداة مُسجّلة بمنصة ومُعرّف عميل ولها حالتها الخاصة. سجّل الأدوات التي يحتاجها الحساب وتحقق من عملية الانتقال (launch) قبل الاعتماد عليها في بيئة الإنتاج.

إلغاء تفعيل تكامل أو إزالته

عندما لا تعود تحتاج إلى اتصال ما، ألغِ تفعيله لإيقاف تبادل البيانات، أو أزله بالكامل. إزالة بيانات اعتماد مثل رمز API تحجب الوصول فورًا عن أي تطبيق خارجي يستخدمها، فتأكد قبل إزالة أي شيء تعتمد عليه أنظمة أخرى.

مراجعة السجلات

افتح قسم Logs لمراجعة نشاط التكامل. استخدمه للتأكد من أن اتصالًا ما عمل كما هو متوقع، ولرؤية ما تغيّر، ولاستكشاف المشكلة عندما لا تسلك مزامنة أو عملية انتقال السلوك المطلوب.

الخاتمة

تُعد نظرة عامة على إعدادات التكاملات مركزك الوحيد لربط KnowledgeCity بالعالم الخارجي. من خلال تجميع Content Providers، وIntegration Platforms، وLTI Tools، وAPI Tokens، وWeb Hooks، وLogs في صفحة واحدة، تتيح لك إضافة التكاملات وتفعيلها وإلغاء تفعيلها وإزالتها مع رؤية واضحة لحالة كل اتصال، والاعتماد على السجلات للحفاظ على إمكانية تتبع كل تغيير.