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