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

Другое · 7 мин

Общие модули в 1С: назначение, свойства и способы использования

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

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

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

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

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

Общий модуль создается в дереве конфигурации в разделе «Общие модули». У него есть имя, комментарий и набор свойств, определяющих контекст выполнения кода. Модуль состоит из разделов процедур и функций, которые могут быть помечены как экспортируемые или локальные.

Экспортируемые процедуры и функции видны извне и могут быть вызваны по конструкции ИмяОбщегоМодуля.ИмяПроцедуры. Локальные процедуры и функции доступны только внутри самого модуля и не видны другим объектам конфигурации.

Свойства модуля и контекст выполнения

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

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

Общий модуль созданЕсть в дереве конфигурации

Откройте модуль и проверьте свойства выполнения

Процедура экспортированаВидна из других объектов

Убедитесь, что перед именем процедуры стоит ключевое слово Экспорт

Модуль используетсяЕсть вызовы по имени модуля

Найдите все вхождения имени модуля в конфигурации

Как вызывать экспортируемые процедуры и функции

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

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

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

Когда общий модуль подходит, а когда лучше объектный модуль

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

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

Типичные ошибки
01
Вызов серверной процедуры из клиентского кода вызывает ошибку выполнения
02
Изменение параметров экспортируемой процедуры без поиска всех вызовов ломает зависимые объекты
03
Правка общего модуля в рабочей базе без проверки в копии рискует стабильностью
Общий модульМодуль формы/отчета/документа
Переиспользуемый код для многих объектовКод, связанный с одним объектом конфигурации
Вызывается по имени модуляДоступен внутри объекта и его форм
Не имеет собственной формыСвязан с формой или объектом напрямую

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

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

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

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

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

Синтаксис модуля
Норма

Конфигурация сохраняется и обновляется без ошибок

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

Ошибки компиляции или невозможность сохранить модуль

Вызов процедуры
Норма

Возвращается ожидаемый результат

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

Ошибка выполнения или неверное значение

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

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

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

Ошибка при вызове из несоответствующего контекста

Как проверить, что общий модуль работает корректно

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

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

Итог

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

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

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

Может ли общий модуль содержать свою форму?

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

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

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

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

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

Что делать если после изменений модуль перестал работать?

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

Нужно ли всегда выносить код в общий модуль?

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