Настройка массового изменения свойств товаров 1С-Битрикс

Настройка массового изменения свойств товаров 1С-Битрикс

В каталоге 15 000 товаров нужно проставить новое свойство «Материал» у 8 000 позиций определённой категории, исправить опечатку в значении фасетного фильтра у 2 000 товаров, снять флаг «Рекомендуемый» у половины ассортимента. Через карточку товара это недели работы. Задача решается пакетным обновлением через API с контролем целостности данных.

Где хранятся свойства

Свойства товаров в Битрикс хранятся в нескольких местах в зависимости от типа:

• Поля элемента (NAME, PREVIEW_TEXT, ACTIVE и др.) — b_iblock_element
• Свойства инфоблока — b_iblock_element_property, где IBLOCK_PROPERTY_ID — ID свойства, VALUE — значение
• Множественные свойства — несколько строк в b_iblock_element_property с одним IBLOCK_ELEMENT_ID и одним IBLOCK_PROPERTY_ID
• Свойства типа «Список» — VALUE содержит текстовое значение, VALUE_ENUM_ID — ссылку на b_iblock_property_enum

Для торговых предложений — аналогичная структура, но IBLOCK_ID указывает на инфоблок предложений, а не основной каталог.

Массовое обновление через CIBlockElement::SetPropertyValues

Базовый подход для небольших объёмов (до 1 000 элементов):

$iblockId   = 10; // ID инфоблока каталога
$propertyCode = 'MATERIAL';
$newValue   = 'Хлопок 100%';

// Получаем список элементов нужной секции
$res = \CIBlockElement::GetList(
    [],
    ['IBLOCK_ID' => $iblockId, 'SECTION_ID' => 42, 'ACTIVE' => 'Y'],
    false,
    false,
    ['ID']
);

while ($row = $res->Fetch()) {
    \CIBlockElement::SetPropertyValues(
        $row['ID'],
        $iblockId,
        $newValue,
        $propertyCode
    );
}

На больших объёмах этот метод медленный — он читает текущие значения, сравнивает, обновляет. Каждый вызов — несколько SQL-запросов.

Быстрое обновление через D7 ORM

Для объёмов от 1 000 элементов используйте прямое обновление b_iblock_element_property:

use Bitrix\Iblock\ElementPropertyTable;

// Сначала получаем ID свойства
$propertyId = getPropertyIdByCode($iblockId, 'MATERIAL');

// Получаем ID элементов пакетами
$elementIds = getElementIdsBySectionBatch($iblockId, $sectionId, 500);

foreach (array_chunk($elementIds, 500) as $chunk) {
    // Проверяем, у кого уже есть запись
    $existing = ElementPropertyTable::getList([
        'filter' => [
            'IBLOCK_PROPERTY_ID' => $propertyId,
            'IBLOCK_ELEMENT_ID'  => $chunk,
        ],
        'select' => ['ID', 'IBLOCK_ELEMENT_ID'],
    ])->fetchAll();

    $existingMap = array_column($existing, 'ID', 'IBLOCK_ELEMENT_ID');

    foreach ($chunk as $elementId) {
        if (isset($existingMap[$elementId])) {
            // Обновляем существующую запись
            ElementPropertyTable::update($existingMap[$elementId], ['VALUE' => 'Хлопок 100%']);
        } else {
            // Вставляем новую
            ElementPropertyTable::add([
                'IBLOCK_ELEMENT_ID'  => $elementId,
                'IBLOCK_PROPERTY_ID' => $propertyId,
                'VALUE'              => 'Хлопок 100%',
            ]);
        }
    }
}

После прямого изменения таблицы нужно сбросить кэш инфоблока:

\Bitrix\Iblock\InformationBlock::cleanTagCache($iblockId);
\Bitrix\Main\Application::getInstance()->getTaggedCache()->clearByTag('iblock_id_' . $iblockId);

Массовое изменение значений типа «Список»

Свойства типа «Список» (используются в фасетном фильтре) хранят в VALUE текстовое значение, а в VALUE_ENUM_ID — ID из b_iblock_property_enum. При изменении значения нужно обновлять оба поля.

// Находим ID нового значения в перечислении
$enumRes = \CIBlockPropertyEnum::GetList(
    [],
    ['PROPERTY_ID' => $propertyId, 'VALUE' => 'Синий']
);
$enum = $enumRes->Fetch();
$enumId = $enum['ID'];

// Обновляем
ElementPropertyTable::update($existingPropId, [
    'VALUE'         => 'Синий',
    'VALUE_ENUM_ID' => $enumId,
]);

Если нужного значения ещё нет в перечислении — сначала добавьте его через CIBlockProperty::SetEnumValues() или напрямую в b_iblock_property_enum.

Обновление через административный импорт

Для нетехнических пользователей или регулярных обновлений лучше подходит импорт CSV через Каталог → Импорт. Шаблон файла: первая строка — заголовки с кодами полей (ID, PROPERTY_MATERIAL, PROPERTY_COLOR). Битрикс обновляет только те свойства, колонки которых присутствуют в файле.

Ограничение стандартного импорта: нет поддержки условий («обновить свойство только если текущее значение пустое»). Для таких сценариев — только скрипты.

Инвалидация фасетного индекса

После массового изменения свойств, которые используются в фасетном фильтре (catalog.smart.filter), необходимо перестроить индекс:

\Bitrix\Iblock\PropertyIndex\Manager::markIblockToReindex($iblockId);
// или принудительно:
$indexer = new \Bitrix\Iblock\PropertyIndex\Indexer($iblockId);
$indexer->startIndex();
$indexer->continueIndex(0);
$indexer->endIndex();

На каталоге 50 000+ товаров переиндексация занимает несколько минут — запускайте в фоне через агент или cron.

Сроки выполнения