UtsTasksTaskTable::update()
Сигнатура
public static update(mixed $primary, array<string|int, mixed> $data) : UpdateResult
Описание
Обновляет строку в таблице сущности по первичному ключу
Параметры
$primary
mixed
$data
array<string|int, mixed>
Возвращаемое значение
UpdateResult
Как применяется в UtsTasksTaskTable
UtsTasksTaskTable::update() — метод класса \Bitrix\Tasks\Internals\Task\UtsTasksTaskTable модуля «Задачи». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_UtsTasksTask, наборы — как EO_UtsTasksTask_Collection. Метод достаётся UtsTasksTaskTable от DataManager::update: поведение общее для всех сущностей, а данные, поля и классы — свои.
Изменяет строку UtsTasksTaskTable по первичному ключу: передаются только меняющиеся поля. Как и add(), проходит проверку полей и события.
use Bitrix\Main\Loader;
use Bitrix\Tasks\Internals\Task\UtsTasksTaskTable;
Loader::includeModule('tasks');
$primary = [/* */];
$result = UtsTasksTaskTable::update($primary, [
'VALUE_ID' => 1,
'UF_CRM_TASK' => 'uf_crm_task',
]);
if (!$result->isSuccess()) {
$errors = $result->getErrorMessages();
}Поля сущности UtsTasksTaskTable
| Поле | Тип | Свойства |
|---|---|---|
VALUE_ID | int | обязательное |
UF_CRM_TASK | text | необязательное |
Список — из описания класса в исходном коде; точный состав в вашей версии вернёт UtsTasksTaskTable::getEntity()->getFields().
Другие методы UtsTasksTaskTable
add()Добавляет строку в таблицу сущностиaddMulti()Добавляет несколько строк в таблицу сущности.checkFields()Проверяет поля данных перед сохранением в БД. Результат хранится в объекте $resultcleanCache()Очищает кеш таблета после модификаций данных.createCollection()createObject()cryptoEnabled()Возвращает true, если для поля включено шифрование.delete()Удаляет строку в таблице сущности по первичному ключуenableCrypto()Устанавливает флаг, указывающий на поддержку шифрования для поля.getById()Возвращает выборку по первичному ключу сущностиgetByPrimary()Возвращает выборку по первичному ключу сущности и необязательным параметрам для getList()getCollectionClass()Возвращает класс коллекции объектов для текущей сущности.
update() есть и у других классов модуля «Задачи»: AccessTable, CheckListTable, DependenceTable, ElapsedTimeTable, EventTable, FavoriteTable, LabelTable, MarketingTable.
Исходный файл: source/tasks/lib/internals/task/utstaskstask.php:1256

