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

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
Наверх