MS: Расширенный импорт по характеристикам
Описание
Модуль ms_import_commerceml расширяет функциональность импорта CommerceML, позволяя распределять товар по нужным категориям в зависимости от характеристики, управлять статусами импортируемых заказов, а также управлять специальным реквизитом для выгрузки префикса к заказу.
Основные возможности
- Распределение по категориям: Автоматическое создание и распределение товаров по категориям на основе характеристик
- Управление статусами: Управление статусами товаров на основе характеристик при импорте
- Многоуровневые категории: Создание категорий по уровням (1, 2, 3) на основе характеристик
- Экспорт номера заказа: Добавление префикса к номеру заказа при экспорте в CommerceML
- Интеграция с CommerceML: Расширение стандартного импорта CommerceML дополнительными возможностями
Как работает модуль
Модуль использует следующие механизмы:
- Функции работы с категориями (
func.php):
fn_get_imported_categories()- создает категории на основе характеристик товара:- Получает настройки сопоставления характеристик с уровнями категорий
- Создает категории по уровням (1, 2, 3) на основе значений характеристик
- Возвращает ID конечной категории для товара
- Хуки импорта (
hooks.func.php):
fn_ms_import_commerceml_update_product_categories_pre()- распределяет товары по категориям при импорте:- Проверяет настройку использования характеристик для создания категорий
- Вызывает функцию создания категорий на основе характеристик
- Устанавливает основную категорию и список категорий для товара
fn_ms_import_commerceml_update_product_pre()- управляет статусами товаров:- Проверяет значение отслеживаемой характеристики
- Устанавливает статус товара в зависимости от значения характеристики:
- "Включен" (A) - при значении
ms_status_feature_on - "Выключен" (D) - при значении
ms_status_feature_off - Специальный статус - при значении
ms_status_feature_special(устанавливаетavail_since)
- Хук экспорта (
hooks.func.php):
fn_ms_import_commerceml_commerceml_order_formator_form()- добавляет префикс к номеру заказа при экспорте:- Проверяет настройку экспорта номера заказа
- Добавляет поле "НомерПоДаннымКлиента" с префиксом к номеру заказа
- Схемы:
schemas/cml/aliases.post.php- определяет алиасы для полей CommerceML
Где находится функциональность
- Административная панель:
- Настройки модуля с сопоставлением характеристик и категорий
- Настройки управления статусами товаров
- Страница синхронизации данных CommerceML
Настройки модуля
- Использовать характеристики для сопоставления категорий (
used_features): Включить создание категорий на основе характеристик - Использовать характеристики только для новых товаров (
feature_new_product): Применять только к новым товарам при импорте - 1 уровень (
ms_product_features): Сопоставление характеристики с уровнем 1 категории - 2 уровень: Сопоставление характеристики с уровнем 2 категории
- 3 уровень: Сопоставление характеристики с уровнем 3 категории
- Отслеживаемая характеристика (
ms_status_feature_id): Характеристика для управления статусами - Статус товара "Включен" (
ms_status_feature_on): Вариант характеристики для статуса "Включен" - Статус товара "Выключен" (
ms_status_feature_off): Вариант характеристики для статуса "Выключен" - Специальный статус товара (
ms_status_feature_special): Вариант характеристики для специального статуса - Экспорт номера заказа (
export_order_number): Включить экспорт номера заказа с префиксом
Использование
- Настройка сопоставления категорий:
- Выберите характеристики для уровней категорий (1, 2, 3)
- Укажите варианты характеристик для каждого уровня
- Настройка управления статусами:
- Выберите характеристику для отслеживания статусов
- Укажите варианты характеристики для разных статусов
- Результат:
- При импорте товары автоматически распределяются по категориям на основе характеристик
- Статусы товаров устанавливаются автоматически на основе значений характеристик
Технические детали
- Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart
- Работает только при импорте через CommerceML (
dispatch == 'commerceml.import') - Создает категории автоматически, если они не существуют
- Использует настройки импорта CommerceML для определения компании
Локализации:
- English
- Русский
Совместимость:
- 4.18.X
# Инструкция по использованию модуля MS: Расширенный импорт по характеристикам
Установка
- Убедитесь, что модуль активирован в разделе Администрирование → Модули → Скачанные модули
- Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart
- Важно: Модуль работает только с импортом CommerceML
Настройка
- Перейдите в Администрирование → Модули → Скачанные модули → MS: Расширенный импорт по характеристикам
- Настройка создания категорий по характеристикам:
- Использовать характеристики для сопоставления категорий: Включите для автоматического создания категорий
- Использовать характеристики только для новых товаров: Включите, если нужно применять только к новым товарам
- 1 уровень: Выберите характеристику и вариант для уровня 1 категории
- 2 уровень: Выберите характеристику и вариант для уровня 2 категории
- 3 уровень: Выберите характеристику и вариант для уровня 3 категории
- Настройка управления статусами:
- Отслеживаемая характеристика: Выберите характеристику для управления статусами товаров
- Статус товара "Включен": Выберите вариант характеристики для статуса "Включен"
- Статус товара "Выключен": Выберите вариант характеристики для статуса "Выключен"
- Специальный статус товара: Выберите вариант характеристики для специального статуса
- Настройка экспорта:
- Экспорт номера заказа: Включите для добавления префикса к номеру заказа при экспорте
- Сохраните изменения
Использование
Для администратора
- Подготовка характеристик:
- Создайте характеристики для уровней категорий (если еще не созданы)
- Создайте характеристику для управления статусами (если еще не создана)
- Назначьте эти характеристики товарам в системе 1C или другой системе учета
- Импорт товаров:
- Выполните импорт товаров через CommerceML
- Товары автоматически распределятся по категориям на основе характеристик
- Статусы товаров установятся автоматически на основе значений характеристик
- Проверка результатов:
- Проверьте, что категории созданы корректно
- Убедитесь, что товары находятся в правильных категориях
- Проверьте статусы товаров
Пример настройки
- Создание категорий:
- Характеристика "Тип товара" → вариант "Электроника" → уровень 1
- Характеристика "Категория" → вариант "Смартфоны" → уровень 2
- Характеристика "Бренд" → вариант "Apple" → уровень 3
- Управление статусами:
- Характеристика "Статус товара" → вариант "В продаже" → статус "Включен"
- Характеристика "Статус товара" → вариант "Снят с производства" → статус "Выключен"
Проверка работы
- Проверка создания категорий:
- Выполните импорт товаров с характеристиками
- Проверьте, что категории созданы по уровням
- Убедитесь, что товары находятся в правильных категориях
- Проверка статусов:
- Проверьте, что статусы товаров установлены корректно на основе характеристик
Устранение неполадок
- Категории не создаются: Проверьте настройки сопоставления характеристик и убедитесь, что характеристики присутствуют в импортируемых данных
- Статусы не изменяются: Проверьте настройки отслеживаемой характеристики и варианты статусов
- Товары не распределяются: Убедитесь, что характеристики правильно назначены товарам в системе учета
Ключевые файлы
app/addons/ms_import_commerceml/addon.xml- конфигурация модуляapp/addons/ms_import_commerceml/func.php- функции создания категорий и получения вариантов характеристикapp/addons/ms_import_commerceml/hooks.func.php- хуки импорта и экспорта CommerceMLapp/addons/ms_import_commerceml/schemas/cml/aliases.post.php- алиасы полей CommerceML
**v1.1.7** [+] Доработка настроек [\*] Изменения после ревью [+] Добавлена настройка "Экспорт номера заказа" и алгоритм, который тег с языковой переменной ms_import_commerceml.client_order_number_alias и значением тега является префикс из переменной ms_import_commerceml.client_order_number_prefix плюс номер заказа **v1.1.6** [\*] Стандартизация модуля **v1.1.5** (08.02.2022) [!] Исправлен импорт категорий для старых товаров [\*] Поправлены переводы **v1.1.4** (08.02.2022) [+] Добавлена настройка для применения х-ки для новых товаров **v1.1.3** (03.02.2022) [\*] Поправлены переводы **v1.1.2** (18.01.2022) [!] Импорт по характеристикам работает для новых товаров **v1.1.1** (13.01.2022) [!] Исправлен импорт категорий если данная категория уже присуствует **v1.1.0** (17.12.2021) [+] Распределение по папкам исходя из х-ки. **v1.0.0** (16.12.2021) [+] Первое издание *** [+] Добавлено [-] Удалено [\*] Изменено [!] Исправлена ошибка
Отзывы
Здесь можно поделиться своим мнением и оценить нашу работу.
Ваши отзывы помогают нам стать лучше и предлагать вам еще более качественный сервис.