К статье
Практический материал

Другое · 6 мин

Как отследить событие в 1С: практические способы

Отслеживание событий в 1С: журнал регистрации, подписки, обработчики форм и расширенное логирование; выбор способа, проверка прав и тестирование на копии.

Событие в 1С — это зарегистрированное действие пользователя, системное изменение данных или срабатывание обработчика в конфигурации. Отслеживание нужно, когда непонятно, кто и когда изменил документ, почему не сработал регламент или какая форма вызывает ошибку. Способ зависит от вида конфигурации: управляемые формы, обычные формы, тонкий клиент, веб или серверное приложение.

Перед поиском события определите, где оно может возникнуть: на клиенте при открытии формы, на сервере при проведении документа или в общем модуле при вызове процедуры. Разные события видны разными инструментами, поэтому универсальной кнопки «показать все события» нет.

Безопасная отладка начинается с копии информационной базы и проверки прав текущего пользователя. Прямые изменения в рабочей конфигурации без резерва могут привести к потере данных или остановке работы, поэтому сначала воспроизводите ситуацию изолированно.

Что считать событием в 1С и где оно возникает

События делят на пользовательские и системные. Пользовательские — открытие формы, ввод реквизита, проведение документа, нажатие кнопки. Системные — запись в журнал регистрации, срабатывание подписки, начало или конец сеанса, ошибка выполнения запроса.

Место возникновения определяет инструмент. События на клиенте часто ловят обработчики форм, серверные — через модули менеджера и подписки, а изменения данных — через журнал регистрации. Если не знаете сторону выполнения, начните с журнала регистрации как самого широкого источника.

Встроенные способы отслеживания событий

Журнал регистрации

Журнал регистрации фиксирует действия пользователей и изменения объектов, если включена соответствующая настройка. В нём можно увидеть дату, пользователя, объект и тип операции, но не всегда детали внутри формы. Подходит для контроля проведения, записи и удаления документов.

Обработчики форм и команд

Для управляемых и обычных форм существуют события при открытии, перед записью, при изменении реквизита и нажатии команды. Назначение обработчика позволяет перехватить действие в момент возникновения и записать собственное сообщение. Этот способ точнее журнала, но требует доступа к конфигурации и понимания модуля формы.

Событие на формеОбработчик формы

Проверьте модуль формы и событие при открытии или записи

Изменение данныхЖурнал регистрации

Убедитесь, что ведение журнала включено для нужного объекта

Серверное действиеПодписка или модуль менеджера

Посмотрите подписки на события и код серверных процедур

-->

Подписки на события и обработчики форм

Подписки позволяют реагировать на стандартные события конфигурации без изменения основных модулей. Их настраивают в конфигураторе, указывая объект, событие и обработчик. Подходит, когда нужно дополнить стандартное поведение минимальными правками.

Обработчики форм пишутся напрямую в модуле формы: при открытии, перед записью, при изменении. Они удобны для проверки заполнения реквизитов и отмены некорректного действия. Минус — обработчик работает только в том клиенте, где открыта форма, и не видит изменения из других сеансов.

Порядок действий
  1. 1
    Скопируйте рабочую базу в тестовую среду
  2. 2
    Определите объект и событие для отслеживания
  3. 3
    Выберите инструмент: журнал, подписку или обработчик формы
  4. 4
    Настройте обработчик и включите запись при необходимости
  5. 5
    Повторите действие пользователя и проверьте результат

-->

Журнал регистрации и расширенное логирование

Журнал регистрации показывает, кто изменял объект, но часто не показывает значение до и после изменения без дополнительной настройки. Расширенное логирование может фиксировать параметры вызовов и выполнение запросов, однако замедляет работу и создаёт большой объём записей. Включайте его только на время диагностики.

Чтобы найти событие, отфильтруйте журнал по дате, пользователю, объекту и операции. Если записей нет, проверьте права пользователя и настройки ведения журнала для этого объекта. Отсутствие записи не всегда означает отсутствие события; оно может просто не подлежать регистрации.

Порядок самостоятельной настройки и проверка

Сначала воспроизведите целевое действие на тестовой копии и зафиксируйте ожидаемый результат. Затем выберите наименее инвазивный инструмент: журнал регистрации для наблюдения, подписку для реакции, обработчик формы для перехвата в интерфейсе. После настройки повторите действие и сравните запись с ожиданием.

Проверяйте результат в том же режиме, в котором работает пользователь: тонкий клиент, веб или толстый клиент могут показывать разные события. Убедитесь, что у учётной записи есть права на чтение журнала и на запуск обработчика. Если события не фиксируются, проверьте включённость регистрации и фильтры по объекту.

Типичные ошибки
01
Изменение рабочей конфигурации без копии и тестирования
02
Поиск события в журнале без включённого ведения регистрации для объекта
03
Обработка события только на клиенте, хотя изменение произошло на сервере

-->

Частые ошибки и границы безопасной работы

Самая частая ошибка — считать, что каждое действие автоматически записывается в журнал. Регистрация настраивается отдельно, и многие операции по умолчанию не попадают в лог. Другая ошибка — навешивать обработчики на все события подряд, что замедляет систему и затрудняет поиск нужной записи.

Граница безопасной самостоятельной работы — простая настройка журнала, подписки или обработчика формы без изменения структуры конфигурации. Если нужно менять метаданные, общие модули или серверный код, привлекайте разработчика и работайте на копии с резервной копией базы.

Поддержка и повторная проверка

После внесения изменений наблюдайте за системой в течение нескольких рабочих дней. Убедитесь, что журнал не раздулся лишними записями и пользователи не столкнулись с блокировками.

Контрольные точки

Как проверить результат

Запись в журнале регистрации
Норма

Появилась строка с пользователем, объектом и операцией

Тревожный признак

Записи нет или не совпадает пользователь/время

Сработка обработчика формы
Норма

Сообщение или действие выполнилось при целевом событии

Тревожный признак

Обработчик не вызвался или вызвался в неверном клиенте

Работа после настройки
Норма

Пользователи работают без ошибок, журнал не раздувается

Тревожный признак

Медленная работа, ошибки записи, блокировка документов

Периодически перепроверяйте настройки подписок и обработчиков после обновления конфигурации, так как события и имена объектов могут измениться.

-->

Итог

Что важно запомнить

Выбирайте инструмент по месту события, тестируйте на копии, проверяйте права и фильтры журнала, а сложные изменения доверяйте разработчику.

Можно ли отследить событие без доступа к конфигуратору?

Ограниченно: через журнал регистрации, если он включён, и через стандартные отчё