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 завжди буде в курсі всіх доданих, змінених чи видалених відповідей (якщо ви часто оновлюєте користувацькі поля, щоденні оновлення будуть найзручнішими). Якщо дотримуватися цієї рекомендації: 

• нові відповіді одразу стануть доступними для вибору під час оформлення бронювання. 

• застарілі відповіді будуть видалені зі списку вибору і більше не відображатимуться для користувачів. 

Застарілі відповіді залишатимуться у звітах.

Формат файлу для користувацьких полів

Скористайтеся цією інформацією, щоб переконатися, що дані у вашому файлі для завантаження користувацьких полів підготовлені й відформатовані правильно.