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

DataManager

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

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

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

Если новый класс отвечает за доступ к таблице БД, он должен быть наследником класса Bitrix\Main\Entity\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-2019, «1С-Битрикс», 2019
Наверх