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