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

Другое · 6 мин

Событие в 1С: что это и как работает

Событие в 1С — механизм реакции на действия пользователя и системные изменения в конфигурации. Разберём виды и порядок обработки.

Событие в 1С — это сигнал о наступлении определённого момента в работе информационной базы: открытие формы, изменение реквизита, проведение документа, нажатие кнопки или системное действие платформы. События позволяют встроить собственную логику без изменения ядра системы, подписавшись на нужное происшествие.

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

Разделение на клиентские и серверные события важно: одни обрабатываются на рабочем месте пользователя, другие — на сервере 1С:Предприятия. От места выполнения зависят доступные объекты, права и способы отладки.

Откуда берутся события и где они настраиваются

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

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

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

Виды событий: клиентские, серверные и подписка на события

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

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

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

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

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

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

Напишите код обработчика, используя параметры, которые платформа передаёт автоматически: элемент, данные, стандартная обработка и отказ.

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

Параметры обработчика различаются в зависимости от события: для формы это может быть Элемент, Данные, СтандартнаяОбработка; для документов — Отказ, СтандартнаяОбработка и т. д.

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

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

После добавления обработчика проверьте, что событие срабатывает в нужном режиме: клиентском, серверном или при работе через веб-клиент.

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

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

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

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

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

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

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

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

Соответствует клиентскому или серверному типу события

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

Клиентский код пытается обращаться к серверным объектам без вызова сервера

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

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

Типичные ошибки и что делать, если событие не срабатывает

Частая причина отсутствия реакции — обработчик привязан к форме списка, а действие выполняется в форме элемента, или наоборот.

Другая ошибка — смешение клиентского и серверного контекста: попытка показать сообщение на сервере или изменить данные без вызова сервера на клиенте.

Типичные ошибки
01
Обработчик висит на не той форме, поэтому событие не ловится
02
Клиентский код обращается к серверным объектам без соответствующего вызова

Если событие не срабатывает, проверьте наличие ошибки компиляции, правильность имени обработчика и режим работы приложения.

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

Итог

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

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

Частые вопросы

Можно ли использовать одно событие для нескольких форм?

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

Почему событие не срабатывает после публикации базы?

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

Может ли клиентский обработчик изменять данные напрямую?

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

Что делать, если обработчик вызывает ошибку при проведении документа?

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