DiscountEntitiesTable::updateMulti()
Сигнатура
public static updateMulti(array<string|int, mixed> $primaries, array<string|int, mixed> $data[, bool $ignoreEvents = false ]) : UpdateResult
Параметры
$primaries
array<string|int, mixed>
$data
array<string|int, mixed>
$ignoreEvents
bool
= false
Возвращаемое значение
UpdateResult
Как применяется в DiscountEntitiesTable
DiscountEntitiesTable::updateMulti() — метод класса \Bitrix\Sale\Internals\DiscountEntitiesTable модуля «Интернет-магазин». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_DiscountEntities, наборы — как EO_DiscountEntities_Collection. Метод достаётся DiscountEntitiesTable от DataManager::updateMulti: поведение общее для всех сущностей, а данные, поля и классы — свои.
Записывает одинаковые значения в несколько строк DiscountEntitiesTable сразу. Подходит для массовых правок — например, снять флаг у группы записей.
use Bitrix\Main\Loader;
use Bitrix\Sale\Internals\DiscountEntitiesTable;
Loader::includeModule('sale');
DiscountEntitiesTable::updateMulti([1, 2, 3], [
'DISCOUNT_ID' => 1,
'MODULE_ID' => 'module_id',
'ENTITY' => 'entity',
]);Поля сущности DiscountEntitiesTable
| Поле | Тип | Свойства |
|---|---|---|
ID | int | обязательное |
DISCOUNT_ID | int | обязательное |
MODULE_ID | string(50) | обязательное |
ENTITY | string(255) | обязательное |
FIELD_ENTITY | string(255) | обязательное |
FIELD_TABLE | string(255) | обязательное |
Список — из описания класса в исходном коде; точный состав в вашей версии вернёт DiscountEntitiesTable::getEntity()->getFields().
Собственные методы DiscountEntitiesTable
deleteByDiscount()Удаляет список сущностей по скидке.getByDiscount()Возвращает сущности по списку скидок.updateByDiscount()Обновляет список сущностей по скидке.validateEntity()Возвращает валидаторы для поля ENTITY.validateFieldEntity()Возвращает валидаторы для поля FIELD_ENTITY.validateFieldTable()Возвращает валидаторы для поля FIELD_TABLE.validateModuleId()Возвращает валидаторы для поля MODULE_ID.
updateMulti() есть и у других классов модуля «Интернет-магазин»: CashboxRestHandlerTable, DeliveryRestHandlerTable, DiscountCouponTable, DiscountGroupTable, DiscountModuleTable, DiscountTable, EntityLabelTable, PayableItemTable.
Исходный файл: source/sale/lib/internals/discountentities.php:1384

