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