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

Другое · 8 мин

Обработчики событий в 1С: где они находятся и как их найти

Где искать обработчики событий в 1С: модули форм и объектов, общие модули, подписки на события, различия клиент/сервер и способы проверки.

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

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

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

Обработчики событий форм

Для событий формы обработчик располагается в модуле этой формы. Это может быть модуль формы документа, справочника, отчета или обработки. Типичные процедуры: ПриОткрытии, ПриЗаписи, ПриУдалении, ОбработкаВнешнегоСобытия, обработчики команд формы. В управляемых формах код может находиться в клиентском, серверном или общем модуле формы в зависимости от назначения процедуры.

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

Как найти обработчик формы
  1. 1
    Откройте конфигурацию и найдите нужную форму в дереве объектов
  2. 2
    Перейдите к модулю формы и найдите процедуру с именем события
  3. 3
    Проверьте свойства команды или элемента управления на наличие указанного обработчика
  4. 4
    Запустите режим отладки и убедитесь, что процедура вызывается при нужном действии

Различие клиентского и серверного выполнения

Процедура, помеченная как «На сервере», не будет выполнена на клиенте, даже если событие произошло в интерфейсе. Клиентские процедуры не имеют доступа к некоторым серверным ресурсам без вызова серверного метода. Поэтому при поиске причины отсутствия реакции на событие сначала проверяйте контекст выполнения процедуры.

Обработчики событий объектов конфигурации

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

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

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

Подписки на события и бизнес-события

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

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

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

Командные и внешние обработчики

Команды интерфейса, кнопки и элементы управления имеют собственные обработчики, которые могут находиться в модуле команды, модуле формы или общем модуле. Внешние события, например приход данных по HTTP или взаимодействие через COM, обрабатываются специальными процедурами внешних компонент или веб-сервисов. Их место определяется типом подключения и настройками интеграции.

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

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

Как найти и проверить обработчик

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

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

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

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

Процедура найдена в нужном модуле
Норма

Имя и сигнатура соответствуют событию

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

Процедура отсутствует или имеет неправильные параметры

Подписка на событие активна
Норма

Событие вызывает обработчик при тестировании

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

Подписка отключена или не соответствует объекту

Контекст выполнения
Норма

Клиентская или серверная процедура запускается в нужном режиме

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

Процедура не вызывается из-за несоответствия клиента или сервера

Ограничения и безопасная работа

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

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

Итог

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

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

Где искать, если обработчик не виден в модуле объекта?

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

Почему обработчик существует, но не срабатывает?

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

Можно ли править обработчик прямо в информационной базе?

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

Чем отличается обработчик формы от обработчика объекта?

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