Документация

Штатные сущности

Список журналируемых сущностей открывается в Сервисы → Журналирование сущностей → Сущности. Сразу после установки он пуст: что журналировать, выбираете вы.

Список сущностей

Три сущности разбираются модулем «из коробки» — для них написаны форматтеры, поэтому значения показываются названиями, а не идентификаторами:

Сущность Класс ORM Что попадает в журнал
Заказы Bitrix\Sale\Internals\OrderTable статус, суммы, оплата, доставка, комментарии
Элементы инфоблоков Bitrix\Iblock\ElementTable товары, новости, статьи — любые элементы
Инфоблоки Bitrix\Iblock\IblockTable настройки самого инфоблока

Готовый разбор значений и включённое журналирование — разные вещи: даже эти три сущности нужно добавить в список, иначе записей не будет.

Что именно ловится

Модуль подписывается на события ORM сущности — добавление, изменение и удаление записи. Журнал не зависит от того, как сделано изменение: правка в админке, вызов старого API вроде CIBlockElement::Update, обмен с 1С или собственный код дают одинаковые записи. Старые классы Битрикса поднимают те же события ORM, поэтому отдельной поддержки для них не требуется.

Исключение — изменения запросами мимо ORM. Прямой UPDATE в базу событий не поднимает, и такое изменение не увидит ни один журнал, включая штатный.

Свойства элементов инфоблока

Отдельно стоит помнить: элемент и его свойства — разные таблицы. Журнал по ElementTable показывает поля самого элемента: название, активность, даты, привязку к разделу. Изменение значения свойства — отдельная сущность, и если она нужна в журнале, её регистрируют так же, как любую другую.