ProductTable::checkFields()
Класс: \Bitrix\Catalog\ProductTable
Сигнатура
public static checkFields(Result $result, mixed $primary, array<string|int, mixed> $data) : mixed
Описание
Проверяет поля данных перед сохранением в БД. Результат хранится в объекте $result
Параметры
$result
Result
$primary
mixed
$data
array<string|int, mixed>
Возвращаемое значение
mixed
Как применяется в ProductTable
ProductTable::checkFields() — метод класса \Bitrix\Catalog\ProductTable модуля «Торговый каталог». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_Product, наборы — как EO_Product_Collection. Метод достаётся ProductTable от DataManager::checkFields: поведение общее для всех сущностей, а данные, поля и классы — свои.
Проверяет данные перед записью в ProductTable: обязательные поля, длину, валидаторы из карты. Вызывается внутри add() и update(), ошибки попадают в их результат.
use Bitrix\Main\Loader;
use Bitrix\Catalog\ProductTable;
Loader::includeModule('catalog');
$result = ProductTable::add([
'QUANTITY' => 1.5,
'QUANTITY_TRACE' => 'Y',
'WEIGHT' => 1.5,
]);
foreach ($result->getErrors() as $error) {
echo $error->getMessage(), PHP_EOL; // в том числе ошибки checkFields()
}Поля сущности ProductTable
| Поле | Тип | Свойства |
|---|---|---|
ID | int | обязательное |
QUANTITY | double | обязательное |
QUANTITY_TRACE | bool | необязательное, по умолчанию 'N' |
WEIGHT | double | обязательное |
TIMESTAMP_X | datetime | обязательное, по умолчанию 'CURRENT_TIMESTAMP' |
PRICE_TYPE | string(1) | обязательное, по умолчанию 'S' |
RECUR_SCHEME_LENGTH | int | необязательное |
RECUR_SCHEME_TYPE | string(1) | обязательное, по умолчанию 'D' |
TRIAL_PRICE_ID | int | необязательное |
WITHOUT_ORDER | bool | необязательное, по умолчанию 'N' |
SELECT_BEST_PRICE | bool | необязательное, по умолчанию 'Y' |
VAT_ID | int | необязательное |
VAT_INCLUDED | bool | необязательное, по умолчанию 'Y' |
CAN_BUY_ZERO | bool | необязательное, по умолчанию 'N' |
NEGATIVE_AMOUNT_TRACE | string(1) | обязательное, по умолчанию 'D' |
TMP_ID | string(40) | необязательное |
PURCHASING_PRICE | double | необязательное |
PURCHASING_CURRENCY | string(3) | необязательное |
BARCODE_MULTI | bool | необязательное, по умолчанию 'N' |
QUANTITY_RESERVED | double | необязательное |
SUBSCRIBE | string(1) | необязательное |
WIDTH | double | необязательное |
LENGTH | double | необязательное |
HEIGHT | double | необязательное |
MEASURE | int | необязательное |
TYPE | int | необязательное |
AVAILABLE | string(1) | необязательное |
BUNDLE | string(1) | необязательное |
IBLOCK_ELEMENT | reference | |
TRIAL_IBLOCK_ELEMENT | reference | |
TRIAL_PRODUCT | reference |
Список — из описания класса в исходном коде; точный состав в вашей версии вернёт ProductTable::getEntity()->getFields().
Собственные методы ProductTable
calculateAvailable()Рассчитать доступность для товара.clearProductCache()Очистить кеш товара.getCurrentRatioWithMeasure()Возвращает коэффициент и единицу измерения для товаров.getDefaultAvailableSettings()Вернуть настройки доступности по умолчанию.getPaymentPeriods()Вернуть список периодов оплаты.getPaymentTypes()Вернуть список типов оплаты.getProductTypes()Вернуть список типов товаров.getStoreDocumentRestrictedProductTypes()Возвращает типы товаров, которые не поддерживаются и/или неактуальны в управлении складом.getTradingEntityNameByType()isExistProduct()Вернуть, существует ли товар.isNeedCheckQuantity()Возвращает true, если необходимо проверять максимальное количество товара.
checkFields() есть и у других классов модуля «Торговый каталог»: CatalogIblockTable, CatalogViewedProductTable, DiscountCouponTable, DiscountModuleTable, DiscountRestrictionTable, DiscountTable, ExtraTable, GroupAccessTable.
Исходный файл: source/catalog/lib/product.php:686

