При работе с механизмом расширений в 1С:Предприятие 8.3 программисты часто сталкиваются с ситуацией, когда стандартной логики конфигурации недостаточно. Возникает необходимость вмешаться в работу типовых процедур, добавить свои проверки или передать дополнительные данные. Однако попытка просто добавить новый параметр в заимствованную процедуру неизбежно приводит к ошибке: «Ошибка применения модуля... не соответствует методу». Рассмотрим подробно, почему это происходит, как работает механизм контроля и какие существуют безопасные способы решения этой задачи.
Разберем ситуацию, с которой столкнулся автор темы. В основной конфигурации существует процедура с определенным количеством параметров, например:
Процедура ДополнитьТаблицуЗарплатыАналитикойБухУчета(ТаблицаЗаработнойПлаты) Экспорт
// Типовая логика
КонецПроцедуры
Программист, желая передать в эту процедуру еще и ПериодРегистрации, изменяет её в расширении следующим образом:
&ИзменениеИКонтроль("ДополнитьТаблицуЗарплатыАналитикойБухУчета")
Процедура Доп1_ДополнитьТаблицуЗарплатыАналитикойБухУчета(ТаблицаЗаработнойПлаты, ПериодРегистрации)
// Измененная логика с новым параметром
КонецПроцедуры
Платформа 1С при компиляции модуля расширения строго проверяет сигнатуру метода. Сигнатура — это имя метода и состав его параметров (их количество и порядок). Если в расширении количество параметров отличается от оригинала, расширение считается некорректным. Платформа делает это для обеспечения стабильности: если другой программный код вызовет эту процедуру стандартным способом (передав один параметр), а система ожидает два, это приведет к критическому сбою в рантайме.
Важный нюанс: часто ошибка появляется только при первом запуске после обновления или изменения расширения. Проанализируем это явление. Это связано с кэшированием скомпилированных модулей. После первой неудачной попытки применения система может «запомнить» состояние, но при очистке кэша или любом обновлении конфигурации ошибка возникнет снова. Игнорировать её нельзя, так как это «мина замедленного действия» для стабильности системы. Для предварительной проверки модулей на подобные несоответствия можно использовать инструмент для анализа расширений и конфигураций на наличие ошибок.
Рассмотрим наиболее элегантный способ, который позволяет передать неограниченное количество новых данных, не меняя формальное количество параметров процедуры. Суть метода заключается в использовании первого параметра как универсального контейнера. Если мы сами вызываем эту процедуру из своего кода в расширении, мы можем передать вместо таблицы Структуру.
Посмотрим на пример реализации в расширении:
&Вместо("ДополнитьТаблицуЗарплатыАналитикойБухУчета")
Процедура Доп1_ДополнитьТаблицуЗарплатыАналитикойБухУчета(ТаблицаЗаработнойПлаты)
// Проверяем тип входящего параметра
Если ТипЗнч(ТаблицаЗаработнойПлаты) = Тип("Структура") Тогда
// Извлекаем наши данные
ЛокальнаяТаблица = ТаблицаЗаработнойПлаты.Таблица;
ЛокальныйПериод = ТаблицаЗаработнойПлаты.ПериодРегистрации;
Иначе
// Если вызвано стандартно из типового кода
ЛокальнаяТаблица = ТаблицаЗаработнойПлаты;
ЛокальныйПериод = '00010101'; // Значение по умолчанию
КонецЕсли;
// Далее работаем с ЛокальнаяТаблица и ЛокальныйПериод
// ...
КонецПроцедуры
При таком подходе сигнатура метода (один параметр) сохранена, и платформа не будет ругаться при запуске. Однако помните, что вызовы этой процедуры из вашего кода также должны быть изменены: вместо передачи таблицы нужно формировать структуру.
Если расширяемая процедура работает с объектом (например, ДокументОбъект, СправочникОбъект или ДанныеФормыСтруктура), мы можем использовать свойство ДополнительныеСвойства. Это коллекция типа Структура, которая существует у большинства тяжелых объектов 1С специально для передачи служебной информации между модулями.
Разберем по шагам, как это реализовать:
Объект.ДополнительныеСвойства.Вставить("ПериодРегистрации", НужнаяДата);
&После или &Вместо) считываем эти данные:
&После("ОбработкаПроведения")
Процедура Доп1_ОбработкаПроведения(Отказ, РежимПроведения)
Если ЭтотОбъект.ДополнительныеСвойства.Свойство("ПериодРегистрации") Тогда
ДатаПериода = ЭтотОбъект.ДополнительныеСвойства.ПериодРегистрации;
// Используем дату в своей логике
КонецЕсли;
КонецПроцедуры
Этот метод считается наиболее профессиональным, так как он не меняет типы основных параметров и поддерживается самой платформой как стандарт обмена данными.
Проанализируем ситуацию: если вам нужно кардинально изменить логику и добавить много параметров, возможно, не стоит пытаться «втиснуться» в типовую процедуру. Рекомендуется создать в расширении свой собственный ОбщийМодуль.
Алгоритм действий следующий:
Расш1_УчетЗарплатыСлужебный.&Вместо) делаем вызов своей новой процедуры, передавая в неё необходимые значения.Это позволяет изолировать ваш код от типового, что значительно упростит дальнейшие обновления конфигурации. При обновлении вам нужно будет только проверить, не изменился ли состав параметров в месте вызова &Вместо, а вся ваша сложная логика останется нетронутой в вашем личном модуле.
Если вы используете &ИзменениеИКонтроль, помните, что эта директива крайне капризна. Она проверяет не только сигнатуру, но и текст внутри заимствованного блока. Рассмотрим правила безопасной работы с ней:
// Удалено, // Добавлено, // Вставлено.Итог: Ошибка «не соответствует методу» — это защитный механизм платформы. Для её устранения верните состав параметров в расширении к исходному виду. Передачу дополнительных данных реализуйте через Структуру (подменяя тип параметра) или через ДополнительныеСвойства объекта. Это обеспечит стабильную работу базы и отсутствие проблем при последующих обновлениях.