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

Другое · 8 мин

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

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

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

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

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

Способы получения объекта внешней обработки

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

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

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

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

Вызов процедур и функций модуля

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

1c
Обработка = Обработки.МояВнешняяОбработка.СоздатьОбъект();
Результат = Обработка.МояПубличнаяФункция(Параметр);

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

Обработка = Обработки.МояВнешняяОбработка.СоздатьОбъект(); Обработка.РассчитатьДанные(Параметр); Результат = Обработка.ПолучитьЗначение();

Когда вызов выполняется на клиенте

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

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

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

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

Переменная содержит ссылку на объект

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

Значение неопределённо или ошибка при создании

Процедура выполнена
Норма

Возвращено ожидаемое значение или изменены данные

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

Исключение или неопределённый результат

Права доступа
Норма

Пользователь может запускать обработку

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

Ошибка доступа при создании или вызове

Когда вызов выполняется на сервере

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

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

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

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

Ограничения и риски

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

Типичные ошибки
01
Вызов неэкспортируемой процедуры модуля внешней обработки
02
Передача параметров неподходящего типа или в неправильном порядке
03
Запуск клиентского кода в серверном контексте без необходимого перехода

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

Частые ошибки при обращении к модулю

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

Сравнение вариантов

Внешняя обработка

Подходит для отдельных инструментов и обмена, требует явного создания объекта и проверки прав.

Общий модуль конфигурации

Удобен для повторно используемой логики, но требует изменения конфигурации и обновления пользователей.

Встроенный справочник или документ

Выбирайте для постоянного хранения данных, а не для разовых вычислений.

Часто разработчики забывают про контекст клиент-серверного вызова и пытаются использовать клиентские объекты на сервере. Это приводит к ошибкам доступа к форме, сеансу или временным данным. Также не стоит полагаться на то, что внешняя обработка автоматически сохранит изменения в базе; сохранение требует явного вызова методов записи, если это предусмотрено модулем.

Альтернативы и когда не стоит использовать внешнюю обработку

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

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

Итог перед ответами на частые вопросы

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

Итог

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

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

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

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

Что делать, если объект обработки не создаётся?

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

Нужно ли сохранять изменения после вызова процедуры?

Зависит от логики модуля. Если процедура изменяет объекты базы, изменения могут потребовать явного вызова метода записи; если вычисления производятся только в памяти, сохранение не требуется.

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

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