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-2025, «1С-Битрикс», 2025