Почему не срабатывает перехват процедуры формы в расширении 1С и как это исправить?

← На главную

При разработке расширений конфигурации в 1С:Предприятии 8.3 программисты часто сталкиваются с ситуацией, когда добавленный метод с аннотациями &Перед, &После или &Вместо не вызывается платформой, а точка останова в коде расширения упорно игнорируется. Особенно часто эта проблема возникает при попытке доработать логику работы управляемых форм, например, при фискализации чеков или отправке SMS-уведомлений покупателям.

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

Причина 1: Несовпадение контекста выполнения (директивы компиляции)

Проанализируем исходный код, вызвавший проблему:


&После("ПробитьЧек")
Процедура Расш1_ПробитьЧек()
    Сообщить("УРА!");
КонецПроцедуры

Если в модуле формы перед объявлением процедуры не указана явная директива компиляции, платформа по умолчанию может скомпилировать процедуру на сервере (&НаСервере) в зависимости от контекста модуля. В то же время типовая процедура ПробитьЧек в модуле формы документа является обработчиком команды и выполняется исключительно на клиенте (директива &НаКлиенте).

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

Для исправления ситуации необходимо явно объявить директиву &НаКлиенте:


&НаКлиенте
&После("ПробитьЧек")
Процедура Расш1_ПробитьЧек(Команда)
    // Код расширения
    Сообщить("УРА!");
КонецПроцедуры

Причина 2: Несовпадение сигнатуры (списка параметров) процедуры

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

Посмотрим на типовую реализацию: процедура ПробитьЧек в модуле формы документа «Чек ККМ» является обработчиком нажатия кнопки и принимает один параметр — Команда. Если объявить перехватывающий метод без параметров (Процедура Расш1_ПробитьЧек()), платформа не сможет сопоставить вызов, что приведет либо к ошибке компиляции, либо к игнорированию обработчика.

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

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

Причина 3: Форма документа не заимствована в расширение

Если в расширение добавлен только сам объект метаданных (например, документ ЧекККМ), но не заимствована конкретная управляемая форма, то модуль формы расширения не будет скомпилирован и связан с рабочей формой. Проверьте ветку метаданных расширения: управляемая форма должна присутствовать в списке заимствованных объектов.

Особенности реализации постобработки: асинхронность и фискализация

Рассмотрим архитектурный нюанс привязки отправки SMS к процедуре ПробитьЧек. В современных типовых конфигурациях (УТ 11, КА 2, ERP, Розница) взаимодействие с торговым оборудованием через БПО (Библиотеку подключаемого оборудования) выполняется асинхронно с использованием оповещений.

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

Возможный риск: если на ККТ закончится кассовая лента или произойдет ошибка связи, код в &После все равно выполнится, и клиенту уйдет сообщение о пробитом чеке.

Чтобы отправлять SMS гарантированно после успешной фискализации, разберем правильные варианты встраивания:

Перехват процедуры обратного вызова (Callback): перехватывайте процедуру, обрабатывающую завершение фискализации, куда передается структура с результатом выполнения операции ККТ.
Обработка оповещения формы: встраивайте логику в метод ОбработкаОповещения формы, если статус пробития передается через оповещения.
Серверная постобработка: отправку SMS и запись статусов надежнее производить в серверных процедурах проведения документа или после успешного сохранения фискальных реквизитов (номера чека, ФД, ФПД) в информационной базе.

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

Контекст: совпадает ли директива компиляции (&НаКлиенте / &НаСервере) в расширении и основной конфигурации.
Сигнатура: совпадают ли имена и количество параметров у метода.
Объекты: заимствована ли сама форма в расширение.
Подключение отладки: подключен ли клиентский сеанс предприятия к отладчику в меню «Отладка → Подключение...».
Обновление сеанса: перезапустите сеанс 1С:Предприятия после внесения изменений в расширение, чтобы клиентское приложение гарантированно загрузило обновленные модули форм.