Как в расширении 1С перехватить событие модуля формы и программно добавить элементы без проблем с обновлениями?

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

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

Способ 1. Перехват событий через общий модуль МодификацияКонфигурацииПереопределяемый

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

Для реализации этого подхода выполним следующие шаги:

1. Найдем в основной конфигурации общий модуль МодификацияКонфигурацииПереопределяемый и заимствуем только его в расширение.
2. В модуле расширения перехватим процедуру ПриСозданииНаСервере с помощью аннотации &Перед.
3. Внутри процедуры выполним проверку имени открываемой формы и программно добавим необходимые реквизиты и элементы.

Проанализируем пример кода в модуле расширения:

&Перед("ПриСозданииНаСервере")
Процедура Расш1_ПриСозданииНаСервере(Форма, Отказ, СтандартнаяОбработка) Экспорт
    
    // Проверяем, что открывается именно нужная нам форма документа
    Если Форма.ИмяФормы = "Документ.РеализацияТоваровУслуг.Форма.ФормаДокумента" Тогда 
        
        // 1. Создаем реквизит формы для хранения данных
        МассивДобавляемыхРеквизитов = Новый Массив; 
        МассивДобавляемыхРеквизитов.Добавить(Новый РеквизитФормы(
            "Остатки", 
            Новый ОписаниеТипов("Число", Новый ОписаниеТиповЧисла(15, 2)), 
            "Объект.Товары", 
            "Доступно на складе", 
            Ложь
        )); 
        
        Форма.ИзменитьРеквизиты(МассивДобавляемыхРеквизитов); 
        
        // 2. Добавляем новый элемент формы (колонку) в табличную часть Товары
        НовыйЭлемент = Форма.Элементы.Добавить("ТоварыОстатки", Тип("ПолеФормы"), Форма.Элементы.Товары); 
        НовыйЭлемент.Вид = ВидПоляФормы.ПолеВвода; 
        НовыйЭлемент.ТолькоПросмотр = Истина; 
        НовыйЭлемент.ПутьКДанным = "Объект.Товары.Остатки"; 
        
    КонецЕсли;
    
КонецПроцедуры

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

Способ 2. Грамотное заимствование формы с очисткой состава

Если для решения задачи требуется перехватывать специфические клиентские события формы (например, ПриОткрытии, ПриИзменении элементов табличной части) и прописывать логику непосредственно в модуле формы, без заимствования самой формы не обойтись.

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

1. Заимствуем форму документа в расширение.
2. Удаляем из формы в расширении все лишние элементы и реквизиты, которые не участвуют в вашей доработке (конфигуратор сам предупредит, если элемент нельзя удалить из-за зависимостей).
3. В модуле заимствованной формы прописываем перехватчики событий с аннотациями &После или &Перед.

Рассмотрим пример кода в модуле заимствованной формы в расширении:

&НаСервере
Процедура Расш1_ПриСозданииНаСервереПосле(Отказ, СтандартнаяОбработка)
    
    // Динамическое добавление реквизита и элемента
    МассивРеквизитов = Новый Массив; 
    МассивРеквизитов.Добавить(Новый РеквизитФормы(
        "Остатки", 
        Новый ОписаниеТипов("Число", Новый ОписаниеТиповЧисла(15, 3)), 
        "Объект.Товары", 
        "Остаток", 
        Ложь
    )); 
    ИзменитьРеквизиты(МассивРеквизитов); 
    
    НовоеПоле = Элементы.Добавить("ТоварыОстатки", Тип("ПолеФормы"), Элементы.Товары); 
    НовоеПоле.Вид = ВидПоляФормы.ПолеВвода; 
    НовоеПоле.ПутьКДанным = "Объект.Товары.Остатки"; 
    НовоеПоле.ТолькоПросмотр = Истина;
    
КонецПроцедуры

&НаКлиенте
Процедура Расш1_ПриОткрытииПосле(Отказ)
    ЗаполнитьОстаткиНаСкладе();
КонецПроцедуры

&НаКлиенте
Процедура Расш1_ТоварыНоменклатураПриИзмененииПосле(Элемент)
    ЗаполнитьОстаткиНаСкладе();
КонецПроцедуры

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

Альтернативный вариант: Внешняя обработка заполнения

Если автоматическое заполнение при открытии формы не является критически обязательным требованием, стоит рассмотреть использование внешней обработки с типом команды ТипКомандыЗаполнениеФормы. В этом случае конфигурация и формы остаются полностью нетронутыми, а пользователь вызывает процедуру расчета и заполнения остатков по кнопке Заполнить.

Выводы и рекомендации

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

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