method public static

DiscountTable::checkFields()

Класс: \Bitrix\Sale\Internals\DiscountTable

Сигнатура

public static checkFields(Result $result, mixed $primary, array<string|int, mixed> $data) : mixed

Описание

Проверяет поля данных перед сохранением в БД. Результат хранится в объекте $result

Параметры

$result Result
$primary mixed
$data array<string|int, mixed>

Возвращаемое значение

mixed

Как применяется в DiscountTable

DiscountTable::checkFields() — метод класса \Bitrix\Sale\Internals\DiscountTable модуля «Интернет-магазин». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_Discount, наборы — как EO_Discount_Collection. Метод достаётся DiscountTable от DataManager::checkFields: поведение общее для всех сущностей, а данные, поля и классы — свои.

Проверяет данные перед записью в DiscountTable: обязательные поля, длину, валидаторы из карты. Вызывается внутри add() и update(), ошибки попадают в их результат.

use Bitrix\Main\Loader;
use Bitrix\Sale\Internals\DiscountTable;

Loader::includeModule('sale');

$result = DiscountTable::add([
    'XML_ID' => 'xml_id',
    'LID' => 'lid',
    'NAME' => 'name',
]);
foreach ($result->getErrors() as $error) {
    echo $error->getMessage(), PHP_EOL; // в том числе ошибки checkFields()
}

Поля сущности DiscountTable

ПолеТипСвойства
IDintобязательное
XML_IDstring(255)необязательное
LIDstring(2)обязательное
NAMEstring(255)необязательное
PRICE_FROMfloatнеобязательное
PRICE_TOfloatнеобязательное
CURRENCYstring(3)необязательное
DISCOUNT_VALUEfloatобязательное
DISCOUNT_TYPEstring(1)обязательное, по умолчанию 'P'
ACTIVEboolнеобязательное, по умолчанию 'Y'
SORTintнеобязательное, по умолчанию 100
ACTIVE_FROMdatetimeнеобязательное
ACTIVE_TOdatetimeнеобязательное
TIMESTAMP_Xdatetimeнеобязательное
MODIFIED_BYintнеобязательное
DATE_CREATEdatetimeнеобязательное
CREATED_BYintнеобязательное
PRIORITYintнеобязательное, по умолчанию 1
LAST_DISCOUNTboolнеобязательное, по умолчанию 'Y'
VERSIONintнеобязательное, по умолчанию 3
CONDITIONStextнеобязательное
CONDITIONS_LISTtextнеобязательное
UNPACKtextнеобязательное
ACTIONStextнеобязательное
ACTIONS_LISTtextнеобязательное
APPLICATIONtextнеобязательное
PREDICTION_TEXTtextнеобязательное
PREDICTIONStextнеобязательное
PREDICTIONS_APPtextнеобязательное
USE_COUPONSboolнеобязательное, по умолчанию 'N'
USE_INDEXboolнеобязательное, по умолчанию 'N'
PRESET_IDstringнеобязательное
EXECUTE_MODULEstring(50)обязательное, по умолчанию 'all'
EXECUTE_MODEintпо умолчанию 0
CREATED_BY_USERreference
MODIFIED_BY_USERreference

Список — из описания класса в исходном коде; точный состав в вашей версии вернёт DiscountTable::getEntity()->getFields().

Собственные методы DiscountTable

  • setAllUseCoupons() Устанавливает флаг наличия купонов для всех скидок.
  • setUseCoupons() Установить флаг наличия купонов для списка скидок.
  • validateCurrency() Возвращает валидаторы для поля CURRENCY.
  • validateDiscountType() Возвращает валидаторы для поля DISCOUNT_TYPE.
  • validateExecuteModule() Возвращает валидаторы для поля EXECUTE_MODULE.
  • validateLid() Возвращает валидаторы для поля LID.
  • validateName() Возвращает валидаторы для поля NAME.
  • validatePresetId() Возвращает валидаторы для поля PRESET_ID.
  • validateXmlId() Возвращает валидаторы для поля XML_ID.

checkFields() есть и у других классов модуля «Интернет-магазин»: CashboxRestHandlerTable, DeliveryRestHandlerTable, DiscountCouponTable, DiscountEntitiesTable, DiscountGroupTable, DiscountModuleTable, EntityLabelTable, PayableItemTable.

Исходный файл: source/sale/lib/internals/discount.php:686

Что будем искать? Например,Продвижение