Общие модули в платформе 1С:Предприятие 8.3 представляют собой объекты для структурирования кода и повторного использования функционала. Эти объекты метаданных позволяют централизованно хранить процедуры и функции, вызываемые из различных компонентов конфигурации.
Свойства общих модулей
- Глобальный — если параметр установлен, процедуры и функции модуля становятся доступными во всей конфигурации без указания его имени. Однако необходимо учитывать, что их названия должны быть уникальными в пределах глобального контекста.
- Сервер — разрешает выполнение процедур и функций модуля на серверной стороне.
- Внешнее соединение — позволяет использовать код модуля при подключении внешних систем, таких как COM-соединения.
- Клиент (управляемое приложение) — открывает доступ к процедурам и функциям модуля в толстом клиенте, работающем в управляемом режиме.
- Клиент (обычное приложение) — делает код модуля доступным в толстом клиенте в режиме обычного приложения.
- Вызов сервера — включает возможность использования серверных процедур и функций на клиентской стороне.
- Привилегированный — при активации данного параметра отключается проверка прав доступа в модуле.
- Повторное использование — задает правила кеширования возвращаемых значений. Доступные режимы:
- Не используется — кеширование отключено.
- На время вызова — результат сохраняется только на период выполнения конкретной процедуры.
- На время сеанса — значение кэшируется до завершения сеанса пользователя.
Примечание. Признаки “Клиент (управляемое приложение) ” и “Клиент (обычное приложение)” отображаются, только если установлено редактирование конфигурации в режим “Управляемое приложение и обычное приложение”. Когда установлено “Управляемое приложение”, они заменяются на одно свойство “Клиент”. Настраивается этот переключатель в меню Сервис / Параметры / Общие.
Важно учитывать, что при одновременном указании флажков “Клиент” и “Сервер” содержащиеся в модуле процедуры и функции должны иметь одинаковое поведение на клиенте и на сервере.
Также нужно учитывать, что общие модули могут содержать только процедуры и функции. Объявлять переменные на уровне модуля в общих модулях (раздел объявления переменных) нельзя. Содержать раздел основной программы (после раздела всех процедур и функций) общие модули также не могут.