DataManager

Описание

DataManager - абстрактный базовый класс для работы с объектами данных.

Обращается к пространству имён:

Класс загружает языковые фразы для текущего скрипта: Loc::loadMessages(__FILE__).

Если новый класс отвечает за доступ к таблице БД, он должен быть наследником класса Bitrix\Main\Entity\DataManager Класс является алиасом класса Bitrix\Main\ORM\Data\DataManager и должен переопределять только два метода:

getTableName для получения имени таблицы,
getMap для получения массива колонок таблицы - объектов Bitrix\Main\Entity\Field.

Методы

Метод	Описание	С версии
add	Метод добавляет строку в таблицу сущностей.
checkFields	Метод проверяет поля данных перед записью в БД.
delete	Метод удаляет строку в таблице сущности по первичному ключу.
getById	Метод возвращает выборку по первичному ключу сущности.
getByPrimary	Метод возвращает выборку по первичному ключу сущности и по опциональным параметрам `\Bitrix\Main\Entity\DataManager::getList`.
getConnectionName	Метод возвращает имя соединения для сущности.	12.0.9
getCount	Метод выполняет COUNT запрос к сущности и возвращает результат.	12.0.10
getEntity	Метод возвращает объект сущности.
getList	Метод выполняет запрос и возвращает отобранные по параметрам запроса данные.
getMap	Метод возвращает описание карты сущностей.	12.0.7
getRow	Метод возвращает одну строку (или null) по параметрам для `\Bitrix\Main\Entity\DataManager::getList`.
getRowById	Метод возвращает строку (или null) по первичному ключу сущности.	14.0.0
getTableName	Метод возвращает имя таблицы БД для сущности.	12.0.7
query	Метод создаёт и возвращает объект запроса для сущности.
update	Метод обновляет строку в таблице объекта по первичному ключу.
enableCrypto	Метод устанавливает флаг поддержки шифрования для поля.	17.5.14
cryptoEnabled	Метод возвращает true если шифрование разрешено для поля.	17.5.14

События

Событие	Описание
События добавления
OnBeforeAdd	параметры: fields
OnAdd	параметры: fields
OnAfterAdd	параметры: fields, primary
События изменения
OnBeforeUpdate	параметры: primary, fields
OnUpdate	параметры: primary, fields
OnAfterUpdate	параметры: primary, fields
События удаления
OnBeforeDelete	параметры: primary
OnDelete	параметры: primary
OnAfterDelete	параметры: primary

Подробнее о событиях в курсе Разработчик Bitrix Framework.

Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.

Наверх