Другое · 7 мин
Как вызвать процедуру из модуля объекта внешней обработки в 1C
Вызов процедуры модуля объекта внешней обработки в 1C: экземпляр обработки, синтаксис вызова, клиент-серверный контекст, проверка результата и ошибки.
Внешняя обработка в 1C:Предприятие состоит из метаданных, модуля объекта и, обычно, модуля формы. Процедуры, описанные в модуле объекта, принадлежат экземпляру обработки, а не самой метаданной коллекции. Поэтому нельзя вызвать такую процедуру, просто указав имя обработки: сначала нужно получить или создать объект внешней обработки, а затем обратиться к его процедуре как к методу.
Модуль объекта содержит логику обработки: расчеты, заполнение, проверки и преобразование данных. Модуль формы отвечает за интерфейс и события формы. Если процедура объявлена в модуле формы, она недоступна извне так же просто, как процедура модуля объекта. Разделение важно при переносе логики из внешней обработки в другие объекты конфигурации.
Задача актуальна, когда нужно переиспользовать код внешней обработки из отчета, другой обработки, бизнес-процесса или программного интерфейса. Например, внешняя обработка считает себестоимость или формирует набор значений, а результат нужен в другом объекте без открытия формы обработки. При этом нужно учитывать права доступа, контекст клиент/сервер и возможность записи в информационную базу.
Получение объекта внешней обработки
В управляемом приложении экземпляр обычно получают через коллекцию метаданных внешних обработок. Имя обработки берется из конфигурации, а не от имени файла на диске. После получения объекта в переменной появляются процедуры модуля объекта, которые можно вызывать как свойства этой переменной.
В классическом или толстом клиенте может использоваться создание объекта по составному имени через глобальную функцию создания. Точный способ зависит от режима приложения и версии платформы, поэтому перед написанием кода проверьте доступные методы в справочнике синтаксиса для вашей конфигурации.
- 1Открыть конфигурацию и убедиться, что внешняя обработка добавлена в список метаданных
- 2Получить экземпляр обработки через коллекцию внешних обработок или создание объекта
- 3Убедиться, что нужная процедура описана в модуле объекта, а не в модуле формы
- 4Вызвать процедуру с требуемыми параметрами и проверить результат
Синтаксис вызова процедуры модуля объекта
Управляемое приложение
Примерная форма вызова в управляемом приложении выглядит так: получение объекта по имени из метаданных, затем вызов процедуры с параметрами. Имена объектов и процедур подставляются из вашей конфигурации; пример иллюстративный и требует проверки синтаксиса.
ВнешняяОбработка = ВнешниеОбработки.МояВнешняяОбработка.СоздатьОбъект();
ВнешняяОбработка.МояПроцедураИзМодуляОбъекта(Параметр1, Параметр2);
Если процедура является функцией, она возвращает значение. Если это процедура без возврата, результат можно судить только по изменению переданных параметров, данных в информационной базе или состоянию обработки после вызова. Передавайте параметры по ссылке, только если процедура должна изменить переменную вызывающего кода.
Динамическое имя процедуры
Когда имя процедуры известно только во время выполнения, используется механизм динамического вызова метода платформы. Точные сигнатуры и ограничения таких вызовов уточняются в справочнике синтаксиса, так как они зависят от режима клиент-серверного соединения и типа приложения.
Процедура доступна у экземпляра объекта обработки
Обычно недоступна для прямого вызова извне
Выбирайте в зависимости от доступа к данным и прав
Контекст выполнения: клиент, сервер и права
Процедура модуля объекта выполняется в том контексте, из которого она вызвана, если иное не задано свойствами процедуры или платформой. Чтение и запись данных обычно требуют серверного контекста. Если процедура обращается к регистрам, документам или справочникам, вызывайте её из серверной процедуры или убедитесь, что платформа выполняет нужную часть на сервере.
Права доступа проверяются от имени текущего пользователя сессии. Если пользователь не может изменять документ или справочник, процедура внешней обработки не сможет обойти эти ограничения автоматически. Не передавайте в процедуру недоверенные данные без проверки, особенно если внутри возможна запись или проведение документов.
Проверка результата и обработка ошибок
После вызова процедуры проверяйте, изменилось ли состояние информационной базы так, как ожидалось. Для функций сравнивайте возвращаемое значение с ожидаемым. Для процедур без возврата контролируйте изменение переданных объектов, табличных частей или записей в регистрах. Ошибки синтаксиса проявляются при компиляции, а ошибки выполнения — при запуске.
Используйте обработку исключений вокруг вызова, если процедура может завершиться нештатно. Логируйте имя обработки, имя процедуры, параметры и текст ошибки, чтобы упростить поиск причины. Не скрывайте ошибки без анализа, особенно при работе с документами и остатками.
Как проверить результат
Переменная содержит объект внешней обработки
Переменная неопределена или это метаданные, а не объект
Вызов завершается без ошибки компиляции
Ошибка: метод не найден или процедура в модуле формы
Ожидаемые записи изменены или функция вернула результат
Данные не изменились или возникло исключение выполнения
Ограничения и частые ошибки
Основная ошибка — попытка вызвать процедуру модуля объекта без создания экземпляра внешней обработки. Другая частая проблема — путаница между модулем объекта и модулем формы: процедура формы не станет доступной из другого объекта просто по имени обработки. Также часто забывают про контекст клиент/сервер и пытаются писать в базу из клиентской процедуры без серверного вызова.
Не вызывайте необратимые процедуры в рабочей базе без проверки на копии. Если внешняя обработка проводит документы, меняет остатки или удаляет данные, ошибка в параметрах может повредить учетные данные. Перед массовым запуском выполните выборочное тестирование и убедитесь в наличии резервной копии или возможности отката.
Альтернативы и когда не стоит так делать
Если логика нужна многим объектам, лучше вынести общие процедуры в общий модуль с соответствующим контекстом выполнения, а не дублировать код во внешних обработках. Общие модули проще поддерживать, их легче вызывать из разных частей конфигурации и проще тестировать отдельно.
Если нужно только запустить внешнюю обработку с формой и получить результат от пользователя, проще открыть обработку обычным способом и передать параметры через форму. Прямой вызов процедуры модуля объекта оправдан при автоматизации без участия пользователя и при условии, что интерфейс обработки не требуется.
Что важно запомнить
Получайте экземпляр внешней обработки, вызывайте процедуру модуля объекта как метод этого экземпляра, учитывайте клиент-серверный контекст и проверяйте результат на тестовой базе.
Можно ли вызвать процедуру без создания экземпляра внешней обработки?
Нет. Метаданные внешней обработки описывают объект, но процедуры модуля объекта доступны у экземпляра. Сначала получите объект через коллекцию метаданных или создание объекта, а затем вызывайте процедуру.
В чем разница между модулем объекта и модулем формы внешней обработки?
Модуль объекта содержит логику обработки и доступен у экземпляра объекта. Модуль формы относится к интерфейсу и событиям формы; его процедуры обычно не вызываются из других объектов так же напрямую.
Что делать, если процедура не видна при вызове?
Проверьте точное имя процедуры, место её описания, контекст клиент/сервер, права пользователя и наличие экземпляра обработки. Уточните сигнатуру вызова в справочнике синтаксиса для вашего режима приложения.
Безопасно ли изменять данные через процедуру внешней обработки?
Можно, но такие вызовы могут записывать данные в информационную базу. Тестируйте на копии, проверяйте права и результаты, не запускайте необратимые операции в рабочей базе без резервной копии и анализа рисков.