IblockTable::add()
Класс: \Bitrix\Iblock\IblockTable
Сигнатура
public static add(array<string|int, mixed> $data) : AddResult
Описание
Добавляет строку в таблицу сущности
Параметры
$data
array<string|int, mixed>
Возвращаемое значение
AddResult
Как применяется в IblockTable
IblockTable::add() — метод класса \Bitrix\Iblock\IblockTable модуля «Информационные блоки». Это ORM-сущность D7 (наследник DataManager). Метод достаётся IblockTable от DataManager::add: поведение общее для всех сущностей, а данные, поля и классы — свои.
Добавляет строку в таблицу IblockTable. Перед записью ORM проверяет поля (checkFields()) и вызывает события; ошибки возвращаются в результате, исключения не бросаются.
use Bitrix\Main\Loader;
use Bitrix\Iblock\IblockTable;
Loader::includeModule('iblock');
$result = IblockTable::add([
'TIMESTAMP_X' => new \Bitrix\Main\Type\DateTime(),
'IBLOCK_TYPE_ID' => 'iblock_type_id',
'CODE' => 'code',
]);
if ($result->isSuccess()) {
$id = $result->getId();
} else {
$errors = $result->getErrorMessages();
}Поля сущности IblockTable
| Поле | Тип | Свойства |
|---|---|---|
ID | int | обязательное |
TIMESTAMP_X | datetime | |
IBLOCK_TYPE_ID | string(50) | обязательное |
CODE | string(50) | необязательное |
NAME | string(255) | обязательное |
ACTIVE | bool | необязательное, по умолчанию 'Y' |
SORT | int | необязательное, по умолчанию 500 |
LIST_PAGE_URL | string(255) | необязательное |
DETAIL_PAGE_URL | string(255) | необязательное |
SECTION_PAGE_URL | string(255) | необязательное |
CANONICAL_PAGE_URL | string(255) | необязательное |
PICTURE | int | необязательное |
DESCRIPTION | text | необязательное |
DESCRIPTION_TYPE | enum | необязательное, по умолчанию 'text' |
XML_ID | string(255) | необязательное |
TMP_ID | string(40) | необязательное |
INDEX_ELEMENT | bool | необязательное, по умолчанию 'Y' |
INDEX_SECTION | bool | необязательное, по умолчанию 'N' |
WORKFLOW | bool | необязательное, по умолчанию 'Y' |
BIZPROC | bool | необязательное, по умолчанию 'N' |
SECTION_CHOOSER | enum | необязательное, по умолчанию 'L' |
LIST_MODE | enum | необязательное, по умолчанию '' |
RIGHTS_MODE | enum | необязательное, по умолчанию 'S' |
SECTION_PROPERTY | bool | необязательное, по умолчанию 'N' |
PROPERTY_INDEX | enum | необязательное, по умолчанию 'N' |
VERSION | enum | необязательное, по умолчанию 1 |
LAST_CONV_ELEMENT | int | необязательное, по умолчанию 0 |
SOCNET_GROUP_ID | int | необязательное |
EDIT_FILE_BEFORE | string(255) | необязательное |
EDIT_FILE_AFTER | string(255) | необязательное |
TYPE | reference |
Список — из описания класса в исходном коде; точный состав в вашей версии вернёт IblockTable::getEntity()->getFields().
Собственные методы IblockTable
compileAllEntities()compileEntity()resolveIdByCode()Возвращает идентификатор инфоблока по символьному коду. Опционально проверяется привязка к сайту.
add() есть и у других классов модуля «Информационные блоки»: ElementTable, IblockFieldTable, IblockGroupTable, IblockMessageTable, IblockRssTable, IblockSiteTable, InheritedPropertyTable, PropertyEnumerationTable.
Исходный файл: source/iblock/lib/iblocktable.php:877

