Модуль Eofferix устанавливается на сайт UMI.CMS и принимает подготовленный каталог из сервиса: разделы, товары, торговые предложения, цены, остатки, изображения, файлы и свойства из источника. Сервис забирает исходники из email, с файлообменников, с FTP, из 1С, по ссылке, из закрытых по паролю личных кабинетов, затем преобразует данные по заданным правилам и записывает результат в структуру UMI.CMS.
Для установки потребуется
- Доступ к файлам сайта UMI.CMS по SSH, SFTP, FTP или через файловый менеджер хостинга.
- Пользователь с доступом в админку UMI.CMS с правами администратора.
- Архив установщика
eofferix-umi-install.zip. Если установщик заблокирован хостингом, используйте архив модуляeofferix-umi-cms-module.zip.
Шаг 1. Установите модуль UMI.CMS
- Войдите в админку UMI.CMS в том же браузере, где будете открывать установщик.
- Скачайте
eofferix-umi-install.zipи распакуйте архив. - Загрузите папку
eofferix-umi-installв корень сайта, рядом с основнымindex.php. - Откройте
https://site.com/eofferix-umi-install/install.php. - Дождитесь сообщения об успешной установке.
- Удалите папку
eofferix-umi-installс сайта.
Шаг 2. Подключите профиль к UMI.CMS
Откройте профиль Eofferix, выберите шаблон UMI.CMS, укажите адрес сайта, логин администратора и пароль, затем нажмите Проверить подключение. После успешной проверки Eofferix получает список типов данных, полей и корневых разделов сайта.
Шаг 3. Выберите типы данных, корневой раздел и поля идентификации
В блоке Идентификация элементов UMI.CMS выберите тип данных UMI.CMS для товаров и тип данных для разделов, корневой раздел выгрузки и поля, по которым Eofferix будет искать уже существующие разделы, товары и торговые предложения.
Поля идентификации отвечают за поиск уже существующих разделов, товаров и торговых предложений. Выберите ключ, по которому ваш источник должен сличаться с каталогом UMI.CMS: external_id, артикул, id, связка «Название товара + Артикул» или другое стабильное поле.
Как работают «И» и «ИЛИ». Отдельные плашки идентификации соединяются условием И. Внутри одной плашки кнопка «или …» добавляет альтернативные поля, которые проверяются слева направо. Например: (Артикул ИЛИ Внешний код ИЛИ Штрихкод) И Поставщик И (Бренд ИЛИ Производитель).
Eofferix останавливается на первой полной комбинации, по которой найдены существующие объекты. Если она нашла несколько объектов, весь найденный набор обрабатывается выбранным правилом дублей: поиск не переходит к следующей альтернативе. Значение каждой обязательной группы должно быть заполнено. Пользователь может выбрать любые доступные поля, а дополнительные альтернативы не расходуют дополнительные кредиты.
Корневой раздел определяет, куда будут создаваться новые разделы из источника. Если выбран конкретный раздел, новые ветки каталога создаются внутри него. Если выбран корень сайта, разделы будут создаваться от корня.
Для 1С лучше использовать external_id как для товаров, так и для торговых предложений: они всегда уникальны.
Для разделов отдельное поле идентификации имеет смысл выбирать, если разделы идут отдельным блоком в источнике. Если раздел указан внутри товара как полный путь или простое название, отдельное сличение разделов обычно не требуется: используйте путь раздела после преобразований.
Шаг 4. Выберите сценарий импорта
В настройках профиля можно выбрать готовый сценарий обмена. Он задает, что делать с новыми товарами, уже найденными товарами, торговыми предложениями и объектами, которых больше нет в источнике.
| Сценарий | Когда использовать |
|---|---|
| Бережный обмен | Eofferix создает новые товары и обновляет найденные, но не удаляет отсутствующие автоматически. Также не привязывает товары и торговые предложения к конкретному профилю. |
| Полная синхронизация источника | Профиль привязывает все импортируемые товары и торговые предложения к себе. Повторный запуск профиля удалит товары и торговые предложения, которые пропали из источника, и добавит новые, которые появились с очередным обновлением. |
| Обновить найденные | Сценарий подходит, когда нужно менять цены, остатки, названия или свойства только у уже найденных товаров и торговых предложений. Новые товары не создаются. |
| Добавить только новые | Когда нужно добавить отсутствующие товары и торговые предложения, но не менять то, что уже есть на сайте. |
| Полная перезапись каталога | Сценарий удаляет отсутствующие товары, торговые предложения и разделы в выбранной области, затем создаёт или обновляет объекты из текущего источника. Характеристики и значения справочников сохраняются. |
Также можно вручную настроить поведение обмена для товаров, торговых предложений и разделов.
Шаг 5. Разметьте роли в снапшоте
В снапшоте отметьте, какой узел является товаром, какой — разделом, а какой — торговым предложением. Если разделы не идут отдельным блоком, а указаны внутри товара, роль раздела можно не ставить: достаточно настроить путь раздела. Если предложения вложены в товар, Eofferix видит связь по структуре XML. Если предложения приходят отдельным блоком, в роли ТП используйте служебное поле product_external_id — Привязка ТП к товару.
Шаг 6. Привяжите поля товара, раздела и ТП
Каждое значение в снапшоте можно привязать к полю UMI.CMS. Свойства товара должны записываться в товар. Свойства раздела — в раздел. Цена, остаток, артикул, картинка и свойства торгового предложения должны записываться в конкретное ТП, а не в родительский товар.
Перед записью в CMS значение можно подготовить: очистить текст, привести число или дату к нужному виду, собрать результат из нескольких узлов, сопоставить значение со справочником или добавить условия выгрузки. Полезные примеры: преобразования значений, условия выгрузки поля, сопоставление по справочнику и несколько значений в одном поле.
Шаг 7. Настройте картинки и файлы
В XML, CSV, Excel и других источниках обычно передаются ссылки на изображения, пути или имена файлов. Eofferix скачивает картинки по ссылкам, достает их из архивов 1С или из загруженных вместе с источником архивов и файлов, затем передает подготовленные файлы в UMI.CMS. В дополнительных настройках поля изображения можно сохранить файл на сервисе, автоматически конвертировать формат, уменьшить большое изображение до нужной ширины и высоты и задать качество для JPEG/WEBP. Это сильно влияет на размер файлов и скорость загрузки страниц сайта.
Там же можно включить водяной знак: загрузить PNG/WEBP-файл, выбрать положение, прозрачность и максимальный размер. Для галерей доступны разделитель, диапазон картинок и пропуск повторной загрузки, если файл не изменился.
Шаг 8. Запустите тестовую выгрузку
Для проверки используйте Тестовую выгрузку. Она отправляет в UMI.CMS ограниченную выборку на 5 товаров, и не запускает удаление пропавших элементов/разделов и прочего.
Обычная тестовая выгрузка не запускает очистку пропавших объектов. Если включить «Тест как полный запуск», к ограниченной выборке применяются правила полного запуска: очистка может затронуть отсутствующие товары, торговые предложения, разделы и изображения в выбранной области.
Модуль Eofferix для UMI.CMS не удаляет свойства, характеристики и значения справочников. Он может сопоставить существующее свойство или значение либо создать недостающее, но не удаляет и не отвязывает созданные свойства и значения при последующих запусках. Правила для отсутствующих товаров, торговых предложений, разделов и изображений работают отдельно.
Импорт в UMI.CMS не поддерживает откат к состоянию предыдущего запуска и не создаёт точек отката. Остановленный запуск можно продолжить только при наличии подтверждённой точки продолжения; иначе после исправления причины запустите обычный новый импорт. Перед полным запуском с удаляющими правилами сделайте резервную копию сайта и базы данных.
Стоимость и пропуск элементов без изменений
Перед запуском Eofferix считает прогноз стоимости. При повторных обменах товары и торговые предложения без изменений должны проходить по отдельному дешевому действию UMI.CMS · элемент без изменений. Это нужно, чтобы регулярный обмен не стоил как полная пересборка каталога.
Если каталог уже загружен, но повторный запуск снова выглядит как создание тысяч новых объектов, проверьте поля идентификации товара и предложения, сценарий импорта и привязку элементов к профилю.
Если нужно принудительно перезаписать найденные элементы импортируемого каталога, снимите галку Не обновлять элемент в UMI, если данные не изменились в блоке Продвинутые настройки импорта. После этого сервис перестанет быстро пропускать элементы без изменений и выполнит полноценное обновление – такой запуск может идти дольше и стоить дороже.
