Другое · 7 мин
Как перехватить событие формы в 1С и настроить обработчик
Как перехватить событие формы в 1С: где прописать обработчик, чем отличаются клиентские и серверные события, как отменить действие и проверить результат без риска для конфигурации.
В управляемых формах 1С:Предприятия события формы обрабатываются процедурами в модуле формы с именами, совпадающими с именами событий платформы. Чтобы перехватить событие, достаточно объявить процедуру такого же имени и описать нужное действие. Важно выбрать уровень выполнения — клиент или сервер — в зависимости от того, где доступны данные и какие объекты нужно изменить.
Некоторые события позволяют отменить стандартное действие через параметр Отказ, другие — только дополнить логику. Перед правкой уточните, редактируемая конфигурация или используется расширение, и какая версия платформы поддерживает нужный тип формы. Неправильно подобранное место обработки может привести к тому, что код просто не вызовется или выполнится на не том звене.
Где находятся события формы и как они называются
События формы прописываются непосредственно в модуле формы объекта, документа или отчёта. В управляемом приложении это могут быть обработчики открытия, записи, изменения реквизита, активации и деактивации формы, а также внешнего события. Точный набор зависит от типа формы и режима приложения, поэтому полный список лучше смотреть в синтаксис-помощнике для конкретной конфигурации.
Имя процедуры должно совпадать с именем события точно, включая регистр и написание. Если процедура объявлена с опечаткой или с неверным количеством параметров, платформа не свяжет её с событием, и обработчик будет молча игнорироваться. Это самая частая причина того, что «событие не перехватывается».
Проверьте, что вы редактируете модуль именно нужной формы, а не общего модуля
Сверьте с синтаксис-помощником
Определяется свойством процедуры и доступом к данным
Как добавить обработчик события в модуль формы
Откройте конфигурацию в режиме редактирования или создайте расширение, если конфигурация типовая и защищена от изменений. Найдите нужную форму в дереве конфигурации, откройте её модуль и введите процедуру с именем события. После ввода выполните проверку синтаксиса, чтобы платформа не выдала ошибок о несоответствии сигнатуры.
Если форма относится к типовой конфигурации, прямое изменение модуля может быть заблокировано или потеряно при обновлении. Безопаснее использовать расширение конфигурации, если платформа и тип формы позволяют добавить туда обработчик. В противном случае вносите изменения только в копию базы и после тщательного тестирования.
- 1Откройте модуль нужной формы в конфигураторе
- 2Объявите процедуру с именем события и нужными параметрами
- 3Укажите выполнение на клиенте или сервере
- 4Проверьте синтаксис и протестируйте в режиме предприятия
Клиентские и серверные события: где выполнять код
Клиентские процедуры выполняются на рабочей станции пользователя и имеют быстрый доступ к элементам формы, но не могут напрямую обращаться к данным без вызова сервера. Серверные процедуры работают на сервере 1С:Предприятия и подходят для записи в базу, вызова запросов и работы с объектами хранения, но не могут напрямую управлять визуальными элементами формы.
Для процедуры укажите свойство выполнения: на клиенте, на сервере или без контекста. Если код должен изменить форму и записать данные, часто нужна комбинация: клиентский обработчик собирает пользовательский ввод, а серверная процедура выполняет запись. Неправильный выбор уровня выполнения приводит к ошибкам доступа или к отсутствию видимого результата.
Отмена действия и работа с параметрами событий
Некоторые события формы и реквизитов имеют параметр Отказ. Если в обработчике установить Отказ в Истина, платформа может прервать запись, закрытие или другое стандартное действие. Точный список событий с таким параметром и порядок его использования зависят от версии платформы и типа формы.
При обработке изменения реквизита используйте параметры, через которые платформа передаёт элемент, новые данные и признак стандартной обработки. Подавление стандартной обработки может отменить обычное поведение поля, поэтому проверяйте, что форма остаётся рабочей после запрета ввода или автоматической подстановки значения.
Использование расширений и ограничения при изменении типовых конфигураций
Расширение конфигурации позволяет добавлять или переопределять логику без встроенного изменения поставляемой конфигурации. Это предпочтительный путь для типовых решений, но не все события форм доступны для перехвата в расширении в равной мере. Проверьте возможность добавления обработчика именно в выбранном виде расширения.
Если конфигурация нетиповая и открыта для правки, изменения в модуле формы проще, но несут ответственность за совместимость с будущими релизами. Документируйте добавленные процедуры, указывайте причину перехвата события и храните версию конфигурации, в которой проверялась работа.
Проверка результата и частые ошибки
После добавления обработчика запустите режим предприятия и воспроизведите ситуацию, при которой должно сработать событие. Если реакции нет, проверьте имя процедуры, свойство выполнения, наличие ошибок синтаксиса и режим работы конфигурации. В некоторых случаях событие срабатывает только при конкретных действиях пользователя, а не при программном изменении данных.
Частые ошибки: обработчик написан в общем модуле вместо модуля формы, процедура выполнена на клиенте, а данные доступны только на сервере, параметр Отказ установлен в неправильном событии, форма не перекомпилирована после правки. Если стандартный механизм не подходит, можно рассмотреть обработку внешних событий или перехват на уровне команд, но это уже отдельные сценарии с собственными ограничениями.
Что важно запомнить
Перехват события формы в 1С требует точного имени процедуры, правильного уровня выполнения и проверки на рабочей копии или в расширении конфигурации.
Нужно ли всегда править конфигурацию, чтобы перехватить событие?
Не обязательно. Если используется типовая защищенная конфигурация, предпочтительнее оформить обработчик через расширение, если платформа и тип формы это позволяют. Прямая правка типового модуля может быть заблокирована или отменена при обновлении.
Как понять, что обработчик не вызывается из-за имени процедуры?
Если процедура с опечаткой или с неверными параметрами, платформа не привяжет её к событию, и никакой реакции не будет. Сверьте имя и сигнатуру с синтаксис-помощником, после чего проверьте синтаксис и повторите тест.
Можно ли отменить запись документа через событие формы?
В некоторых событиях записи есть параметр Отказ, который позволяет прервать стандартное действие. Точная поддержка зависит от типа формы и версии платформы, поэтому перед использованием проверьте подпись процедуры и поведение в тестовой базе.
Чем отличаются клиентский и серверный обработчик события формы?
Клиентский код работает на компьютере пользователя и удобен для управления элементами формы, серверный — на сервере и подходит для записи и работы с данными. Выбирайте уровень в зависимости от того, какие объекты нужно изменить и где они находятся.
Что делать, если событие срабатывает не в тот момент?
Проверьте, не перепутаны ли события открытия, изменения и записи, а также не влияет ли программное изменение реквизита на вызов обработчика. Иногда нужно разделять действия пользователя и автоматическое заполнение, иначе обработчик может срабатывать дважды или не срабатывать вообще.