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

Другое · 7 мин

Как обратиться к общему модулю в 1С: инструкция и примеры

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

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

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

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

Что такое общий модуль и когда к нему обращаются

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

К общему модулю обращаются, когда нужно повторно использовать логику без копирования, централизовать изменение правил или сократить объём кода в объектах конфигурации. Это удобно при поддержке: правка в одном месте применяется везде, где используется процедура.

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

Подготовка модуля: признак «Общий» и экспорт процедур

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

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

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

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

Синтаксис вызова из модуля объекта, формы или отчёта

Вызов оформляется как имя модуля, точка, имя процедуры и скобки с параметрами. Например, если модуль называется ОбщийМодульПример, а процедура Расчёт, то запись будет иметь вид ОбщийМодульПример.Расчёт(Параметр). Точка разделяет имя модуля и имя процедуры.

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

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

Особенности вызова на клиенте и на сервере

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

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

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

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

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

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

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

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

Альтернативы и границы самостоятельной работы

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

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

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

Модуль помечен как общий
Норма

Признак установлен в свойствах модуля

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

Признак отсутствует, вызов невозможен

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

Есть ключевое слово Экспорт

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

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

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

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

Итог

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

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

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

Можно ли вызвать общий модуль из любой формы?

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

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

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

Нужно ли различать клиент и сервер при вызове?

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

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

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