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

Другое · 8 мин

Программные модули 1С:Предприятие 8: виды и области применения

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

Программный модуль в 1С:Предприятие 8 — это часть конфигурации, в которой описаны процедуры, функции и обработчики событий. Модуль не существует сам по себе: он относится к объекту конфигурации, форме, отчёту, обработке или приложению в целом.

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

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

Основные виды модулей конфигурации

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

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

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

Код нужен в формеИспользуйте модуль формы

Проверьте, достаточно ли клиентского контекста для работы с элементами управления

Нужна логика без экземпляра объектаМодуль менеджера объекта

Убедитесь, что метод помечен как серверный, если вызывается из серверного контекста

Код общий для нескольких объектовОбщий модуль

Выберите правильный режим выполнения при создании модуля

Модули объектов и менеджеров объектов

Когда используется модуль объекта

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

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

Когда используется модуль менеджера объекта

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

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

Модули форм и менеджеров форм

Модуль формы

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

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

Модуль менеджера формы

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

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

Модуль приложения, сеанса и общие модули

Модуль приложения и модуль сеанса

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

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

Общие модули и режимы выполнения

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

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

Где выполняется код: клиент, сервер, внешнее соединение

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

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

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

Как выбрать модуль и проверить результат

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

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

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

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

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

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

Итог

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

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

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

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

В чем разница между модулем объекта и модулем менеджера объекта?

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

Нужен ли модуль сеанса для обычной обработки?

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

Что делать, если код работает в толстом клиенте, но не в веб-клиенте?

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

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

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