DiscountEntitiesTable::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
Как применяется в DiscountEntitiesTable
DiscountEntitiesTable::checkFields() — метод класса \Bitrix\Sale\Internals\DiscountEntitiesTable модуля «Интернет-магазин». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_DiscountEntities, наборы — как EO_DiscountEntities_Collection. Метод достаётся DiscountEntitiesTable от DataManager::checkFields: поведение общее для всех сущностей, а данные, поля и классы — свои.
Проверяет данные перед записью в DiscountEntitiesTable: обязательные поля, длину, валидаторы из карты. Вызывается внутри add() и update(), ошибки попадают в их результат.
use Bitrix\Main\Loader;
use Bitrix\Sale\Internals\DiscountEntitiesTable;
Loader::includeModule('sale');
$result = DiscountEntitiesTable::add([
'DISCOUNT_ID' => 1,
'MODULE_ID' => 'module_id',
'ENTITY' => 'entity',
]);
foreach ($result->getErrors() as $error) {
echo $error->getMessage(), PHP_EOL; // в том числе ошибки checkFields()
}Поля сущности DiscountEntitiesTable
| Поле | Тип | Свойства |
|---|---|---|
ID | int | обязательное |
DISCOUNT_ID | int | обязательное |
MODULE_ID | string(50) | обязательное |
ENTITY | string(255) | обязательное |
FIELD_ENTITY | string(255) | обязательное |
FIELD_TABLE | string(255) | обязательное |
Список — из описания класса в исходном коде; точный состав в вашей версии вернёт DiscountEntitiesTable::getEntity()->getFields().
Собственные методы DiscountEntitiesTable
deleteByDiscount()Удаляет список сущностей по скидке.getByDiscount()Возвращает сущности по списку скидок.updateByDiscount()Обновляет список сущностей по скидке.validateEntity()Возвращает валидаторы для поля ENTITY.validateFieldEntity()Возвращает валидаторы для поля FIELD_ENTITY.validateFieldTable()Возвращает валидаторы для поля FIELD_TABLE.validateModuleId()Возвращает валидаторы для поля MODULE_ID.
checkFields() есть и у других классов модуля «Интернет-магазин»: CashboxRestHandlerTable, DeliveryRestHandlerTable, DiscountCouponTable, DiscountGroupTable, DiscountModuleTable, DiscountTable, EntityLabelTable, PayableItemTable.
Исходный файл: source/sale/lib/internals/discountentities.php:686

