كيفية إعداد الاستيراد والتصدير المجدوَل عبر SFTP

الملخص

تحدد إعدادات التكامل الافتراضي (Default Integration) اتصال SFTP مشتركًا واحدًا وجدولًا زمنيًا واحدًا تستخدمه كل مهمة استيراد وتصدير تلقائية. تُكوّن اتصال SFTP مرة واحدة، وتحدد أوقات تشغيل المهام، ثم تنقل المنصة الملفات من وإلى خادمك دون خطوات يدوية. يمنحك ذلك مكانًا واحدًا ومتسقًا للتحكم في تبادل الملفات التلقائي.

مقدمة

يُعد التكامل الافتراضي (Default Integration) جزءًا من منتج Integrations في KnowledgeCity. يحتوي على تفاصيل الاتصال بخادم SFTP الخاص بك إلى جانب جدول زمني قابل لإعادة الاستخدام، حتى تشترك مهام الاستيراد (الملفات التي تقرأها المنصة) ومهام التصدير (الملفات التي ترسلها المنصة) جميعها في نفس قواعد النقل والتوقيت.

يُعِدّ هذا التكوين عادةً مسؤول عام (Super Admin) في KnowledgeCity، وغالبًا بالتعاون مع المسؤول الذي يدير خادم SFTP الخاص بك ويمكنه تقديم المضيف (host) وبيانات الاعتماد والمسارات الصحيحة. يحل هذا مشكلة تكوين نفس الاتصال مرارًا وتكرارًا: فبدلاً من تحديد تفاصيل نقل منفصلة لكل مهمة، تحددها مرة واحدة وتترك كل مهمة مجدولة تعيد استخدامها.

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

• التكامل الافتراضي (Default Integration): التكوين الرئيسي الذي يجب تفعيله قبل تشغيل أي مهمة استيراد أو تصدير فرعية. عندما يكون معطلاً، يتم تجاهل جميع المهام المجدولة.
• اتصال SFTP: الاتصال المشترك المحدَّد بواسطة المضيف (Host) والمنفذ (Port) واسم المستخدم (Username) ومفتاح خاص (private key)، والذي تستخدمه كل مهمة استيراد وتصدير. يتصل KnowledgeCity عبر SFTP (SSH)، لذا تعتمد المصادقة على مفتاح بدلاً من كلمة مرور.
• المسار (Path): الدليل على خادم SFTP الخاص بك الذي تقرأ منه المهام أو تكتب إليه. يمكن أن يكون نسبيًا أو مطلقًا، لذا تأكد من القيمة الصحيحة مع مسؤول خادمك.
• اسم الملف (File Name): نمط الاسم المستخدَم للملفات المنقولة. يمكن أن يحتوي على نمط تاريخ حتى تُنشئ كل عملية تشغيل ملفًا مؤرَّخًا.
• الجدول الزمني: قاعدة التوقيت القابلة لإعادة الاستخدام والمبنية من نوع الفاصل الزمني (interval type) وقيمة الفاصل الزمني (interval value)، اللذين يتحكمان معًا في عدد مرات تشغيل المهام.
• مهام الاستيراد والتصدير: المهام التلقائية التي تعيد استخدام اتصال SFTP والجدول الزمني المشتركين لتبادل الملفات مع خادمك.
• مسؤول عام (Super Admin): الدور المطلوب في KnowledgeCity لفتح إعدادات Integrations وتكوين اتصال SFTP الافتراضي والجدول الزمني.

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

فتح إعدادات SFTP الافتراضية

سجّل الدخول إلى KnowledgeCity كـ مسؤول عام (Super Admin) وافتح إعدادات Integrations. حدد موضع قسم التكامل الافتراضي (Default Integration)، الذي يحتوي على اتصال SFTP والجدول الزمني المشتركين الذين تستخدمهما جميع مهام الاستيراد والتصدير التلقائية.

تفعيل التكامل الافتراضي

فعّل المفتاح الرئيسي لـ التكامل الافتراضي (Default Integration). يجب تفعيل هذا المفتاح أولاً، لأنه يتم تجاهل كل مهمة استيراد وتصدير ما دام معطلاً. عند تفعيله، تصبح إعدادات الاتصال والجدول الزمني أدناه سارية المفعول.

تكوين اتصال SFTP

أدخل تفاصيل الاتصال بخادم SFTP الخاص بك:

• المضيف (Host): عنوان خادم SFTP الخاص بك.
• المنفذ (Port): المنفذ الذي يستمع الخادم عليه. يستخدم SFTP المنفذ 22 افتراضيًا، لذا تأكد من القيمة مع مسؤول خادمك إذا كانت مختلفة.
• اسم المستخدم (Username): اسم الحساب المستخدَم للمصادقة.
• مفتاح خاص (Private key): مفتاح SSH الخاص الذي يصرّح بالاتصال. الصق المفتاح الذي يوفره مسؤول خادمك. تعامل معه مثل كلمة المرور واحفظه بأمان، لأنه يصادق كل عملية نقل.

تعيين خيارات الملف

اختر مكان وضع الملفات:

• اضبط المسار (Path) على الدليل الموجود على الخادم الذي يجب أن تقرأ المهام منه أو تكتب إليه. يمكن أن يكون المسار نسبيًا أو مطلقًا، لذا تأكد من القيمة الصحيحة مع مسؤول خادمك.
• اضبط نمط اسم الملف (File Name) للملفات المنقولة. يمكنك تضمين رمز تاريخ حتى تُنشئ كل عملية تشغيل ملفًا مؤرَّخًا، على سبيل المثال ملف يحمل تاريخ التشغيل بصيغة Ymd.

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

استخدم الجدول الزمني للتحكم في وقت تشغيل المهام. اضبط نوع الفاصل الزمني (interval type) (عدد مرات تكرار المهمة، على سبيل المثال كل ساعة أو يوميًا أو أسبوعيًا) وقيمة الفاصل الزمني (interval value) التي تحدد التكرار ضمن ذلك النوع. بما أن هذا الجدول الزمني مشترك، فإن التوقيت الذي تحدده هنا يوجّه كل مهمة استيراد وتصدير تلقائية تعتمد على التكوين الافتراضي.

الحفظ والتحقق

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

الخاتمة

من خلال تكوين اتصال SFTP الافتراضي والجدول الزمني مرة واحدة، تمنح كل مهمة استيراد وتصدير تلقائية في Integrations اتصالًا وتوقيتًا واحدًا ومتسقًا. يمكنك العودة إلى إعدادات التكامل الافتراضي في أي وقت لتحديث بيانات الاعتماد، أو تعديل المسار أو اسم الملف، أو تغيير الجدول الزمني مع تطور احتياجات تبادل الملفات لديك.