Правила атрибутов

Страница /admin/attribute-rules управляет правилами переименования и схлопывания параметров из XML-фида перед их записью в карточки товаров.

:::info Технические детали Описание алгоритма, схема БД и API — в разделе Синхронизация XML-фида. :::

---

Зачем нужны правила

Один и тот же параметр в разных категориях фида может называться по-разному:

• Процессор - Ноутбуки
• Линейка процессора - Ноутбуки
• Процессор - Моноблоки

Без правил все три попадут в карточку товара как отдельные атрибуты с разными именами. Правило позволяет объединить их под одним названием — например, «Процессор».

---

Интерфейс

Таблица правил

Показывает все настроенные правила. Для каждого правила:

Колонка	Описание
Итоговое название	Имя атрибута, которое попадёт в карточку товара
Источники (по приоритету)	Список источников из фида — пронумерован по убыванию приоритета
Действия	Изменить / Удалить

Форма создания и редактирования

Итоговое название — под этим именем атрибут будет сохранён в карточке товара. Например: Процессор, Цвет, Объём RAM.

Источники — имена параметров из фида. Порядок определяет приоритет: источник №1 важнее №2.

• Начните вводить название — появится выпадающий список с автодополнением из staging-таблицы
• Каждый вариант показывает количество вхождений в фиде — удобно для оценки покрытия
• Кнопки ▲ / ▼ меняют порядок (приоритет) источников
• Кнопка ✕ удаляет источник из списка

подсказка

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

---

Пример настройки

Задача: объединить три варианта названия процессора в один атрибут.

1. Нажать + Добавить правило
2. Итоговое название: Процессор
3. Добавить источники в порядке приоритета:
   1. Процессор - Ноутбуки (1 842 вхождения)
   2. Линейка процессора - Ноутбуки (634 вхождения)
   3. Процессор - Моноблоки (211 вхождений)
4. Сохранить

После следующего синка с «Сбросить кеш хеша» все три варианта будут схлоплены в атрибут Процессор.

---

Принудительное обновление

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

Элемент	Назначение
Запустить синк	Загрузить XML, применить правила, обновить атрибуты товаров
Сбросить кеш хеша	Удалить сохранённый SHA-256 хеш, чтобы синк обработал файл даже если он не изменился

:::warning Важно После добавления или изменения правил атрибутов запустите принудительный синк с галочкой «Сбросить кеш хеша». Иначе правила применятся только при следующем изменении XML-файла на сервере поставщика. :::

---

Как работает приоритет источников

Если в фиде присутствует несколько источников из правила, берётся тот, что стоит первым в списке. Остальные совпавшие удаляются.

Правило: Процессор ← ["Процессор - Ноутбуки", "Линейка процессора - Ноутбуки"]

Фид содержит оба:
  → берётся "Процессор - Ноутбуки" (индекс 0)
  → "Линейка процессора - Ноутбуки" удаляется

Фид содержит только второй:
  → берётся "Линейка процессора - Ноутбуки" (первый доступный)