SFTP — инструкция по работе с пользовательскими полями

СОДЕРЖАНИЕ

• SFTP — инструкция по работе с пользовательскими полями
  • Как обрабатываются файлы с ответами для пользовательских полей
  • Формат файла и правила именования
  • Частота загрузки и расписание
  • Формат файла для пользовательских полей

В этом разделе вы найдёте полезные советы, которые помогут вам успешно загружать файлы.

Общие рекомендации и информацию по работе с SFTP смотрите в разделе SFTP — инструкция по настройке.

Как обрабатываются файлы с ответами для пользовательских полей

В Spotnana вы можете загружать как полный, так и частичный список ответов для пользовательских полей. Название файла указывает, для какого поля и списка вариантов загружаются ответы. Для каждого пользовательского поля и его вариантов нужно отправлять отдельный файл (подробности по правилам именования — ниже). Система обрабатывает содержимое вашего CSV-файла по следующему принципу:

• Если в столбце ACTION для строки указано значение CREATE, то этот вариант ответа будет добавлен в список.

• Если в столбце ACTION для строки указано значение UPDATE и такой вариант ответа уже существует, его описание будет обновлено.

Если в столбце ACTION для строки указано значение DELETE , этот вариант ответа будет удалён. Если в базе Spotnana такого варианта нет, строка будет пропущена и никаких изменений не произойдёт.

Формат файла и правила именования

Имя каждого файла с пользовательскими полями в формате .CSV должно быть следующим:

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

где:

• [customFieldID] — это переменная, которая меняется для каждого поля. Этот ID можно найти в имени файла, показанном на шаге 2 в окне инструкции по импорту через SFTP — это часть инструкции по импорту из директории SFTP. 

• [optionGroupID] — это переменная, которая меняется для каждого списка вариантов. Этот ID также указан в имени файла на шаге 2 в окне инструкции по импорту через SFTP — это часть инструкции по импорту из директории SFTP.  

• Звёздочка * (wildcard) означает любые дополнительные символы, которые вы хотите добавить к имени. 

• Точка “.” после [optionGroupID] и точка перед “csv” обязательны. 

Регистр букв в имени файла не имеет значения. Для удобства поиска и устранения ошибок советуем добавлять в имя дату и время. Например:

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

Файл с данными в формате .CSV также должен соответствовать определённой структуре. Названия столбцов должны точно совпадать с указанными в формате (см. Формат пользовательских полей ниже). 

Частота загрузки и расписание

Рекомендуем загружать файл ежедневно — так Spotnana всегда будет в курсе всех добавлений, изменений или удалений (если вы часто обновляете пользовательские поля, ежедневная загрузка — оптимальный вариант). При таком подходе: 

• новые варианты ответов сразу становятся доступны для выбора путешественниками при бронировании; 

• устаревшие варианты удаляются из списка и больше не отображаются для выбора; 

При этом устаревшие варианты по-прежнему будут видны в отчётах.

Формат файла для пользовательских полей

Воспользуйтесь этой информацией, чтобы убедиться, что данные в вашем файле для загрузки пользовательских полей оформлены и подготовлены правильно.