UserTransactTable::checkFields()
Сигнатура
public static checkFields(Result $result, mixed $primary, array<string|int, mixed> $data) : mixed
Описание
Проверяет поля данных перед сохранением в БД. Результат хранится в объекте $result
Параметры
$result
Result
$primary
mixed
$data
array<string|int, mixed>
Возвращаемое значение
mixed
Как применяется в UserTransactTable
UserTransactTable::checkFields() — метод класса \Bitrix\Sale\Internals\UserTransactTable модуля «Интернет-магазин». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_UserTransact, наборы — как EO_UserTransact_Collection. Метод достаётся UserTransactTable от DataManager::checkFields: поведение общее для всех сущностей, а данные, поля и классы — свои.
Проверяет данные перед записью в UserTransactTable: обязательные поля, длину, валидаторы из карты. Вызывается внутри add() и update(), ошибки попадают в их результат.
use Bitrix\Main\Loader;
use Bitrix\Sale\Internals\UserTransactTable;
Loader::includeModule('sale');
$result = UserTransactTable::add([
'USER_ID' => 1,
'TIMESTAMP_X' => new \Bitrix\Main\Type\DateTime(),
'TRANSACT_DATE' => new \Bitrix\Main\Type\DateTime(),
]);
foreach ($result->getErrors() as $error) {
echo $error->getMessage(), PHP_EOL; // в том числе ошибки checkFields()
}Поля сущности UserTransactTable
| Поле | Тип | Свойства |
|---|---|---|
ID | int | обязательное |
USER_ID | int | обязательное |
TIMESTAMP_X | datetime | необязательное, по умолчанию current |
TRANSACT_DATE | datetime | обязательное |
AMOUNT | double | необязательное, по умолчанию 0.0000 |
CURRENCY | string(3) | обязательное |
DEBIT | bool | необязательное, по умолчанию 'N' |
ORDER_ID | int | необязательное |
DESCRIPTION | string(255) | обязательное |
NOTES | text | необязательное |
PAYMENT_ID | int | необязательное |
EMPLOYEE_ID | int | необязательное |
Список — из описания класса в исходном коде; точный состав в вашей версии вернёт UserTransactTable::getEntity()->getFields().
Другие методы UserTransactTable
add()Добавляет строку в таблицу сущностиaddMulti()Добавляет несколько строк в таблицу сущности.cleanCache()Очищает кеш таблета после модификаций данных.createCollection()createObject()cryptoEnabled()Возвращает true, если для поля включено шифрование.delete()Удаляет строку в таблице сущности по первичному ключуenableCrypto()Устанавливает флаг, указывающий на поддержку шифрования для поля.getById()Возвращает выборку по первичному ключу сущностиgetByPrimary()Возвращает выборку по первичному ключу сущности и необязательным параметрам для getList()getCollectionClass()Возвращает класс коллекции объектов для текущей сущности.getCollectionClassName()Возвращает имя класса (без пространства имён) коллекции объектов для текущей сущности.
checkFields() есть и у других классов модуля «Интернет-магазин»: CashboxRestHandlerTable, DeliveryRestHandlerTable, DiscountCouponTable, DiscountEntitiesTable, DiscountGroupTable, DiscountModuleTable, DiscountTable, EntityLabelTable.
Исходный файл: source/sale/lib/internals/usertransacttable.php:686

