Как обратиться к общему модулю из внешней обработки 1С

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

Проблемы возникают не из-за самой внешней обработки, а из-за несовпадения контекстов: модуль помечен только как «Сервер», а вызов идёт из клиентской процедуры формы обработки, или метод модуля не экспортный. В таких случаях платформа выдаёт ошибку «Процедура или функция с указанным именем не определена» либо «Переменная не определена» при компиляции модуля.

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

Как устроена видимость общих модулей для внешней обработки

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

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

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

Синтаксис вызова из модуля объекта обработки

Модуль объекта внешней обработки исполняется на сервере (в управляемом приложении), поэтому из него доступны все серверные общие модули. Обращение строится по шаблону: имя модуля, точка, имя экспортного метода, параметры в скобках.

&НаСервере
Процедура ВыполнитьОбработку() Экспорт

	// Вызов функции общего модуля с возвратом значения
	КурсВалюты = РаботаСКурсамиВалют.ПолучитьКурс(Валюта, ТекущаяДатаСеанса());

	// Вызов процедуры без возврата значения
	Журналирование.ЗаписатьСобытие("Запуск внешней обработки", Перечисления.УровниЖурнала.Информация);

КонецПроцедуры

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

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

Вызов общего модуля из формы внешней обработки

Форма внешней обработки в управляемом приложении разделена на клиентский и серверный контексты. Из клиентской процедуры (&НаКлиенте) можно напрямую вызвать только те общие модули, у которых установлен флаг «Клиент (управляемое приложение)». Таких модулей в типовых конфигурациях немного, и обычно их имена содержат суффикс «Клиент» (например, ОбщегоНазначенияКлиент).

Серверные модули из клиентского кода вызываются косвенно: клиентская процедура обращается к серверной процедуре той же формы, а уже та — к общему модулю. Это стандартный и безопасный паттерн, который не требует менять свойства модулей конфигурации.

&НаКлиенте
Процедура КомандаВыполнить(Команда)
	Результат = ВыполнитьНаСервере(Номенклатура);
	Если Результат Тогда
		ПоказатьОповещениеПользователя("Обработка завершена");
	КонецЕсли;
КонецПроцедуры

&НаСервереБезКонтекста
Функция ВыполнитьНаСервере(НоменклатураСсылка)
	Возврат ОбщегоНазначения.ЗначениеРеквизитаОбъекта(НоменклатураСсылка, "ПометкаУдаления") <> Неопределено;
КонецФункции

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

Какие флаги модуля проверить перед вызовом

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

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

Типичные ошибки и способы их устранения

Ошибка «Переменная не определена (ИмяМодуля)» означает, что платформа не видит сам модуль в текущем контексте. Причины: не установлен нужный флаг компиляции, опечатка в имени модуля, либо модуль принадлежит расширению, которое не подключено в текущем сеансе. Проверяйте в указанном порядке — сначала флаги, потом написание имени.

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

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

Общие модули расширения конфигурации

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

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

&НаСервере
Функция МодульДоступен()
	Попытка
		Возврат Вычислить("МойМодульРасширения.Версия()") <> Неопределено;
	Исключение
		Возврат Ложь;
	КонецПопытки;
КонецФункции

Проверка результата и отладка вызова

Убедиться, что вызов общего модуля реально отработал, проще всего через отладчик: поставьте точку останова на строке вызова в обработке и на первой строке вызываемого метода модуля. Запустите отладку предприятия, откройте обработку через «Файл → Открыть» и выполните действие. Если точка внутри модуля сработала — вызов дошёл, дальше анализируйте возвращаемое значение.

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

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

Частые вопросы