Описание
[P][B]Модуль предназначен для импортирования данных из файла с расширением .xlsx[/B][B] в выбранный инфоблок на портале.[/B][/P]
[P]Решение служит для загрузки элементов и их свойств из xlsx-листа в определенный инфоблок. Чаще всего это требуется для импорта прайс-листа в формате .xlsx в торговый каталог.[/P]
[P]Перед началом работы создайте файл с расширением .xlsx, содержащий прайс-лист или другие данные для загрузки в инфоблок на портале.[/P]
[P]После установки модуля в административной части в разделе [B]Сервисы[/B] появится новый пункт — [B]Импорт из Excel[/B]. При переходе в этот пункт меню откроется страница с профилями импорта (их можно создать несколько). [/P]
[P][B][U]Создание профиля[/U][/B][/P]
[P]Для создания нового профиля импорта данных нажмите «[B]Новый профиль импорта[/B]».[/P]
[P]Заполните следующие поля:[/P]
[P]— [B]Название профиля[/B] — введите название профиля для его идентификации в общем списке.[/P]
[P]— [B]Файл[/B] — прикрепите созданный вами файл Excel с расширением [B].[/B][B]xlsx[/B][B] [/B]для[B] [/B]считывания структуры столбцов.[/P]
[P]— [B]ID инфо-блока[/B] — выберите тип инфоблока, в который нужно импортировать элементы. В соседнем поле укажите нужный инфоблок.[/P]
[P]— [B]Кол-во элементов, обрабатываемых за шаг импорта[/B] — укажите число элементов, которое будет обработано за один шаг.[/P]
[P]— [B]Элементы только обновлять (не создавать) [/B]— поставьте эту галочку, чтобы посредством импорта только обновить данные в уже имеющихся элементах, не создавая новые.[/P]
[P]— [B]Деактивировать новые элементы [/B]— поставьте эту галочку, чтобы при создании новых элементов они были не активны (деактивированы).[/P]
[P]— [B]Деактивировать элемент, если товара нет в наличии[/B] — поставьте эту галочку, чтобы деактивировать элемент в случае, если количество нулевое и включен количественный учет.[/P]
[P]— [B]Деактивировать элемент, если цена нулевая [/B]— поставьте эту галочку, чтобы деактивировать элемент в случае, если его цена нулевая и включен количественный учет.[/P]
[P]— [B]Активировать элемент, если цена НЕ нулевая и товар в наличии[/B] — поставьте эту галочку, чтобы активировать элемент, если цена больше нуля, количество больше нуля и включен количественный учет.[/P]
[P]— [B]Строка с заголовками[/B] — укажите номер строки Excel-файла, в которой находятся заголовки столбцов.[/P]
[P]— [B]Первая строка с данными[/B] — укажите номер строки Excel-файла, с которой начинаются данные для импорта.[/P]
[P]— [B]Крайняя строка с данными [/B](если не указано, до конца листа) — укажите номер строки Excel-файла, на которой заканчиваются данные для импорта. Если это поле не заполнено, то файл будет обработан до конца листа.[/P]
[P]— [B]ID раздела для новых элементов инфо-блока (по умолчанию корень)[/B] — для загрузки данных в выбранный в этом поле подкаталог.[/P]
[P]После заполнения всех полей нажмите «[B]Сохранить[/B]».[/P]
[P]После сохранения вы будете перенаправлены на страницу со списком профилей импорта. Нажмите кнопку настроек рядом с названием и выберите «[B]Сопоставления[/B]».
[/P]
[P][B][U]Сопоставления[/U][/B][/P]
[P]Следующим шагом является настройка сопоставлений между столбцами excel-файла и полями инфоблока, в который будут импортироваться данные.[/P]
[P]Выберите в списке профилей импорта тот, для которого будете задавать сопоставления. Нажмите на кнопку настроек рядом с его названием и выберите «[B]Сопоставления[/B]».[/P]
[P]Для каждого сопоставления нужно создать отдельный элемент. [/P]
[P][B]Важно![/B] Один из элементов [B]должен быть[/B] уникальным идентификатором — при создании сопоставления по данному элементу включите флажок «[B]Уникальный идентификатор элемента[/B]».
[/P]
[P]Нажмите «[B]Добавить[/B]» и заполните поля:[/P]
[P]— [B]Столбец в файле [/B]— выберите из списка название столбца с данными в Excel-файле.[/P]
[P]— [B]Не импортировать строку, если эта ячейка пуста[/B] — проставьте галочку, чтобы не импортировать строки, в которых ячейка данного столбца пуста.[/P]
[P]— [B]Уникальный идентификатор элемента[/B] — проставьте галочку если данный столбец содержит уникальный идентификатор элемента.[/P]
[P][B]Важно! [/B][I]При настройке импорта одно из свойств/полей должно являться уникальным идентификатором, без этого импорт не будет запущен.[/I][/P]
[P]— [B]Преобразование[/B] — при необходимости выберите вид преобразования — Дата, Дата со временем, Картинка, Ссылка. При импортировании этого столбца данные будут преобразованы в соответствующий формат.[/P]
[P]— [B]Поле/свойство элемента[/B]: в этом разделе представлены три области для выбора сопоставления — Поля элементов инфоблока, Свойства элементов инфоблока, Торговый каталог. То есть выбранный столбец может быть импортирован в одно из полей или свойств элементов инфоблока или в торговый каталог. Установите переключатель в один из пунктов представленных областей.[/P]
[P]Нажмите «[B]Сохранить[/B]».[/P]
[P]Повторите процедуру добавления сопоставлений для каждого импортируемого столбца.[/P]
[P]Поля для переменных (Название переменной, Значение переменной) могут использоваться только в самостоятельно написанных обработчиках для строк, где нет названия.[/P]
[P][B][U]Импорт[/U][/B][/P]
[P]После того как данные на вкладках «[B]Профиль[/B]» и «[B]Сопоставления[/B]» заполнены, можно переходить непосредственно к импорту файла.[/P]
[P]В списке профилей импорта выберите нужный, откройте его, перейдите на вкладку «[B]Импорт[/B]». Либо в списке профилей импорта нажмите на кнопку настроек рядом с названием и выберите «[B]Импортировать[/B]». В поле «[B]Файл[/B]» выберите из структуры папок на компьютере ваш .xlsx-файл.[/P]Нажмите «[B]Импортировать[/B]».
[P][B]Обратите внимание:[/B][/P]
[P][/P][LIST]
[*]Данные импортируются только с первого листа Excel-файла, независимо от их количества.
[*]Для корректной работы модуля нужно использовать xlsx файлы, а не xls. Конвертировать файл можно просто пересохранив его из xls, используя Excel 2007 или более поздней версии.
[*]Нулевое количество проверяется только для элементов, у которых включен количественный учет. Включить количественный учет можно в настройках торгового каталога, также можно менять в каждом товаре индивидуально.
[/LIST][P][/P]
[P][B]Внимание! [/B]Для корректной работы модуля в настройках php нужно включить расширения zip, xmlwriter и dom:[/P]
[P][B]ZIP[/B] [/P]
[P]Если расширение php-zip не установлено, то устанавливаем:[/P]
[P]yum install php70*zip[/P]
[P]Ели расширение уже установлено, то нужно подключить его в файле /etc/php.d/40-zip.ini, прописав там: [/P]
[P]; Enable ZIP extension module [/P]
[P]extension=zip.so //либо другой путь к zip.so (можно найти поиском), например extension=/opt/remi/php70/root/lib64/php/modules/zip.so [/P]
[P][B]XMLwriter и DOM[/B][/P]
[P]В папке /etc/php.d/ нужно перенести содержимое файла:[/P]
[P]20-xmlwriter.ini.disabled в 20-xmlwriter.ini [/P]
[P]20-dom.ini.disabled в 20-dom.ini [/P]
[P]Не забудьте перезагрузить веб-сервер и проверить применение настроек через phpinfo –i.[/P]
[P][B]Упрощенный режим для групп[/B][/P]
[P]При необходимости вы можете настроить упрощённый режим для групп в разделе [B]Настройки продукта[/B] — [B]Настройки модулей[/B] — [B]Импорт прайса из Excel[/B].[/P]
[P]На странице параметров вы можете выбрать нужные группы и задать для них параметры импорта первого шага, тогда они будут недоступны для изменения пользователям этих групп и будут выставлены по умолчанию при импорте.[/P]
