Обработчик события в 1С: что это и как с ним работать

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

Такой подход называется событийно-ориентированным программированием. Вместо линейного сценария «сделай шаг 1, потом шаг 2» вы реагируете на действия пользователя и системные процессы. Например, при записи документа «Реализация товаров» платформа вызывает обработчик ПередЗаписью, где можно проверить заполнение реквизитов и отказаться от записи, если данные некорректны.

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

Что такое событие и обработчик: базовая модель

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

Обработчик — это привязанный к событию код. Связь устанавливается двумя способами: через свойство объекта в конфигураторе (для форм и элементов) или по совпадению имени процедуры в модуле объекта (для событий вроде ПередЗаписью, ОбработкаПроведения). Во втором случае платформа ищет в модуле процедуру с зарезервированным именем и вызывает её.

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

Где находятся события: формы, объекты, приложение

События сгруппированы по месту возникновения. Основные группы:

• События формы — ПриСозданииНаСервере, ПриОткрытии, ПередЗакрытием. Назначаются в палитре свойств формы.
• События элементов формы — Нажатие для кнопки, ПриИзменении для поля ввода, Выбор для таблицы.
• События прикладных объектов — ПередЗаписью, ПриЗаписи, ОбработкаПроведения, ОбработкаЗаполнения. Размещаются в модуле объекта.
• События приложения — ПриНачалеРаботыСистемы, ПередЗавершениемРаботыСистемы. Пишутся в модуле управляемого приложения.

Чтобы увидеть доступные события формы, откройте форму в конфигураторе, вызовите палитру свойств и перейдите на вкладку «События». Рядом с каждым событием есть кнопка с лупой — она создаёт заготовку обработчика в модуле формы с правильной сигнатурой.

Для прикладных объектов (справочников, документов) список событий смотрите в синтакс-помощнике: ветка «Прикладные объекты» → нужный тип → «События». Там же описаны параметры каждого обработчика и момент его вызова.

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

Стандартный путь для формы: откройте форму → палитра свойств → вкладка «События» → найдите нужное событие → нажмите кнопку с лупой в поле значения. Конфигуратор создаст пустую процедуру в модуле формы и привяжет её к событию.

Для событий объекта (например, ОбработкаПроведения документа) откройте модуль объекта и напишите процедуру с точным зарезервированным именем. Платформа найдёт её автоматически — отдельная привязка не нужна.

1. 1
   Откройте форму в конфигураторе и добавьте кнопку в дерево элементов
2. 2
   Выделите кнопку, откройте палитру свойств, найдите событие «Нажатие»
3. 3
   Нажмите кнопку с лупой — платформа создаст процедуру в модуле формы
4. 4
   Добавьте в процедуру директиву &НаКлиенте (если её нет) и напишите код действия
5. 5
   Обновите конфигурацию базы данных и проверьте работу в режиме предприятия

Пример простого обработчика в модуле формы:

&НаКлиенте
Процедура КнопкаПроверитьНажатие(Элемент)
Если Не ЗначениеЗаполнено(Объект.Контрагент) Тогда
Сообщить("Не выбран контрагент");
Возврат;
КонецЕсли;
Сообщить("Проверка пройдена");
КонецПроцедуры

&НаКлиенте
Процедура КонтрагентПриИзменении(Элемент)
    Объект.Договор = ПолучитьОсновнойДоговор(Объект.Контрагент);
КонецПроцедуры

Клиент и сервер: где выполняется обработчик

В управляемом приложении код формы разделён на клиентскую и серверную части. Директивы &НаКлиенте, &НаСервере, &НаСервереБезКонтекста определяют, где выполняется процедура. События формы тоже привязаны к контексту: ПриСозданииНаСервере выполняется на сервере, ПриОткрытии — на клиенте.

Из клиентского обработчика нельзя напрямую обратиться к базе данных — только через вызов серверной процедуры. Попытка выполнить запрос в &НаКлиенте даст ошибку компиляции. Обратная ситуация: из серверного обработчика нельзя показать пользователю предупреждение или открыть форму — методы интерфейса доступны только на клиенте.

Параметры событий: Отказ, СтандартнаяОбработка и другие

Многие события передают в обработчик служебные параметры, через которые можно управлять поведением платформы:

• Отказ — установите Истина, чтобы прервать действие (например, запретить запись документа).
• СтандартнаяОбработка — установите Ложь, чтобы подменить типовое поведение собственным (например, открыть свою форму выбора вместо стандартной).
• РежимЗаписи, РежимПроведения — в событиях документа показывают, что именно делает пользователь.
• Элемент, ВыбраннаяСтрока — в событиях элементов формы указывают источник события и контекст.

Типичный сценарий — проверка в ПередЗаписью:

Процедура ПередЗаписью(Отказ, РежимЗаписи, РежимПроведения)
Если РежимЗаписи = РежимЗаписиДокумента.Проведение
И Товары.Количество() = 0 Тогда
Отказ = Истина;
Сообщить("Нельзя провести документ без товаров");
КонецЕсли;
КонецПроцедуры

Подписки на события: обработка без изменения типового кода

Подписка на событие — это механизм, позволяющий назначить свой обработчик на событие объекта (например, ПередЗаписью документа) без изменения модуля самого объекта. Подписки создаются в ветке «Общие» → «Подписки на события»: указывается источник (типы объектов), событие и процедура-обработчик в общем модуле.

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

Типичные ошибки при работе с обработчиками

Большинство проблем с обработчиками сводится к нескольким повторяющимся причинам. Знание списка экономит часы отладки.

Отдельная ловушка — порядок вызова событий. Например, при проведении документа последовательность примерно такая: ПередЗаписью → запись в базу → ПриЗаписи → ОбработкаПроведения. Если логика опирается на неверное предположение о порядке (скажем, в ОбработкаПроведения ждут данных, которые заполняются в ПриЗаписи), поведение будет непредсказуемым. Точную последовательность для конкретного объекта проверяйте в синтакс-помощнике или отладчиком.

FAQ