Расширениясредний

Расширения: меняем проведение без снятия с поддержки

Аннотации &Перед, &После и &Вместо: что выбрать, как отлаживать и как не устроить конфликт двух расширений в одной базе.

28 октября 20268 мин чтенияавтор: idkodr
Содержание
Зачем расширенияТри аннотацииКонфликты расширений

Зачем расширения

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

Три аннотации

АннотацияЧто делаетКогда использовать
&ПередКод до штатного методаПодменить параметры, проверить условия
&ПослеКод после штатного методаДобавить свою логику, не трогая типовую
&ВместоПолная замена методаКрайний случай: типовая логика не подходит совсем
Расширение.bsl
&После("ОбработкаПроведения")Процедура Расш1_ОбработкаПроведения(Отказ, РежимПроведения)    Если Отказ Тогда        Возврат;    КонецЕсли;    // своя логика после штатного проведения    ЗаписьЖурналаРегистрации("Расш1.Проведение",        УровеньЖурналаРегистрации.Информация,,,        "Документ проведён: " + Ссылка);КонецПроцедуры
Важно

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

Конфликты расширений

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