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

Другое · 6 мин

Общий модуль 1С: что это, где находится и как применяется

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

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

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

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

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

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

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

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

Где находится общий модуль и как его открыть

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

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

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

Что можно разместить в общем модуле

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

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

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

Процедура или функция становится доступной за пределами модуля, если помечена ключевым словом «Экспорт». Вызов выполняется по имени модуля с точкой, например: ИмяМодуля.ИмяПроцедуры(). Неэкспортируемые элементы видны только внутри самого модуля.

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

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

Типичные ошибки при работе с общим модулем

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

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

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

Компиляция конфигурации
Норма

Ошибок синтаксиса нет

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

Ошибки в модуле или вызывающем коде

Вызов экспортируемой процедуры
Норма

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

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

Ошибка доступа или неопределённая переменная

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

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

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

Итог

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

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

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

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

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

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

Что делать, если общий модуль не виден из документа?

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

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

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