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

Создано: Ashish Chaudhary, Изменено Сб, 4 Окт на 11:46 PM по Ashish Chaudhary

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 всегда будет в курсе всех добавлений, изменений или удалений (если вы часто обновляете пользовательские поля, ежедневная загрузка — оптимальный вариант). При таком подходе: 

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

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

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

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

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

СтолбецОбязательный/НеобязательныйПримечания
ДействиеОбязательный

Значение этого поля сообщает системе онлайн-бронирования (OBT), что нужно сделать с указанной информацией. 

  • CREATE — добавить новый вариант ответа.
  • UPDATE — изменить описание уже существующего варианта ответа. 
  • DELETE — удалить существующий вариант ответа. 

Вариант ответа

Обязательный

Название варианта ответа в системе онлайн-бронирования (OBT).

Описание

Необязательный

Краткое и понятное описание варианта ответа для пользователя. 

Статья помогла?

Отлично!

Спасибо за ваш отзыв

Извините, что не удалось помочь!

Спасибо за ваш отзыв

Расскажите, как мы можем улучшить эту статью!

Выберите хотя бы одну причину
Требуется проверка CAPTCHA.

Комментарий отправлен

Мы ценим вашу помощь и постараемся исправить статью