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

Другое · 6 мин

Как вызвать процедуру из модуля обработки в 1С

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

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

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

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

Когда процедуру нужно вызывать из модуля обработки

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

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

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

Место описания процедурыМодуль обработки, общий модуль или форма

Уточните, где именно объявлена процедура и экспортирована ли она

Контекст выполненияКлиент, сервер или общий контекст

Проверьте, совместим ли контекст вызова с контекстом процедуры

Наличие параметровОбязательные и опциональные аргументы

Сверьте количество и типы передаваемых значений

Способы вызова процедуры

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

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

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

Порядок действий
  1. 1
    Определите, где описана процедура и экспортирована ли она
  2. 2
    Проверьте контекст выполнения: клиент или сервер
  3. 3
    Подготовьте параметры вызова в нужном порядке
  4. 4
    Выполните вызов процедуры
  5. 5
    Проверьте результат и возможные исключения

Проверка результата выполнения

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

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

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

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

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

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

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

Типичные ошибки

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

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

Третья ошибка — игнорирование контекста клиента и сервера. Вызов клиентской процедуры из серверного модуля или наоборот приводит к исключению, поэтому перед написанием кода проверяйте директивы &НаКлиенте и &НаСервере.

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

Как выбрать подходящий способ вызова

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

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

Итог

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

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

Часто задаваемые вопросы

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

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

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

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

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

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

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

Прямое изменение учетных данных из клиентского кода ограничено. Такие операции лучше выполнять на сервере с учетом прав доступа и транзакций.

Как передать табличную часть в процедуру?

Передавайте табличную часть как параметр типа ТаблицаЗначений или ссылку на объект, в зависимости от сигнатуры процедуры. Перед вызовом убедитесь, что данные заполнены.