EntityLabelTable::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
Как применяется в EntityLabelTable
EntityLabelTable::updateMulti() — метод класса \Bitrix\Sale\Internals\EntityLabelTable модуля «Интернет-магазин». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_EntityLabel, наборы — как EO_EntityLabel_Collection. Метод достаётся EntityLabelTable от DataManager::updateMulti: поведение общее для всех сущностей, а данные, поля и классы — свои.
Записывает одинаковые значения в несколько строк EntityLabelTable сразу. Подходит для массовых правок — например, снять флаг у группы записей.
use Bitrix\Main\Loader;
use Bitrix\Sale\Internals\EntityLabelTable;
Loader::includeModule('sale');
EntityLabelTable::updateMulti([1, 2, 3], [
'ENTITY_ID' => 1,
'ENTITY_TYPE' => 'entity_type',
'LABEL_NAME' => 'label_name',
]);Поля сущности EntityLabelTable
| Поле | Тип | Свойства |
|---|---|---|
ID | int | обязательное |
ENTITY_ID | int | обязательное |
ENTITY_TYPE | string(255) | обязательное |
LABEL_NAME | string(255) | обязательное |
LABEL_VALUE | text | необязательное |
Список — из описания класса в исходном коде; точный состав в вашей версии вернёт EntityLabelTable::getEntity()->getFields().
Другие методы EntityLabelTable
add()Добавляет строку в таблицу сущностиaddMulti()Добавляет несколько строк в таблицу сущности.checkFields()Проверяет поля данных перед сохранением в БД. Результат хранится в объекте $resultcleanCache()Очищает кеш таблета после модификаций данных.createCollection()createObject()cryptoEnabled()Возвращает true, если для поля включено шифрование.delete()Удаляет строку в таблице сущности по первичному ключуenableCrypto()Устанавливает флаг, указывающий на поддержку шифрования для поля.getById()Возвращает выборку по первичному ключу сущностиgetByPrimary()Возвращает выборку по первичному ключу сущности и необязательным параметрам для getList()getCollectionClass()Возвращает класс коллекции объектов для текущей сущности.
updateMulti() есть и у других классов модуля «Интернет-магазин»: CashboxRestHandlerTable, DeliveryRestHandlerTable, DiscountCouponTable, DiscountEntitiesTable, DiscountGroupTable, DiscountModuleTable, DiscountTable, PayableItemTable.
Исходный файл: source/sale/lib/internals/entitylabeltable.php:1384

