IblockMessageTable::update()
Сигнатура
public static update(mixed $primary, array<string|int, mixed> $data) : UpdateResult
Описание
Обновляет строку в таблице сущности по первичному ключу
Параметры
$primary
mixed
$data
array<string|int, mixed>
Возвращаемое значение
UpdateResult
Как применяется в IblockMessageTable
IblockMessageTable::update() — метод класса \Bitrix\Iblock\IblockMessageTable модуля «Информационные блоки». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_IblockMessage, наборы — как EO_IblockMessage_Collection. Метод достаётся IblockMessageTable от DataManager::update: поведение общее для всех сущностей, а данные, поля и классы — свои.
Изменяет строку IblockMessageTable по первичному ключу: передаются только меняющиеся поля. Как и add(), проходит проверку полей и события.
use Bitrix\Main\Loader;
use Bitrix\Iblock\IblockMessageTable;
Loader::includeModule('iblock');
$primary = [/* */];
$result = IblockMessageTable::update($primary, [
'IBLOCK_ID' => 1,
'MESSAGE_ID' => 'message_id',
'MESSAGE_TEXT' => 'message_text',
]);
if (!$result->isSuccess()) {
$errors = $result->getErrorMessages();
}Поля сущности IblockMessageTable
| Поле | Тип | Свойства |
|---|---|---|
IBLOCK_ID | int | обязательное |
MESSAGE_ID | string(50) | обязательное |
MESSAGE_TEXT | string(255) | необязательное |
IBLOCK | reference |
Список — из описания класса в исходном коде; точный состав в вашей версии вернёт IblockMessageTable::getEntity()->getFields().
Собственные методы IblockMessageTable
validateMessageId()Возвращает валидаторы для поля MESSAGE_ID.validateMessageText()Возвращает валидаторы для поля MESSAGE_TEXT.
update() есть и у других классов модуля «Информационные блоки»: ElementTable, IblockFieldTable, IblockGroupTable, IblockRssTable, IblockSiteTable, IblockTable, InheritedPropertyTable, PropertyEnumerationTable.
Исходный файл: source/iblock/lib/iblockmessagetable.php:1256

