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

Другое · 9 мин

Обработчик в 1С: что это, где создаётся и как работает

Что такое обработчик в 1С, где он создаётся, как работает на клиенте и сервере, какие параметры получает и как проверить, что код сработал корректно.

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

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

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

Что такое обработчик и зачем он нужен

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

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

Где создаются обработчики: формы, модули, подписки

Самый частый способ создать обработчик — модуль формы. В управляемых формах это процедуры, привязанные к событиям формы, команд или элементов управления. Например, обработчик события «ПриОткрытии» формы выполняется при открытии окна, а «ПриИзменении» реквизита — когда пользователь меняет значение в поле.

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

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

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

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

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

Место размещенияМодуль формы, модуль объекта или подписка на событие

Определяет, в каком контексте будет выполняться код и какие данные доступны

Тип событияОткрытие, изменение, запись, проведение, удаление

Указывает, в какой момент платформа вызовет обработчик

Место выполненияКлиент или сервер

Влияет на доступ к данным, скорость и права доступа

Если в обработчике нужно и показать сообщение пользователю, и изменить данные в базе, часто используют комбинацию: клиентская часть собирает параметры и вызывает серверную процедуру, а серверная часть выполняет запись и возвращает результат. Неправильное разделение между клиентом и сервером — частая причина ошибок «Метод не найден» или доступа к закрытому реквизиту.

Параметры контекста и отмена события

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

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

Как отлаживать и проверять срабатывание

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

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

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

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

Появилось ли сообщение или запись в начале обработчика
Норма

Сообщение отображается, запись создана

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

Никакой реакции — обработчик не вызван

Изменились ли данные после события
Норма

Реквизит заполнен, документ проведён или отменён

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

Данные остались прежними, логика не сработала

Отображается ли ошибка при отмене события
Норма

Понятный текст с указанием поля

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

Тихая отказ без объяснения

Типичные ошибки и ограничения

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

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

Типичные ошибки
01
Изменение реквизита формы из серверного кода без обновления клиента — пользователь не видит результат
02
Обработчик записи вызывает запись того же объекта — возможна рекурсия и зависание
03
Блокировка события без сообщения пользователю — выглядит как сбой программы

Безопасная правка и откат изменений

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

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

Итог

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

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

Часто задаваемые вопросы

Может ли один обработчик работать на нескольких формах?

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

Нужно ли перезапускать 1С после изменения обработчика?

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

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

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

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

Да, если в параметрах события есть признак отказа и обработчик устанавливает его в значение «Истина». В этом случае платформа отменяет запись, поэтому всегда сопровождайте отказ понятным сообщением для пользователя.

Отличается ли обработчик на клиенте и на сервере?

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