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