Налаштування масової зміни статусів товарів 1С-Бітрікс

Налаштування масової зміни статусів товарів у 1С-Бітрікс

Сезон закінчився — 200 товарів потрібно зняти з публікації. Акція запускається о полночі — 50 товарів активуються одночасно. Обидва сценарії вирішуються масовою зміною статусів, але неправильна реалізація дає race condition або падає сайт під навантаженням на MySQL.

Що таке "статус" товара в Бітріксі

Товар у Бітріксі — елемент інфоблока. "Статус" — це поле ACTIVE (Y/N) у b_iblock_element. Крім того, існують поля ACTIVE_FROM та ACTIVE_TO — період активності. Якщо поточний час не потрапляє в діапазон, елемент вважається неактивним незалежно від ACTIVE.

Користувацькі статуси (новинка, акція, хіт) — це властивості інфоблока, а не поле ACTIVE. Масова зміна властивостей розглядається нижче.

Масова зміна ACTIVE через D7

Пряме оновлення через ORM — найшвидший спосіб для поля ACTIVE:

$productIds = [1001, 1002, 1003];

foreach (array_chunk($productIds, 100) as $chunk) {
    \Bitrix\Iblock\ElementTable::updateMulti($chunk, ['ACTIVE' => 'N']);
    // Скидання кешу для оновлених елементів
    foreach ($chunk as $id) {
        \Bitrix\Main\Application::getInstance()->getTaggedCache()
            ->clearByTag('iblock_element_' . $id);
    }
}

updateMulti виконує один UPDATE b_iblock_element SET ACTIVE='N' WHERE ID IN (...) — оптимально для MySQL.

Однак пряме оновлення через ORM минає події Бітрікса (OnBeforeIBlockElementUpdate, OnAfterIBlockElementUpdate). Якщо інші модулі підписані на ці події (CRM, пошук, користувацькі обробники), потрібно використовувати CIBlockElement::Update():

foreach ($productIds as $id) {
    \CIBlockElement::Update($id, false, ['ACTIVE' => 'N'], false);
    // 4-й параметр false — без перерахунку прав доступу
}

Відкладена активація за розкладом

Для акційних запусків в конкретний час використовуються поля ACTIVE_FROM / ACTIVE_TO. Не потрібно запускати скрипт о полночі — достатньо задати дати:

\CIBlockElement::Update($productId, false, [
    'ACTIVE'      => 'Y',
    'ACTIVE_FROM' => '01.12.2024 00:00:00',
    'ACTIVE_TO'   => '31.12.2024 23:59:59',
]);

Бітрікс при відображенні в каталогу автоматично враховує поточну дату. Фільтр у компоненті bitrix:catalog.section за замовчуванням включає ACTIVE_DATE = 'Y', що перевіряє потрапляння в діапазон.

Масова зміна користувацьких властивостей-статусів

Властивість типу «Список» (L) — наприклад, «Статус: Новинка / Акція / Хіт» — змінюється через SetPropertyValuesEx. Для масового оновлення:

$enumValues = [];
$enum = \CIBlockPropertyEnum::GetList(
    [],
    ['PROPERTY_ID' => $propertyId, 'VALUE' => 'Акція']
);
if ($enumItem = $enum->Fetch()) {
    $enumValueId = $enumItem['ID'];
}

foreach (array_chunk($productIds, 50) as $chunk) {
    foreach ($chunk as $id) {
        \CIBlockElement::SetPropertyValuesEx($id, $iblockId, [
            'STATUS' => $enumValueId,
        ]);
    }
    usleep(50000);
}

Умовна зміна статусу

Якщо потрібно змінити статус лише для товарів з певними умовами (наприклад, деактивувати всі товари з нульовим залишком), вибірка робиться заздалегідь:

// Знайти товари з нульовим залишком
$zeroStock = \Bitrix\Catalog\ProductTable::getList([
    'filter' => ['QUANTITY' => 0, 'QUANTITY_TRACE' => 'Y'],
    'select' => ['ID', 'IBLOCK_ELEMENT_ID'],
])->fetchAll();

$elementIds = array_column($zeroStock, 'IBLOCK_ELEMENT_ID');

// Деактивувати
foreach (array_chunk($elementIds, 100) as $chunk) {
    \Bitrix\Iblock\ElementTable::updateMulti($chunk, ['ACTIVE' => 'N']);
}

Цей запит виконується за секунди для тисяч товарів проти хвилин при поелементному обході через CIBlockElement::GetList.