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 ще бъде информирана за всички добавяния, промени или изтривания (ако персонализираните ви полета се променят често, ежедневните актуализации са най-подходящи). Ако следвате тази практика: 

• новите отговори ще са налични за избор от пътуващите веднага при резервация. 

• остарелите отговори ще бъдат премахнати като опция и вече няма да могат да се избират от пътуващите. 

Остарелите отговори ще продължат да се виждат в отчетите.

Формат на файл за персонализирани полета

Използвайте тази информация, за да сте сигурни, че данните във файла ви с персонализирани полета са правилно форматирани и подготвени.