Импорт из Excel

Что умеет решение

Модуль обеспечивает импорт данных из файлов формата .xlsx в выбранный инфоблок портала. С его помощью элементы и их свойства переносятся из листа Excel в целевой инфоблок, что часто используется для загрузки прайс-листов в торговый каталог.

Перед началом работы подготовьте файл .xlsx с необходимыми данными. После установки модуля в разделе «Сервисы» административной части появится пункт «Импорт из Excel». Переход по нему открывает страницу управления профилями импорта, где можно создать несколько конфигураций.

Для создания нового профиля нажмите кнопку «Новый профиль импорта» и заполните поля:

— Название профиля: имя для идентификации в списке.

— Файл: прикрепите файл .xlsx для определения структуры столбцов.

— ID инфо-блока: выберите тип инфоблока и укажите конкретный инфоблок для загрузки.

— Количество элементов за шаг: задайте число элементов, обрабатываемых за одну итерацию импорта.

Элементы только обновлять: при импорте данные обновляются только в существующих записях, новые не создаются.

Деактивировать новые элементы: создаваемые в ходе импорта элементы помечаются как неактивные.

Деактивировать элемент при отсутствии товара: если включен количественный учет и количество равно нулю, элемент автоматически деактивируется.

Деактивировать элемент при нулевой цене: если включен количественный учет и цена равна нулю, элемент автоматически деактивируется.

Активировать элемент при наличии товара и ненулевой цене: если включен количественный учет, цена больше нуля и количество больше нуля, элемент активируется.

Строка с заголовками: укажите номер строки в файле Excel, где расположены названия столбцов.

Первая строка с данными: укажите номер строки в файле Excel, с которой начинаются импортируемые данные.

Настройка профиля импорта из Excel

Укажите номер последней строки с данными в файле. Если поле оставить пустым, обработка затронет весь лист. Задайте ID раздела инфоблока для размещения новых элементов; по умолчанию используется корневая папка.

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

Настройка сопоставлений

Этот шаг необходим для связывания столбцов Excel-файла с полями инфоблока. Выберите профиль импорта, откройте его настройки и перейдите в раздел «Сопоставления».

Каждое соответствие между полем файла и полем инфоблока создается как отдельный элемент. Обязательно отметьте один из элементов как уникальный идентификатор, включив флажок «Уникальный идентификатор элемента». Это требуется для корректной обработки записей.

Нажмите «Добавить» и заполните параметры сопоставления:

— Столбец в файле: выберите из списка название столбца с данными в Excel-файле.

Если ячейка столбца пуста, строка не будет импортирована — активируйте соответствующий переключатель.

Уникальный идентификатор элемента — отметьте этот столбец, если он содержит уникальный код элемента.

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

Преобразование формата — при необходимости выберите тип преобразования: Дата, Дата со временем, Картинка или Ссылка. Данные в этом столбце будут автоматически приведены к выбранному формату.

Сопоставление поля или свойства — выберите целевую область: поля инфоблока, свойства инфоблока или торговый каталог. Установите переключатель в нужном разделе, чтобы определить, куда будет записан импортируемый столбец.

Нажмите «Сохранить».

Повторите настройку сопоставления для каждого столбца, подлежащего импорту.

Поля для переменных (Название переменной, Значение переменной) доступны только в пользовательских обработчиках для строк без заголовков.

Процесс импорта

После заполнения данных на вкладках «Профиль» и «Сопоставления» перейдите к импорту файла. Выберите нужный профиль в списке, откройте его и перейдите на вкладку «Импорт». Альтернативно нажмите кнопку настроек рядом с названием профиля и выберите «Импортировать». В поле «Файл» укажите путь к .xlsx-файлу в файловой системе компьютера. Нажмите кнопку «Импортировать».

Важные ограничения и требования:

Данные импортируются только с первого листа Excel-файла, остальные листы игнорируются.

Модуль корректно работает только с файлами формата .xlsx. Файлы .xls необходимо конвертировать, сохранив их в формате .xlsx с помощью Excel 2007 или более поздних версий.

Проверка нулевого количества выполняется только для элементов с включенным количественным учетом. Настройку можно активировать глобально в параметрах торгового каталога или индивидуально для каждого товара.

Для корректной работы модуля в настройках PHP должны быть включены расширения: zip, xmlwriter и dom.

Модуль «Импорт из Excel» требует установленных расширений PHP: zip, XMLwriter и DOM.

Для активации расширения zip выполните команду yum install php70*zip. Если расширение уже установлено, добавьте строку extension=zip.so в конфигурационный файл /etc/php.d/40-zip.ini. При необходимости укажите полный путь к файлу, например: extension=/opt/remi/php70/root/lib64/php/modules/zip.so.

Для включения модулей XMLwriter и DOM переместите файлы 20-xmlwriter.ini.disabled и 20-dom.ini.disabled из каталога /etc/php.d/ в файлы 20-xmlwriter.ini и 20-dom.ini соответственно. После внесения изменений перезапустите веб-сервер и проверьте применение настроек через phpinfo –i.

В разделе «Настройки продукта» — «Настройки модулей» — «Импорт прайса из Excel» доступен упрощённый режим для групп. Вы можете выбрать конкретные группы и задать параметры импорта первого шага. Для пользователей этих групп данные настройки станут недоступны для изменения и будут применяться по умолчанию.

Для «Импорт из Excel» команда General iT может выполнить подключение, настройку и контрольную проверку после установки.