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

Другое · 6 мин

Вызов процедуры из общего модуля в 1С

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

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

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

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

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

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

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

Синтаксис вызова и пример кода

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

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

bsl
ОбщийМодуль.УчетРасчетов.РассчитатьСумму(Сумма, Ставка);

Клиентское и серверное выполнение

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

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

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

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

Доступность процедуры
Норма

Процедура видна в автодополнении и компилируется

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

Ошибка компиляции или процедура не найдена

Контекст вызова
Норма

Клиент вызывает клиентскую процедуру, сервер — серверную

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

Клиент вызывает серверную процедуру напрямую

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

Данные доступны текущему пользователю

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

Ошибка доступа к регистрам или документам

Проверка доступности и прав доступа

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

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

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

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

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

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

Безопасные границы и альтернативы

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

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

Итог

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

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

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

Нужно ли всегда помечать процедуру как Экспорт?

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

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

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

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

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

Безопасно ли менять общий модуль в рабочей базе?

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