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

Другое · 7 мин

Создание событий и обработчиков в 1С: практическая инструкция

Создание событий в 1С: пошаговая инструкция по подписке на события объектов и форм, проверке обработчиков и распространённым ошибкам при разработке.

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

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

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

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

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

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

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

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

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

Срабатывание обработчика
Норма

Код выполняется при целевом действии

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

Обработчик не вызывает никаких изменений

Отмена записи
Норма

Запись прерывается при ошибке в данных

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

Запись проходит несмотря на некорректные значения

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

Код работает на клиенте и сервере согласно назначению

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

Обработчик не отрабатывает в одном из режимов

Как создать событие объекта в конфигураторе

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

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

События форм управляемого приложения

Открытие формы и инициализация

Для формы создайте обработчик события «ПриОткрытии» или аналогичного, в зависимости от типа формы. В этом обработчике обычно задают начальные значения реквизитов, настраивают доступность команд и элементов, заполняют табличные части. Код в обработчике открытия выполняется перед тем, как пользователь увидит форму.

Перед записью и после записи

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

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

Проверка результата и отладка

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

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

Сравнение вариантов

Событие объекта или формы

Подходит для реакции на конкретное действие пользователя в интерфейсе или при записи данных

Регламентное задание

Подходит для периодических действий, не связанных с конкретным событием ввода

Бизнес-процесс или задача

Подходит для многошаговых сценариев с участием нескольких пользователей

Ограничения и риски при создании событий

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

Альтернативы созданию события

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

Итог

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

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

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

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

В чем разница между событием объекта и событием формы?

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

Нужно ли перезапускать базу после создания события?

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

Что делать, если обработчик события не срабатывает?

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