SectionTable::add()
Класс: \Bitrix\Iblock\SectionTable
Сигнатура
public static add(array<string|int, mixed> $data) : AddResult
Описание
Добавляет строку в таблицу сущности
Параметры
$data
array<string|int, mixed>
Возвращаемое значение
AddResult
Как применяется в SectionTable
SectionTable::add() — метод класса \Bitrix\Iblock\SectionTable модуля «Информационные блоки». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_Section, наборы — как EO_Section_Collection. Метод достаётся SectionTable от DataManager::add: поведение общее для всех сущностей, а данные, поля и классы — свои.
Добавляет строку в таблицу SectionTable. Перед записью ORM проверяет поля (checkFields()) и вызывает события; ошибки возвращаются в результате, исключения не бросаются.
use Bitrix\Main\Loader;
use Bitrix\Iblock\SectionTable;
Loader::includeModule('iblock');
$result = SectionTable::add([
'TIMESTAMP_X' => new \Bitrix\Main\Type\DateTime(),
'MODIFIED_BY' => 1,
'DATE_CREATE' => new \Bitrix\Main\Type\DateTime(),
]);
if ($result->isSuccess()) {
$id = $result->getId();
} else {
$errors = $result->getErrorMessages();
}Поля сущности SectionTable
| Поле | Тип | Свойства |
|---|---|---|
ID | int | обязательное |
TIMESTAMP_X | datetime | обязательное, по умолчанию 'CURRENT_TIMESTAMP' |
MODIFIED_BY | int | необязательное |
DATE_CREATE | datetime | необязательное |
CREATED_BY | int | необязательное |
IBLOCK_ID | int | обязательное |
IBLOCK_SECTION_ID | int | необязательное |
ACTIVE | bool | необязательное, по умолчанию 'Y' |
GLOBAL_ACTIVE | bool | необязательное, по умолчанию 'Y' |
SORT | int | необязательное, по умолчанию 500 |
NAME | string(255) | обязательное |
PICTURE | int | необязательное |
LEFT_MARGIN | int | необязательное |
RIGHT_MARGIN | int | необязательное |
DEPTH_LEVEL | int | необязательное |
DESCRIPTION | string | необязательное |
DESCRIPTION_TYPE | enum | необязательное, по умолчанию 'text' |
SEARCHABLE_CONTENT | string | необязательное |
CODE | string(255) | необязательное |
XML_ID | string(255) | необязательное |
TMP_ID | string(40) | необязательное |
DETAIL_PICTURE | int | необязательное |
SOCNET_GROUP_ID | int | необязательное |
IBLOCK | reference | |
PARENT_SECTION | reference | |
CREATED_BY_USER | reference | |
MODIFIED_BY_USER | reference |
Список — из описания класса в исходном коде; точный состав в вашей версии вернёт SectionTable::getEntity()->getFields().
Другие методы SectionTable
addMulti()Добавляет несколько строк в таблицу сущности.checkFields()Проверяет поля данных перед сохранением в БД. Результат хранится в объекте $resultcleanCache()Очищает кеш таблета после модификаций данных.createCollection()createObject()cryptoEnabled()Возвращает true, если для поля включено шифрование.delete()Удаляет строку в таблице сущности по первичному ключуenableCrypto()Устанавливает флаг, указывающий на поддержку шифрования для поля.getById()Возвращает выборку по первичному ключу сущностиgetByPrimary()Возвращает выборку по первичному ключу сущности и необязательным параметрам для getList()getCollectionClass()Возвращает класс коллекции объектов для текущей сущности.getCollectionClassName()Возвращает имя класса (без пространства имён) коллекции объектов для текущей сущности.
add() есть и у других классов модуля «Информационные блоки»: ElementTable, IblockFieldTable, IblockGroupTable, IblockMessageTable, IblockRssTable, IblockSiteTable, IblockTable, InheritedPropertyTable.
Исходный файл: source/iblock/lib/sectiontable.php:877

