Импорт списка дополнительных полей #3197

В данной инструкции речь пойдет об импорте дополнительных полей - именно о добавлении новых или обновлении существующих полей в общем списке дополнительных полей.

Шаг 1

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

Таблица должна содержать следующие столбцы (обязательность того или иного столбца может разниться в зависимости от того, какие поля Вы импортируете - об этом ниже):

Шаг 2

Теперь Вам необходимо заполнить полученную таблицу. 

Укажите в ячейках соответствующих столбцов следующие значения (подробнее о параметрах дополнительных полей читайте в инструкции по ссылке):

Заголовок столбца Значение Обязательность Для каких полей предназначено
name Название дополнительного поля, не более 100 символов. Обязательно Для всех полей
note Содержимое поля "Описание" - текст подсказки, выводимый в окне редактирования товара под дополнительным полем (не более 500 символов). Необязательно Для всех полей
type

Тип поля, доступны следующие значения:

  • text - текстовая строка,
  • int - целое число,
  • float - дробное число,
  • checkbox - галочка,
  • color - выбор цвета,
  • color2 - расширенный выбор цвета,
  • color_ref - справочник цветов,
  • textarea - текст,
  • html - текстовый редактор,
  • select - выпадающий список,
  • multiselect - выпадающий список множ.,
  • image2 - картинка,
  • file2 - файл,
  • date - календарь,
  • date_interval - календарь от-до.
Обязательно Для всех полей
code

Код поля

Обязательно только в том случае, если Вы планируете использовать его в качестве ключевого поля.  Для всех полей
range 

Значение галочки "Диапазон". Возможные значения:

  • 0 - галочка снята, при включенной фильтрации по данному полю фильтр будет предоставлять из себя одно поле для ввода точного значения.
  • 1 - галочка отмечена, появится возможность задать числовой диапазон ("от" и "до") на сайте для поиска товара внутри категории по значению дополнительного поля (если активна галочка "Фильтрация").
Необязательно "Целое число", "Дробное число", "Календарь", "Календарь От-До"
_sph_filter Значение галочки "Фильтрация". Возможные значения:
  • 0 - галочка снята, фильтрации по полю на сайте нет.
  • 1 - галочка отмечена, фильтрация по полю на сайте есть.
Необязательно "Целое число", "Дробное число", "Галочка", "Выпадающий список", "Выпадающий список множ.", "Справочник цветов", "Календарь", "Календарь От-До"
logic Значение галочки "Логика И". Возможные значения:
  • 0 - галочка снята, при фильтрации действует логика "ИЛИ", то есть на сайте по фильтру будут отображаться товары, хотя бы одно из значений списка которых выбрано в фильтре.
  • 1 - галочка отмечена, в процессе фильтрации на сайте будут отображаться только те товары, каждое из значений списка которых выбрано в фильтре.
Необязательно "Выпадающий список множ."
html Значение галочки "Разрешить html". Возможные значения:
  • 0 - галочка снята, html-теги в элементах дополнительного поля не поддерживаются,
  • 1 - галочка отмечена, html-теги в элементах дополнительного поля применяются при отображении на сайте.
Необязательно "Выпадающий список" и "Выпадающий список множ."
multi Значение галочки "Множественный выбор". Возможные значения:
  • 0 - галочка снята, множественный выбор выключен,
  • 1 - галочка отмечена, множественный выбор включен.
Необязательно "Справочник цветов"
size

Для полей типа "Текстовая строка", "Целое число", "Дробное число" - размер поля, не более 5 символов.

Для поля типа "Координаты" - ширина карты от 100 до 1000.

Необязательно "Текстовая строка", "Целое число", "Дробное число", "Координаты"
maxlength

Для полей типа "Текстовая строка", "Целое число", "Дробное число" - максимальная длина поля, не более 5 символов.

Для поля типа "Координаты" - высота карты от 100 до 1000. 

Необязательно "Текстовая строка", "Целое число", "Дробное число", "Координаты"
unit Единица измерения поля, не более 50 символов Необязательно "Текстовая строка", "Целое число", "Дробное число"
validator Значение поля "Валидатор" - регулярное выражение для проверки корректности введенного значения (используется при заполнении доп. полей товара в системе управления). Например, если указать ^\d+$, то дополнительное поле в системе управления можно будет заполнить только цифрами. Необязательно "Текстовая строка"
error Значение поля "Ошибка" - текст сообщения об ошибке при введении значения доп. поля товара, не прошедшего проверку регулярным выражением, указанным в поле "Валидатор". Необязательно "Текстовая строка"
items

Элементы (варианты выбора) дополнительного поля. 

  • Для выпадающих списков - просто перечень вариантов через символ-разделитель.
  • Для справочника цветов - перечень вариантов через символ-разделитель, каждый вариант должен быть представлен в виде "Название (обязательно, не более 100 символов)|код цвета|адрес картинки".

Необязательно "Выпадающий список", "Выпадающий список множ.", "Справочник цветов"

Шаг 3

После того как Вы сформируете таблицу со списком всех необходимых Вам дополнительных полей, ее нужно загрузить в Систему Управления. Для этого в разделе редактирования магазина нажмите на кнопку "Импорт".

php3CuqRY

Шаг 4

Перейдите на вкладку "Дополнительные поля", в ней выберите "Импорт списка доп. полей" и далее нажмите "Загрузить/выбрать файл" и загрузите и выберите сформированный Вами ранее файл.

234546261_6938_5cad89d6c7531.png

Для загрузки нового файла Вам будет необходимо в открывшемся окне нажать на кнопку "Добавить файл" (более подробно с информацией о загрузке файлов Вы можете ознакомиться в разделе "Добавление файлов в систему управления").

Шаг 5

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

В первую очередь укажите ключевое поле - поле, по которому система будет отличать поля друг от друга. Значения этого поля должны быть уникальны для каждого дополнительного поля.

  • Импорт с ключевым полем "Название доп. поля" позволяет как добавлять новые поля, так и изменять существующие по совпадению в названии. Однако, в случае наличия нескольких совпадений по ключевому полю (например, при обновлении доп. поля по названию в системе управления есть два поля с одинаковыми названиями) будет обновлено первое из полей в системе.
  • Импорт с ключевым полем "Код доп.поля" позволяет работать только в режиме обновления существующих.

234546261_6925_5cac96d898c39.png

Шаг 6

Затем выберите режим импорта:

  • Добавлять новые, не изменять существующие - добавляются только новые дополнительные поля из файла. При совпадении по ключевому полю с существующими - существующие не обновляются. Режим доступен только при ключевом поле "Названия доп. полей".
  • Добавлять новые, изменять существующие - при отсутствии совпадения по названию создаются новые поля. При наличии совпадения - обновляются существующие. Режим доступен только при ключевом поле "Названия доп. полей".
  • Изменять существующие, не добавлять новые - при совпадении по ключевому полю текущие дополнительные поля обновляются. Новые дополнительные поля не добавляются. Режим доступен при любом ключевом поле.

234546261_6926_5caca25790516.png

Шаг 7

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

234546261_6927_5caca2db302c8.png

Шаг 8

В конце нажмите "Запланировать импорт".

234546261_6928_5caca3676b19e.png

Шаг 9

Система оповестит Вас о создании фоновой задачи по импорту полей.

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

234546261_6929_5caca416b909c.png

С детальной информацией по задаче, а также с данными о произошедших ошибках (если таковые были) Вы можете ознакомиться, пройдя по ссылке "Подробнее" в строке с задачей в очереди.

234546261_6930_5caca4535b1cb.png

Была ли статья вам полезна?
Укажите, пожалуйста, почему?
Комментарий