Как вызвать экспортную функцию в 1С

Экспортная функция в 1С — это процедура или функция, объявленная с ключевым словом Экспорт, которая становится доступной для вызова из других модулей конфигурации. Без этого слова метод остаётся приватным: платформа скрывает его от внешнего кода, и попытка обращения закончится ошибкой «Процедура или функция с указанным именем не определена».

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

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

Как объявить экспортную функцию

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

Функция ПолучитьКурсВалюты(КодВалюты, НаДату) Экспорт
// тело функции
Возврат Курс;
КонецФункции

Те же правила действуют для процедур: Процедура ЗаписатьЛог(Текст) Экспорт. Если слово Экспорт опущено, метод можно вызывать только внутри того же модуля. Это удобно для вспомогательных вычислений, которые не должны стать частью публичного интерфейса.

При объявлении учитывайте контекст модуля. В общем модуле с флагом «Сервер» экспортная функция недоступна на клиенте, а в модуле с флагом «Клиент (обычное приложение)» — в тонком клиенте. Набор флагов компиляции определяет, откуда метод физически можно вызвать, и это частая причина ошибок даже при корректном синтаксисе.

Вызов функции из общего модуля

Самый частый сценарий — вызов функции, размещённой в общем модуле. Обращение выполняется по имени модуля без создания экземпляров: РаботаСКурсамиВалют.ПолучитьКурсВалюты("USD", ТекущаяДатаСеанса()). Имя модуля становится пространством имён, а точка отделяет его от имени метода.

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

Проверьте флаги модуля перед вызовом. Для кода, который должен работать и на клиенте, и на сервере, ставят флаги «Сервер» и «Клиент (управляемое приложение)», а вызовы, допустимые только на сервере, оборачивают директивами #Если Сервер Тогда либо выносят в отдельный серверный модуль.

1. 1
   Откройте общий модуль и добавьте функцию с ключевым словом Экспорт
2. 2
   Убедитесь, что флаги контекста модуля (Сервер, Клиент) соответствуют месту вызова
3. 3
   В вызывающем модуле напишите ИмяМодуля.ИмяФункции(параметры)
4. 4
   Нажмите «Проверка модулей» в конфигураторе, чтобы поймать ошибки компиляции
5. 5
   Запустите сценарий в режиме предприятия и убедитесь, что функция возвращает ожидаемое значение

Вызов экспортных методов модулей объектов и менеджеров

Модули объектов (справочников, документов, регистров) тоже могут содержать экспортные процедуры и функции. Вызвать их можно только через конкретный объект: сначала получают объект методом ПолучитьОбъект() у ссылки, затем обращаются к методу. Пример: ОбъектДокумента = ДокументСсылка.ПолучитьОбъект(); ОбъектДокумента.ЗаполнитьПоУмолчанию();.

Модули менеджеров вызываются через менеджер типа: Справочники.Номенклатура.НайтиПоШтрихкоду(Код), где НайтиПоШтрихкоду — экспортная функция модуля менеджера справочника. Это стандартный способ вынести логику поиска и создания объектов из форм в переиспользуемый код.

Важное ограничение: вызов метода через ПолучитьОбъект() создаёт в памяти полноценный объект и открывает транзакционный контекст записи. Частые такие вызовы в циклах замедляют работу и могут приводить к конфликтам блокировок. Если нужно только прочитать данные, используйте запросы или функции модуля менеджера, работающие со ссылками.

Вызов функции из внешней обработки или отчёта

У внешних обработок и отчётов экспортные функции объявляются в модуле объекта или в модуле формы. Вызов извне выполняется через созданный экземпляр: сначала обработку подключают методом ВнешниеОбработки.Создать(ИмяФайла) (для файловых обработок) или через справочник дополнительных отчётов и обработок, затем обращаются к её методам.

Обработка = ВнешниеОбработки.Создать("C:\Обработки\ЗагрузкаКурсов.epf", Ложь);
Результат = Обработка.ЗагрузитьДанные(НачалоМесяца(ТекущаяДатаСеанса()));

Второй параметр метода Создать управляет безопасным режимом. Для обработок из недоверенных источников безопасный режим должен быть включён: он запрещает операции с файловой системой, COM-объектами и привилегированным доступом к данным. Отключать его стоит только для кода, происхождение которого полностью контролируется.

Если обработка подключена через механизм БСП «Дополнительные отчеты и обработки», точкой входа обычно служит экспортная функция СведенияОВнешнейОбработке() в модуле объекта. Платформа и подсистема вызывают её сами при регистрации, поэтому её сигнатуру нельзя менять произвольно.

Функция СведенияОВнешнейОбработке() Экспорт
    Сведения = Новый Структура;
    Сведения.Вставить("Вид", "ЗаполнениеОбъекта");
    Сведения.Вставить("Версия", "1.0");
    Возврат Сведения;
КонецФункции

Вызов между формами и через Выполнить/ОценитьВыражение

Экспортные процедуры и функции модуля формы доступны через объект формы при открытии с параметром или через ПолучитьФорму(). В управляемом приложении такой вызов возможен только в клиентском контексте формы-владельца, и злоупотреблять им не стоит: обмен данными между формами надёжнее строить через оповещения (Оповестить / ОбработкаОповещения) и параметры открытия.

Отдельный способ — динамический вызов через функцию ОценитьВыражение() или устаревший Выполнить(): строка с именем функции вычисляется в рантайме. Это позволяет вызывать методы, имена которых неизвестны на этапе разработки, например в универсальных обменах. Цена — потеря контроля компилятором: ошибка в имени проявится только при выполнении, а рефакторинг и поиск ссылок на метод перестают работать.

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

Типичные ошибки и их диагностика

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

Вторая группа ошибок — «Метод объекта не обнаружен» при вызове через точку от ссылки. Ссылка в 1С не является объектом: у неё доступны только предопределённые свойства. Чтобы вызвать экспортный метод модуля объекта, требуется ПолучитьОбъект(), а для логики без создания объекта — перенос функции в модуль менеджера.

Третья типичная ситуация — ошибки при обновлении конфигурации или подключении расширения: метод есть, но вызов падает из-за несовпадения числа параметров. Экспортные функции не поддерживают перегрузку, поэтому изменение сигнатуры ломает все места вызова. Перед изменением публичного API выполните поиск по имени метода по всей конфигурации и по подключённым расширениям.

Как проверить, что вызов работает

Первый уровень проверки — статический: команда «Конфигурация → Проверка конфигурации» с включённой проверкой модулей покажет все неразрешённые вызовы до запуска. Это ловит опечатки, отсутствующий Экспорт и несовпадение контекстов компиляции.

Второй уровень — отладка: поставьте точку останова внутри экспортной функции и выполните вызывающий сценарий. Если управление в функцию не попадает, проблема в маршруте вызова (контекст, условия, директивы), а не в теле метода. Для серверных вызовов убедитесь, что отладка на сервере включена в свойствах информационной базы.

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

FAQ