method
public
static
RelatedTable::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
Как применяется в RelatedTable
RelatedTable::updateMulti() — метод класса \Bitrix\Tasks\Internals\Task\RelatedTable модуля «Задачи». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_Related, наборы — как EO_Related_Collection. Метод достаётся RelatedTable от DataManager::updateMulti: поведение общее для всех сущностей, а данные, поля и классы — свои.
Записывает одинаковые значения в несколько строк RelatedTable сразу. Подходит для массовых правок — например, снять флаг у группы записей.
use Bitrix\Main\Loader;
use Bitrix\Tasks\Internals\Task\RelatedTable;
Loader::includeModule('tasks');
RelatedTable::updateMulti([1, 2, 3], [
// 'ПОЛЕ' => 'значение' — состав полей см. в getMap()
]);Собственные методы RelatedTable
addInsertIgnore()Добавляет строку в таблицу сущности, подробнее @see DataManager::addaddInsertIgnoreMulti()Добавляет несколько строк в таблицу сущности, подробнее @see DataManager::addMultideleteByFilter()getClass()
updateMulti() есть и у других классов модуля «Задачи»: AccessTable, DependenceTable, ElapsedTimeTable, EventTable, FavoriteTable, LabelTable, MarketingTable, MemberTable.
Исходный файл: source/tasks/lib/internals/task/related.php:1384
