Создать объект новой записи DataManager::createObject

Модуль: main — подключать отдельно не нужно

Метод DataManager::createObject создает объект ORM для новой записи, например EO_User. Сеттеры set* задают значения. Метод save объекта добавляет запись.

Сигнатура метода в классе Bitrix\Main\ORM\Data\DataManager:

final public static function createObject($setDefaultValues = true)

Параметры

Параметр Тип Описание
setDefaultValues bool или array Значение true заполняет поля значениями по умолчанию из configureDefaultValue. Массив поле => значение задает свои значения вместо значений по умолчанию, остальные поля метод заполняет из описания полей. По умолчанию — true

Типы в таблице описывают назначение аргумента. Сигнатура PHP не объявляет их.

Возвращаемое значение

Метод возвращает объект класса из getObjectClass.

Примеры

Пример. Код создает объект, сохраняет его и получает идентификатор. Блок finally удаляет рабочую таблицу:

<?php
use Bitrix\Main\Application;
use Bitrix\Main\ORM\Data\DataManager;
use Bitrix\Main\ORM\Fields\IntegerField;
use Bitrix\Main\ORM\Fields\StringField;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

class DemoUnitTable extends DataManager
{
    public static function getTableName()
    {
        return 'demo_api_units';
    }

    public static function getMap()
    {
        return [
            (new IntegerField('ID'))->configurePrimary()->configureAutocomplete(),
            (new StringField('CODE'))->configureRequired(),
            (new StringField('NAME'))->configureDefaultValue('Unnamed'),
        ];
    }
}

DemoUnitTable::getEntity()->createDbTable();

try
{
    $unit = DemoUnitTable::createObject();
    $unit->setCode('kg');
    $result = $unit->save();

    echo $result->isSuccess() . ' ' . $unit->getId() . ' ' . $unit->getName();
}
finally
{
    Application::getConnection()->dropTable(DemoUnitTable::getTableName());
}

Код выведет 1 1 Unnamed.

Смотрите также