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