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

Другое · 8 мин

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

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

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

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

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

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

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

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

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

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

Когда создание глобального модуля оправдано

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

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

Порядок безопасного внесения изменений

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

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

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

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

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

Типичные ошибки
01
Хранение временного состояния пользователя в глобальных переменных общего модуля может привести к смешению данных между сессиями.
02
Вынесение в общий модуль логики, нужной только в одном документе, усложняет отладку и увеличивает риск непреднамеренных изменений.

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

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

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

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

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

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

Ошибок и предупреждений по измененному модулю нет

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

Есть сообщения о несоответствии типов или отсутствии процедуры

Вызов из нескольких объектов
Норма

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

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

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

Альтернативы и границы самостоятельной работы

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

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

Итог

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

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

Нужен ли глобальный модуль для каждой общей функции?

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

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

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

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

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

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

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