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