Другое · 5 мин
Как сделать процедуру экспортной в расширении 1С
Как объявить процедуру экспортной в расширении конфигурации 1С: синтаксис, модули, вызов, проверка и ограничения для безопасных изменений.
Процедура в модуле расширения 1С по умолчанию доступна только внутри этого модуля. Чтобы вызывать её из других объектов конфигурации, из внешней обработки или из команд интерфейса, объявление нужно пометить как экспортное.
В расширении конфигурации порядок объявления близок к основной конфигурации, но есть ограничения, связанные с тем, что расширение не может свободно менять уже существующие экспортные процедуры базового объекта.
Ниже разобрано, где и как правильно указать ключевое слово, какие модули подходят, как проверить результат и в каких случаях лучше не вносить изменения самостоятельно.
Когда процедуру нужно делать экспортной
Экспортный модификатор требуется, когда логика должна использоваться за пределами модуля расширения. Типичные случаи: вызов из формы документа, обработки, отчёта, общего модуля или команды пользовательского интерфейса.
Если процедура нужна только для внутренних вычислений внутри одного модуля, экспорт делать не обязательно. Лишние экспортные объявления увеличивают поверхность взаимодействия и могут усложнить поддержку при обновлении базовой конфигурации.
Где объявлять экспортную процедуру в расширении
Подходящие места — модули объектов конфигурации, общие модули, модули форм и отчётов, в которые вносится расширение. Не все модули позволяют свободно добавлять экспортные процедуры, поэтому перед правкой нужно открыть расширение в конфигураторе и убедиться, что целевой модуль доступен для дополнения.
Важно отличать добавление новой процедуры от попытки переопределить существующую. В расширении нельзя просто заменить уже экспортную процедуру базового объекта своей версией с тем же именем без учёта механизмов переопределения, предусмотренных платформой.
Как выбрать действие
Синтаксис объявления и пример
В заголовке процедуры после слова Процедура и перед именем указывается ключевое слово Экспорт. Общий вид выглядит так: «Процедура Экспорт ИмяПроцедуры(Параметр) Экспорт». Точное расположение модификатора зависит от синтаксиса используемой версии платформы, поэтому рекомендуется сверяться с подсказкой конфигуратора.
После ввода кода модуль должен пройти проверку синтаксиса без ошибок. Если конфигуратор подсвечивает объявление, причина чаще всего в неверном месте ключевого слова или в невозможности добавить экспорт в выбранный модуль.
Процедура Экспорт МояЭкспортнаяПроцедура(Знач Параметр) Экспорт
// тело процедуры
КонецПроцедурыКак подключить и вызвать процедуру
После сохранения расширения его нужно подключить к информационной базе через меню администрирования расширений. Только после активации новые экспортные процедуры становятся видимыми для остальной конфигурации.
Вызов производится по имени процедуры из объекта, в котором она объявлена. Например, из общего модуля обращение может выглядеть как вызов метода соответствующего объекта расширения. Если процедура не видна, проверьте, что расширение активно и что модификатор Экспорт действительно присутствует.
Как проверить результат
Ошибок синтаксиса нет
Конфигуратор подсвечивает объявление процедуры
Расширение подключено и активно
Расширение выключено или не загружено
Процедура выполняется без ошибки
Сообщение о том, что процедура не определена или не экспортирована
Проверка результата и признаки корректной работы
Нормальным результатом считается успешное сохранение расширения, отсутствие ошибок синтаксиса и возможность вызвать процедуру из целевого объекта без сообщения о том, что процедура не определена.
Ограничения и риски расширений
Не все объекты конфигурации допускают добавление новых экспортных процедур через расширение. Некоторые модули закрыты для дополнения, а некоторые существующие экспортные процедуры нельзя переопределять простым объявлением с тем же именем.
Изменения в расширении могут повлиять на обновление базовой конфигурации. Перед вводом в эксплуатацию рекомендуется протестировать порядок действий на копии базы, а не на рабочей информации.
Что делать, если экспорт не сработал
Проверьте три вещи: наличие слова Экспорт в объявлении, активность расширения и правильность обращения к объекту, где процедура объявлена. Если всё верно, а процедура всё равно не видна, возможно, выбранный модуль не поддерживает экспортные дополнения.
Что важно запомнить
Экспортная процедура в расширении 1С объявляется с ключевым словом Экспорт, расширение должно быть активным, а результат проверяется вызовом из целевого объекта.
Нужно ли всегда добавлять слово Экспорт в расширении?
Нет, только если процедура должна вызываться извне модуля. Для внутренних расчётов достаточно обычного объявления без модификатора.
Можно ли заменить существующую экспортную процедуру базовой конфигурации в расширении?
Не всегда. Возможность зависит от объекта и версии платформы; простой дубликат с тем же именем может привести к ошибке при сохранении или активации.
Как понять, что расширение подключено?
В списке расширений информационной базы должен отображаться активный статус, а новые экспортные процедуры должны вызываться без ошибки «Процедура не определена».
Что делать, если после активации процедура не вызывается?
Проверьте наличие модификатора Экспорт, активность расширения и правильность ссылки на объект. При сохранении ошибок обратитесь к разработчику конфигурации.