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

Другое · 6 мин

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

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

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

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

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

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

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

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

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

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

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

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

Порядок создания общего модуля
  1. 1
    Открыть дерево конфигурации и перейти в раздел «Общие модули»
  2. 2
    Создать новый общий модуль и задать ему имя
  3. 3
    Написать экспортируемые процедуры и функции
  4. 4
    Установить подходящие свойства выполнения для клиента и сервера
  5. 5
    Выполнить проверку синтаксиса конфигурации

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

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

Экспорт процедур и вызов из других объектов

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

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

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

Ограничения и риски при использовании

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

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

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

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

Проверка, отладка и безопасные изменения

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

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

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

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

Проверка синтаксиса после правки общего модуля
Норма

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

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

Ошибки компиляции или отсутствие экспортируемой процедуры

Вызов из целевой формы или отчёта
Норма

Процедура выполняется и возвращает корректный результат

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

Ошибка при вызове или неверные данные на выходе

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

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

Итог

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

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

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

Может ли общий модуль работать с текущим документом автоматически?

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

Где создаётся общий модуль в конфигурации?

В Конфигураторе в разделе «Общие модули» дерева конфигурации. После создания он становится доступным для вызова из других объектов при наличии экспортируемых процедур.

Нужно ли проверять синтаксис после изменения общего модуля?

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

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

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

Что делать, если после правки общего модуля перестали работать другие объекты?

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