SFTP - إرشادات الحقول المخصصة

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

• SFTP - إرشادات الحقول المخصصة
  • آلية معالجة ملفات ردود الحقول المخصصة
  • تنسيق الملفات وقواعد تسمية الملفات
  • التكرار وجدولة التحميلات
  • تنسيق ملف الحقول المخصصة

ستجد في هذا الموضوع معلومات مهمة تساعدك على رفع ملفاتك بنجاح.

للاطلاع على إرشادات ومعلومات عامة حول SFTP، يرجى مراجعة SFTP - تعليمات الإعداد.

آلية معالجة ملفات ردود الحقول المخصصة

تتيح لك Spotnana تحميل بيانات ردود الحقول المخصصة بشكل كامل أو جزئي في كل مرة ترفع فيها الملف. اسم الملف يوضح اسم الحقل المخصص وقائمة الردود التي يتم رفعها. يجب إرسال كل حقل مخصص مع ردوده في ملف منفصل (للتعرف على تفاصيل قواعد التسمية، راجع ما يلي). تتم معالجة محتوى ملف CSV الخاص بك وفقاً للآلية التالية:

• إذا كانت قيمة عمود ACTION في الصف هي CREATE، سيتم إنشاء خيار الرد في قائمة الردود.

• إذا كانت قيمة عمود ACTION في الصف هي UPDATE وكان خيار الرد موجوداً مسبقاً، سيتم تحديث وصف هذا الرد.

إذا كانت قيمة عمود ACTION في الصف هي DELETE ، سيتم حذف خيار الرد. وإذا لم يكن هناك سجل مطابق لهذا الخيار في قاعدة بيانات Spotnana، سيتم تجاهل الصف ولن يتم اتخاذ أي إجراء.

تنسيق الملفات وقواعد تسمية الملفات

يجب أن يتبع اسم كل ملف تغذية للحقول المخصصة بصيغة .CSV هذا النمط:

CUSTOM_FIELD_V3_OPTIONS.[customFieldID].[optionGroupID].*.csv

حيث أن:

• [customFieldID] هو متغير يختلف حسب كل حقل. يمكنك العثور على هذا المعرف ضمن اسم الملف الظاهر في الخطوة 2 ضمن تعليمات استيراد SFTP في مربع الحوار الخاص بإرشادات الاستيراد من دليل SFTP. 

• [optionGroupID] هو متغير يختلف حسب كل قائمة ردود. يمكنك العثور على هذا المعرف ضمن اسم الملف الظاهر في الخطوة 2 ضمن تعليمات استيراد SFTP في مربع الحوار الخاص بإرشادات الاستيراد من دليل SFTP.  

• أما الرمز * (الوايلد كارد) فيمكنك استخدامه لإضافة أي أحرف إضافية لاسم الملف حسب رغبتك. 

• يجب أن يكون هناك نقطة “.” بعد [optionGroupID] ونقطة أخرى قبل “csv”. 

اسم الملف غير حساس لحالة الأحرف. ننصحك بإضافة التاريخ والوقت إلى اسم الملف (لتسهيل تتبع المشاكل مستقبلاً). كمثال:

CUSTOM_FIELD_V3_OPTIONS.[customFieldID].[optionGroupID].spotnana_integration_<DateTime>.csv

يجب أن يكون ملف التغذية بصيغة .CSV أيضاً بتنسيق محدد. يجب أن تتطابق أسماء الأعمدة تماماً مع التنسيق المعتمد (انظر قسم تنسيق الحقول المخصصة أدناه). 

التكرار وجدولة التحميلات

ننصحك برفع ملف يومياً حتى تضمن إعلام Spotnana بأي إضافات أو تعديلات أو حذف قد يتم (إذا كانت الحقول المخصصة لديك تتغير باستمرار، فإن التحديث اليومي هو الأنسب). إذا التزمت بذلك: 

• ستتوفر الردود الجديدة للمسافرين فوراً عند إتمام الحجز. 

• سيتم حذف الردود المتوقفة ولن تظهر كخيارات متاحة للمسافرين. 

ستظل الردود المتوقفة ظاهرة في التقارير.

تنسيق ملف الحقول المخصصة

استخدم هذه المعلومات لمساعدتك في التأكد من أن بيانات الحقول المخصصة التي ترفعها معدّة ومهيأة بشكل صحيح.