К статье
Практический материал

Другое · 9 мин

Вызов процедуры из модуля внешней обработки 1С

Как вызвать экспортируемую процедуру модуля внешней обработки в 1С: создание объекта, вызов по пути, клиент-серверный контекст и проверка результата.

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

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

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

Когда внешняя обработка подходит как источник процедуры

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

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

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

Создание объекта внешней обработки и вызов процедуры

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

После создания объекта вызывайте у него процедуру по имени. Примерный вид кода без лишних оформлений:

ОбъектОбработки = ВнешниеОбработки.Создать(ПутьКФайлу); Если ОбъектОбработки <> Неопределено Тогда Результат = ОбъектОбработки.ИмяЭкспортнойПроцедуры(Параметр1, Параметр2); КонецЕсли;

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

Порядок вызова процедуры
  1. 1
    Убедитесь, что процедура в модуле внешней обработки помечена как Экспорт
  2. 2
    Создайте объект внешней обработки через ВнешниеОбработки.Создать с правильным путём к файлу
  3. 3
    Проверьте, что объект создан и не равен Неопределено
  4. 4
    Вызовите процедуру у объекта с нужными параметрами
  5. 5
    Проверьте возвращаемое значение или признак успешного выполнения

Клиентский и серверный контекст вызова

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

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

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

Формы внешней обработки и процедуры формы

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

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

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

text
Объект = ВнешниеОбработки.Создать(ПутьКФайлу);
Если Объект <> Неопределено Тогда
    Результат = Объект.МояПроцедура(Параметр);
КонецЕсли;

Проверка результата и частые ошибки

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

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

Типичные ошибки
01
Вызов неэкспортируемой процедуры — платформа не позволит обратиться к ней извне
02
Неверный путь к файлу epf — объект не создаётся и процедура не вызывается
03
Вызов серверной процедуры из клиентского кода без серверного контекста
04
Использование заблокированного или недоступного файла внешней обработки

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

Безопасность и ограничения самостоятельной работы

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

Контрольные точки

Как проверить результат

Объект внешней обработки создан
Норма

Объект не равен Неопределено

Тревожный признак

Ошибка создания объекта или пустой путь к файлу

Процедура вызвана без ошибок
Норма

Платформа не выдала исключения

Тревожный признак

Текст ошибки о несуществующей или неэкспортируемой процедуре

Возвращаемое значение корректно
Норма

Ожидаемый тип и содержимое результата

Тревожный признак

Неопределенное или пустое значение при ожидаемых данных

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

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

Итог

Что важно запомнить

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

Нужно ли подключать внешнюю обработку через специальную команду перед вызовом процедуры?

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

Можно ли вызвать процедуру из формы внешней обработки напрямую?

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

Что делать, если процедура не видна извне?

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

Безопасно ли запускать внешнюю обработку из неизвестного источника?

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

Зависит ли вызов от типа клиента: толстый, тонкий или веб?

Да, может зависеть. Серверные процедуры требуют серверного контекста, а работа с локальными файлами в веб-клиенте ограничена. Перед вызовом уточните, в каком приложении будет выполняться код, и проверьте поддержку нужных операций в этом режиме.