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

Другое · 7 мин

Обращение к общим модулям в 1С: инструкция для разработчика

Практичная инструкция по вызову общих модулей 1С: экспорт процедур, серверный и клиентский контекст, проверка результата и типичные ошибки.

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

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

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

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

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

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

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

Как вызвать процедуру общего модуля

Синтаксис вызова выглядит как обращение к имени модуля через точку: ОбщийМодуль.ИмяМодуля.ИмяПроцедуры(Параметры). Если процедура возвращает значение, результат можно присвоить переменной: Результат = ОбщийМодуль.ИмяМодуля.ИмяФункции(Параметры).

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

Порядок действий
  1. 1
    Откройте общий модуль и убедитесь, что процедура помечена как Экспорт
  2. 2
    Наберите имя общего модуля и точку для обращения к процедуре
  3. 3
    Укажите параметры в соответствии с описанием процедуры
  4. 4
    Проверьте возвращаемое значение или отсутствие ошибки после выполнения

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

Серверный и клиентский контекст вызова

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

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

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

Видимость, экспорт и ограничения

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

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

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

Как проверить, что вызов сработал

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

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

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

Имя модуля и процедуры совпадают с конфигурацией
Норма

Вызов компилируется и выполняется

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

Ошибка компиляции или метод не найден

Процедура помечена как Экспорт
Норма

Доступна из других модулей

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

Видна только внутри общего модуля

Контекст вызова соответствует задаче
Норма

Данные и формы доступны там, где нужно

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

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

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

Частые ошибки и безопасная работа

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

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

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

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

Можно ли вызвать процедуру без пометки Экспорт?

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

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

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

Как отличить серверный вызов от клиентского?

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

Что делать, если общий модуль не находится при вызове?

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

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

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