Документация для разработчиков
Темная тема

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.



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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх