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

Другое · 7 мин

1С Common: что это, где используется и как проверить

Разбираем, что такое 1C Common (общие модули) в 1С:Предприятии, где они применяются, как проверить и правильно вносить изменения без риска для базы.

В контексте платформы 1С:Предприятие термин «Common» чаще всего относится к общим модулям — библиотекам процедур и функций, которые не привязаны к одной форме, документу или справочнику. Такой модуль содержит код, который может быть вызван из разных частей конфигурации.

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

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

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

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

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

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

Где и зачем используются общие процедуры

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

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

Сценарий: вызов из документа

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

Сценарий: использование в отчёте

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

Как подключить и вызвать общий модуль

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

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

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

Отличие от форм и объектов конфигурации

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

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

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

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

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

Конфигурация сохранена и база обновлена
Норма

Новый код доступен во всех вызывающих объектах

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

Старый вариант всё ещё выполняется

Работа вызывающих документов и отчётов
Норма

Результаты расчётов соответствуют ожидаемым

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

Ошибки в нескольких объектах одновременно

Проверка и отладка общих модулей

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

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

Ограничения и риски при изменении

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

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

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

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

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

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

Альтернативы общим модулям

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

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

Итог

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

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

Частые вопросы

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

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

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

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

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

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

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

Прямые правки в рабочей базе несут риск, так как изменения затрагивают все зависящие объекты. Безопаснее вносить правки на тестовой копии с резервной копией базы.

Как понять, что ошибка вызвана общим модулем?

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