PropertyEnumerationTable::add()
Сигнатура
public static add(array<string|int, mixed> $data) : AddResult
Описание
Добавляет строку в таблицу сущности
Параметры
$data
array<string|int, mixed>
Возвращаемое значение
AddResult
Как применяется в PropertyEnumerationTable
PropertyEnumerationTable::add() — метод класса \Bitrix\Iblock\PropertyEnumerationTable модуля «Информационные блоки». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_PropertyEnumeration, наборы — как EO_PropertyEnumeration_Collection. Метод достаётся PropertyEnumerationTable от DataManager::add: поведение общее для всех сущностей, а данные, поля и классы — свои.
Добавляет строку в таблицу PropertyEnumerationTable. Перед записью ORM проверяет поля (checkFields()) и вызывает события; ошибки возвращаются в результате, исключения не бросаются.
use Bitrix\Main\Loader;
use Bitrix\Iblock\PropertyEnumerationTable;
Loader::includeModule('iblock');
$result = PropertyEnumerationTable::add([
'PROPERTY_ID' => 1,
'VALUE' => 'value',
'DEF' => 'Y',
]);
if ($result->isSuccess()) {
$id = $result->getId();
} else {
$errors = $result->getErrorMessages();
}Поля сущности PropertyEnumerationTable
| Поле | Тип | Свойства |
|---|---|---|
ID | int | обязательное |
PROPERTY_ID | int | обязательное |
VALUE | string(255) | обязательное |
DEF | bool | необязательное, по умолчанию 'N' |
SORT | int | необязательное, по умолчанию 500 |
XML_ID | string(200) | обязательное |
TMP_ID | string(40) | необязательное |
PROPERTY | reference |
Список — из описания класса в исходном коде; точный состав в вашей версии вернёт PropertyEnumerationTable::getEntity()->getFields().
Собственные методы PropertyEnumerationTable
validateTmpId()Возвращает валидаторы для поля TMP_ID.validateValue()Возвращает валидаторы для поля VALUE.validateXmlId()Возвращает валидаторы для поля XML_ID.
add() есть и у других классов модуля «Информационные блоки»: ElementTable, IblockFieldTable, IblockGroupTable, IblockMessageTable, IblockRssTable, IblockSiteTable, IblockTable, InheritedPropertyTable.
Исходный файл: source/iblock/lib/propertyenumerationtable.php:877

