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 תעודכן בכל הוספה, עדכון או מחיקה שבוצעו (אם יש שינויים תכופים בשדות המותאמים, כדאי לבצע עדכון יומי). כאשר עובדים כך: 

• תשובות חדשות יהיו זמינות לבחירה על ידי הנוסעים מידית בעת ביצוע ההזמנה. 

• תשובות שהוסרו כבר לא יוצגו כאפשרות לנוסעים. 

תשובות שהוסרו עדיין יופיעו בדוחות.

מבנה קובץ לשדה מותאם אישית

היעזרו במידע הבא כדי לוודא שהנתונים שאתם מעלים לשדה המותאם האישית שלכם תקינים ומוכנים להעלאה.