method public static

VatTable::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

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

VatTable::checkFields() — метод класса \Bitrix\Catalog\VatTable модуля «Торговый каталог». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_Vat, наборы — как EO_Vat_Collection. Метод достаётся VatTable от DataManager::checkFields: поведение общее для всех сущностей, а данные, поля и классы — свои.

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

use Bitrix\Main\Loader;
use Bitrix\Catalog\VatTable;

Loader::includeModule('catalog');

$result = VatTable::add([
    'TIMESTAMP_X' => new \Bitrix\Main\Type\DateTime(),
    'ACTIVE' => 'Y',
    'SORT' => 1,
]);
foreach ($result->getErrors() as $error) {
    echo $error->getMessage(), PHP_EOL; // в том числе ошибки checkFields()
}

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

Поле	Тип	Свойства
`ID`	`int`	обязательное
`TIMESTAMP_X`	`datetime`	обязательное, по умолчанию 'CURRENT_TIMESTAMP'
`ACTIVE`	`bool`	необязательное, по умолчанию 'Y'
`SORT`	`int`	необязательное, по умолчанию 100
`NAME`	`string(50)`	обязательное
`RATE`	`double`	обязательное, по умолчанию 0.00

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

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

getActiveVatIdByRate() Возвращает ID активной ставки НДС для указанного значения. При необходимости создаёт новую ставку НДС.
getExcludeVatId() Возвращает id исключаемого НДС, если существует.
isExistsExcludeVat() Возвращает true, если существует системный НДС.

checkFields() есть и у других классов модуля «Торговый каталог»: CatalogIblockTable, CatalogViewedProductTable, DiscountCouponTable, DiscountModuleTable, DiscountRestrictionTable, DiscountTable, ExtraTable, GroupAccessTable.

Исходный файл: source/catalog/lib/vat.php:686