فهم تصدير البيانات: الدورات وإتمام الدورات والمستخدمون

الملخص

يرسل تصدير البيانات (Data Export) في Integrations سجلات كتالوج KnowledgeCity وسجلات الإتمام وسجلات المستخدمين إلى نظام خارجي وفق جدول زمني. تحدد أنت محتوى كل ملف، والمكان الذي يصل إليه في وجهة FTP الخاصة بك، وعدد مرات تشغيله. بعد التكوين، تُنشأ عمليات التصدير وتُنقل تلقائيًا دون معالجة ملفات يدوية.

مقدمة

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

يُعِدّ هذه الإمكانية عادةً المسؤولون الذين يحافظون على مواءمة نظام خارجي، مثل منصة موارد بشرية أو مستودع بيانات (data warehouse)، مع KnowledgeCity. تحل محل العمل اليدوي المتمثل في تشغيل التقارير، وإعادة تنسيق الملفات، وتحميلها يدويًا، بعملية نقل متكررة ومجدولة.

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

• إعداد التصدير (Export Setup): القسم الأصل الذي يجمع تعريفات التصدير الفردية. يحتوي على مفتاح تفعيل (Turn On) خاص به، ويخضع أيضًا لمفتاح التفعيل (Turn On) الرئيسي على المستوى الأعلى. إذا كان المفتاح الرئيسي معطلاً، يتم تجاهل جميع إعدادات التصدير بصرف النظر عن حالتها الفردية.
• تصدير إتمام الدورة (Export Course Completion): التصدير الذي يكتب سجلات إتمام دورات KnowledgeCity إلى ملف صادر، بما في ذلك حقول مثل تاريخ البدء وتاريخ النجاح.
• تصدير الدورات (Export Courses): التصدير الذي يكتب كتالوج دورات KnowledgeCity إلى ملف صادر.
• تصدير المستخدمين (Export Users): التصدير الذي يكتب سجلات المستخدمين إلى ملف صادر، باتباع نفس نموذج نمط اسم الملف، وحقول CSV، والوجهة، والجدول الزمني المستخدَم في عمليات التصدير الأخرى.
• حقول CSV (CSV Fields): القائمة القابلة للتكوين التي تحدد عناوين الأعمدة وترتيبها في الملف المُنشأ، مما يمنحك التحكم في تنسيق الناتج.
• نمط اسم الملف (File name pattern): القالب المستخدَم في اسم الملف المُنشأ، والذي يمكن أن يحتوي على رمز تاريخ (date token) حتى يُدرَج تاريخ التصدير تلقائيًا.
• وجهة FTP (FTP Destination): الاتصال والموقع المستهدف الذي يُنقل إليه الملف المُنشأ.
• إعداد الجدول الزمني (Schedule Setup): تكوين التكرار الذي يتحكم في عدد مرات تشغيل كل تصدير، مثل يوميًا أو أسبوعيًا.

الخطوات التي يجب اتباعها

تفعيل التكامل وإعداد التصدير

تبدأ من صفحة Integrations كمسؤول. تأكد من تفعيل مفتاح التفعيل (Turn On) على المستوى الأعلى، لأنه يعمل كمفتاح رئيسي: عندما يكون معطلاً، يتم تجاهل جميع الإعدادات الفرعية، بما في ذلك جميع عمليات التصدير. ثم وسّع إعداد التصدير (Export Setup) وفعّل مفتاحه التفعيل (Turn On) لتفعيل قسم التصدير بالكامل.

تكوين إعدادات KnowledgeCity API

ضمن قسم KnowledgeCity API، قدّم تفاصيل الاتصال التي يحتاجها التصدير لقراءة بياناتك. أدخل عنوان Base API URL، الذي يتضمن الإصدار، وAPI Secret الخاص بمستخدم التكامل المخصص. احفظ تغييراتك قبل الاستمرار.

تكوين تصدير إتمام الدورة

وسّع تصدير إتمام الدورة (Export Course Completion) وفعّل التفعيل (Turn On). اضبط نمط اسم الملف للتصدير، باستخدام رمز تاريخ حتى يُدرَج تاريخ التصدير في الاسم تلقائيًا. اضبط تنسيق التاريخ (date format) للتصدير لحقلَي تاريخ البدء وتاريخ النجاح؛ اتركه فارغًا لتصدير هذه القيم كطابع زمني بصيغة Unix. ضمن حقول CSV، حدد عناوين الأعمدة وترتيبها حتى يتطابق ملف الناتج مع ما يتوقعه النظام المستقبل.

تكوين تصدير الدورات

ضمن إعداد التصدير (Export Setup)، وسّع تصدير الدورات (Export Courses) وفعّل التفعيل (Turn On). اضبط نمط اسم الملف لملف الكتالوج المُنشأ، ثم حدد حقول CSV لتحديد عناوين الأعمدة وترتيبها في الناتج.

تكوين تصدير المستخدمين

فعّل تعريف تصدير المستخدمين (Export Users) لكتابة سجلات المستخدمين إلى ملف صادر. كما هو الحال مع عمليات التصدير الأخرى، اضبط نمط اسم الملف وحدد حقول CSV للتحكم في الأعمدة وترتيبها في الملف المُنشأ.

تعيين وجهة FTP

لكل عملية تصدير، افتح القسم الفرعي وجهة FTP (FTP Destination) وفعّل التفعيل (Turn On). أدخل تفاصيل اتصالك: المضيف (host)، والمنفذ (port)، واسم المستخدم (username)، والمفتاح الخاص المشفَّر بصيغة base64. اضبط المسار المستهدف (Target path)، الذي يمكن أن يكون نسبيًا أو مطلقًا، لإخبار النظام بالمكان الذي يجب نقل الملف المُنشأ إليه.

تعيين الجدول الزمني

ضمن إعداد الجدول الزمني (Schedule Setup) لكل عملية تصدير، فعّل التفعيل (Turn On) وقم بتكوين التكرار، مثل يوميًا أو أسبوعيًا. يحدد هذا عدد مرات إنشاء الملف وتسليمه إلى وجهة FTP.

التحقق من التصدير

بعد تكوين المفتاح الرئيسي، وإعداد التصدير، وكل عملية تصدير فردية، اترك الجدول الزمني يعمل وتحقق من التسليم. تحقق من وصول الملف إلى المسار المستهدف المتوقع في وجهة FTP الخاصة بك، وأن اسم الملف يعكس النمط الذي حددته، وأن الأعمدة تتطابق مع حقول CSV التي حددتها. راجع عددًا قليلاً من السجلات عينيًا قبل اعتبار التصدير مكتملاً.

الخاتمة

يحوّل تصدير البيانات في Integrations الدورات وإتمام الدورات وسجلات المستخدمين إلى ملفات صادرة مجدولة تُسلَّم إلى وجهة FTP الخاصة بك. من خلال تحديد حقول CSV، ونمط اسم الملف، والوجهة، والتكرار لكل عملية تصدير، والحفاظ على تفعيل المفتاح الرئيسي، تحافظ على مواءمة نظام خارجي مع KnowledgeCity دون إعداد تقارير يدوية.