PropertyTable::checkFields()
Класс: \Bitrix\Iblock\PropertyTable
Сигнатура
public static checkFields(Result $result, mixed $primary, array<string|int, mixed> $data) : mixed
Описание
Проверяет поля данных перед сохранением в БД. Результат хранится в объекте $result
Параметры
$result
Result
$primary
mixed
$data
array<string|int, mixed>
Возвращаемое значение
mixed
Как применяется в PropertyTable
PropertyTable::checkFields() — метод класса \Bitrix\Iblock\PropertyTable модуля «Информационные блоки». Это ORM-сущность D7 (наследник DataManager). Метод достаётся PropertyTable от DataManager::checkFields: поведение общее для всех сущностей, а данные, поля и классы — свои.
Проверяет данные перед записью в PropertyTable: обязательные поля, длину, валидаторы из карты. Вызывается внутри add() и update(), ошибки попадают в их результат.
use Bitrix\Main\Loader;
use Bitrix\Iblock\PropertyTable;
Loader::includeModule('iblock');
$result = PropertyTable::add([
'TIMESTAMP_X' => new \Bitrix\Main\Type\DateTime(),
'IBLOCK_ID' => 1,
'NAME' => 'name',
]);
foreach ($result->getErrors() as $error) {
echo $error->getMessage(), PHP_EOL; // в том числе ошибки checkFields()
}Поля сущности PropertyTable
| Поле | Тип | Свойства |
|---|---|---|
ID | int | обязательное |
TIMESTAMP_X | datetime | обязательное, по умолчанию 'CURRENT_TIMESTAMP' |
IBLOCK_ID | int | обязательное |
NAME | string(255) | обязательное |
ACTIVE | bool | необязательное, по умолчанию 'Y' |
SORT | int | необязательное, по умолчанию 500 |
CODE | string(50) | необязательное |
DEFAULT_VALUE | text | необязательное |
PROPERTY_TYPE | enum | необязательное, по умолчанию 'S' |
ROW_COUNT | int | необязательное, по умолчанию 1 |
COL_COUNT | int | необязательное, по умолчанию 30 |
LIST_TYPE | enum | необязательное, по умолчанию 'L' |
MULTIPLE | bool | необязательное, по умолчанию 'N' |
XML_ID | string(100) | необязательное |
FILE_TYPE | string(200) | необязательное |
MULTIPLE_CNT | int | необязательное |
TMP_ID | string(40) | необязательное |
LINK_IBLOCK_ID | int | необязательное |
WITH_DESCRIPTION | bool | необязательное, по умолчанию 'N' |
SEARCHABLE | bool | необязательное, по умолчанию 'N' |
FILTRABLE | bool | необязательное, по умолчанию 'N' |
IS_REQUIRED | bool | необязательное, по умолчанию 'N' |
VERSION | enum | необязательное, по умолчанию 1 |
USER_TYPE | string(255) | необязательное |
USER_TYPE_SETTINGS | string | необязательное |
HINT | string(255) | необязательное |
LINK_IBLOCK | reference | |
IBLOCK | reference |
Список — из описания класса в исходном коде; точный состав в вашей версии вернёт PropertyTable::getEntity()->getFields().
Собственные методы PropertyTable
defaultValueFetchModifier()Модификатор выборки для значения по умолчанию пользовательского типа из старого ядра инфоблоков.fillOldCoreFetchModifiers()Добавляет модификаторы выборки для эмуляции старого ядра инфоблоков.userTypeSettingsFetchModifer()Модификатор выборки для настроек пользовательского типа из старого ядра инфоблоков.
checkFields() есть и у других классов модуля «Информационные блоки»: ElementTable, IblockFieldTable, IblockGroupTable, IblockMessageTable, IblockRssTable, IblockSiteTable, IblockTable, InheritedPropertyTable.
Исходный файл: source/iblock/lib/propertytable.php:686

