Журнал категории¶
Вкладка Журнал в настройках категории отображает полный список административных операций над данной категорией с указанием пользователя и времени выполнения.
Что фиксируется¶
В журнале отображаются следующие типы операций:
| Тип операции | Описание |
|---|---|
| Изменение настроек категории | Любое изменение параметров категории: название, описание, маршрут, исполнители, сроки, файлы, уведомления и прочие настройки |
| Изменение статуса | Добавление, изменение или удаление статусов маршрута категории |
| Изменение ДП | Изменение настроек дополнительных параметров: категория-источник, фильтры, отображаемые статусы, колонки таблицы и т.д. |
| Изменение прав доступа | Изменение настроек доступа к категории для пользователей, групп и ролей |
| Изменение локализации | Редактирование локализованных значений объектов категории (названия статусов, ДП и пр.) |
| Удаление объекта | Удаление категории или связанных объектов |
Структура записи¶
Каждая запись журнала содержит:
- Пользователь — кто выполнил операцию
- Дата и время — когда была выполнена операция
- Описание — текстовое описание изменения
Пример записей:
Изменена категория ID=5641: Название='Проекты' → 'Проекты 2024'
Изменена категория ID=5641: Добавлен статус 'На паузе' (ID=2030)
ДП ID=1234 (Проект): изменена категория-источник [Задачи] → [Заявки]
ДП ID=1234 (Проект): изменены отображаемые статусы [В работе, Завершён] → [В работе, На согласовании, Завершён]
Хранение в БД¶
Данные журнала хранятся в таблице dbo.ActionLog. Для просмотра журнала конкретной категории используется фильтрация по SubcatID.
Полный системный журнал всех административных операций (не только по одной категории) доступен в разделе Журналы → Общий.
Структурированное логирование admin-операций¶
Для части операций администрирования журнал действий сохраняет не только текстовое описание, но и структурированное представление операции в формате YAML. Это касается операций, выполняемых через auto-admin и Admin API.
Структурированный лог включает: - тип операции (создание, изменение, удаление); - идентификатор и тип изменённой сущности; - список изменённых полей с предыдущими и новыми значениями.
Пример записи в формате YAML:
operation: Update
entity: ExtParam
id: 1234
changes:
- field: CategorySourceId
old: 5641
new: 5780
- field: DisplayedStates
old: [3500, 3501]
new: [3500, 3501, 3510]
Колонка OperationYaml доступна в представлении vw_ds_LogAction (Автоадминка, Форма 268). Формат YAML выбран для читаемости при просмотре в интерфейсе — в отличие от JSON, YAML не требует парсинга для визуального анализа изменений.