Программный модуль в 1С — фрагмент кода на встроенном языке платформы, закреплённый за конкретным объектом метаданных или за конфигурацией в целом. Платформа 1С:Предприятие 8.3 различает 11 типов модулей: каждый выполняется в строго определённом контексте — только на клиенте, только на сервере или в обоих местах с разграничением через директивы компиляции.
Знать, какой тип модуля за что отвечает, важно с первых шагов разработки. Ошибка в выборе места размещения кода — частая причина, по которой событие не срабатывает или данные оказываются недоступны. Эта статья охватывает полную классификацию всех 11 типов, флаги и суффиксы общих модулей, сравнение модуля объекта с модулем менеджера, а также примеры применения в реальных конфигурациях: 1С:Бухгалтерия, 1С:ЗУП и 1С:ERP.
Формально модуль в 1С — файл с кодом на встроенном языке, размещённый в определённом месте конфигурации. Он принадлежит либо конкретному объекту метаданных: справочнику, документу, форме — либо конфигурации целиком: модуль приложения или сеанса. Модуль может быть пустым: платформа не требует, чтобы в нём находилась хоть одна строка кода.
Любой программный модуль состоит из трёх разделов, которые следуют строго в заданном порядке.
Раздел объявления переменных — переменные, доступные во всех процедурах и функциях этого модуля. Объявляются ключевым словом Перем. Переменные с ключевым словом Экспорт становятся частью внешнего интерфейса объекта и доступны из внешнего кода.
Раздел процедур и функций — единственный раздел, доступный в любом типе модуля без исключения. Здесь размещается основная логика: процедуры, функции и обработчики событий.
Раздел основной программы — выполняется однократно при первом обращении к модулю: при открытии формы или инициализации объекта. Удобен для начальной настройки переменных модуля на нужные значения.
Не все разделы доступны везде. В общем модуле, например, присутствует только раздел процедур и функций — переменные и основная программа недоступны. Это ограничение определяется типом модуля, а не настройками разработчика.
Контекст определяет, где физически выполняется код: на клиентской машине или на сервере приложений. Это разграничение стало обязательным условием архитектуры тонкого клиента.
Только сервер: модуль объекта, менеджера, набора записей, сеанса. Код выполняется на сервере в любом сценарии — директивы компиляции не нужны.
Только клиент: модуль управляемого (или обычного) приложения. Реагирует на события запуска и завершения клиентского приложения.
Клиент + сервер: модуль формы и общие модули с флагами «Клиент» и «Сервер» одновременно. Разграничение внутри таких модулей задают директивы компиляции — &НаКлиенте и &НаСервере.
Платформа 1С:Предприятие 8.3 поддерживает три клиентских режима запуска: тонкий клиент, толстый клиент и веб-клиент. COM-соединение (интерфейс взаимодействия с внешними программами) — четвёртый вариант, без пользовательского интерфейса. Это влияет на то, какие модули запускаются вообще: при COM не запускается модуль приложения, но обязательно запускается модуль сеанса.
Одиннадцать типов модулей в 1С делятся на три группы по принадлежности: модули конфигурации, общие модули и модули прикладных объектов. Таблица ниже — все типы с контекстом, доступными разделами и назначением.
| Тип |
Контекст |
Доступные разделы |
Назначение |
|---|---|---|---|
| Модуль управляемого приложения | Клиент | Переменные, Процедуры/функции, Основная программа | Старт и завершение управляемого клиента |
| Модуль обычного приложения | Клиент (толстый) | Переменные, Процедуры/функции, Основная программа | Старт и завершение в режиме обычного приложения |
| Модуль внешнего соединения | Сервер | Переменные, Процедуры/функции, Основная программа | COM-сценарии без пользовательского интерфейса |
| Модуль сеанса | Сервер | Только процедуры/функции | Инициализация параметров сеанса |
| Общий модуль | Настраиваемый | Только процедуры/функции | Переиспользуемый код вне привязки к объекту |
| Модуль формы | Клиент + сервер | Переменные, Процедуры/функции, Основная программа | Интерактивная работа пользователя с экраном |
| Модуль объекта | Сервер | Переменные, Процедуры/функции | Логика одного экземпляра: справочник, документ |
| Модуль менеджера | Сервер | Только процедуры/функции | Методы на уровне класса объектов |
| Модуль менеджера значения | Сервер | Только процедуры/функции | Аналог объекта для констант |
| Модуль набора записей | Сервер | Переменные, Процедуры/функции | Аналог объекта для регистров |
| Модуль команды | Клиент/сервер | Только процедуры/функции | Выполнение команды объекта |
Разобраться с модулями на практике — написать первые обработчики событий, создать общий модуль, разобрать структуру типовой конфигурации — поможет программа «1С Программист»: обучение с нуля, онлайн-формат, 144 часа, документ установленного образца.
Это модули, принадлежащие конфигурации в целом, а не конкретному объекту. Они управляют жизненным циклом приложения.
Модуль управляемого приложения запускается при старте тонкого клиента, веб-клиента или толстого клиента в режиме управляемого приложения. Содержит обработчики ПередНачаломРаботыСистемы, ПриНачалеРаботыСистемы и соответствующие события завершения. При COM-соединении не запускается — это принципиальное ограничение.
Модуль обычного приложения аналогичен по набору событий, но работает только при запуске в режиме обычного приложения (толстый клиент с флагом «Обычное приложение»).
Модуль сеанса запускается первым при любом старте — и при интерактивном открытии, и при COM. Он привилегированный по умолчанию: не требует отдельного флага. Единственная задача — обработчик УстановкаПараметровСеанса. В этом модуле нельзя объявлять переменные и экспортные методы, раздела основной программы нет.
Модуль внешнего соединения аналогичен модулю приложения, но работает исключительно при COM-соединении. Нет диалоговых форм и пользовательского интерфейса. Экспортные методы этого модуля доступны вызывающей стороне — внешней программе, подключившейся через COM.
Порядок запуска при старте системы всегда фиксирован: сначала модуль сеанса, затем модуль приложения (или внешнего соединения), после — модули открываемых форм.

Эти модули принадлежат конкретным объектам конфигурации.
Модуль формы обеспечивает интерактивное взаимодействие пользователя с экраном. Код выполняется и на клиенте, и на сервере — разделение задают директивы компиляции. Без директивы код компилируется на сервере.
Модуль объекта хранит прикладную логику одного экземпляра: одного элемента справочника, одного документа. Выполняется только на сервере. Содержит обработчики событий записи, проведения, удаления и заполнения. Экспортные методы и переменные расширяют программный интерфейс объекта.
Модуль менеджера работает на уровне класса объектов, а не одного экземпляра. Не требует загрузки данных объекта в память, поэтому быстрее при массовых операциях.
Модуль менеджера значения — аналог модуля объекта для констант. Модуль набора записей — аналог для регистров сведений, накопления и бухгалтерии. Модуль команды работает на клиенте или на сервере в зависимости от настройки: предопределённых обработчиков событий нет, только пользовательские процедуры.
Общий модуль хранит код, который нужен в разных местах конфигурации. Вместо копирования одной и той же функции в несколько объектов — описываешь её один раз в общем модуле, вызываешь откуда угодно: ИмяМодуля.ИмяМетода(). Единственный доступный раздел — процедуры и функции; переменные и основная программа недоступны. Общие модули хранятся в ветке «Общие» дерева конфигурации.

Поведение общего модуля полностью определяется набором флагов в его свойствах. Пять флагов можно включать в разных комбинациях — но некоторые сочетания создают серьёзные проблемы.
| Флаг |
Что делает |
Риски |
|---|---|---|
| Глобальный | Методы доступны без имени модуля: ИмяМетода() | Замедляет старт системы; захватывает глобальное пространство имён |
| Привилегированный | Выполняется без проверки прав доступа | Пользователь получает доступ к данным, которые ему не положены |
| Сервер | Компилируется на сервере | Нет доступа к пользовательскому интерфейсу |
| Клиент | Компилируется на клиенте | Нет доступа к базе данных |
| Вызов сервера | Клиентский код может явно вызывать экспортные методы этого серверного модуля | Создаёт явную точку перехода клиент → сервер |
Флаг «Глобальный» удобен для часто используемых вспомогательных функций, но опасен при массовом применении. Методы глобального модуля компилируются при каждом старте системы — это замедляет запуск. Имена методов попадают в глобальное пространство и могут конфликтовать с именами встроенных функций платформы.
Флаг «Вызов сервера» нужен именно тогда, когда клиентский код должен напрямую обратиться к серверному методу. Без него клиент просто не видит серверный модуль.
Для структурирования имён общих модулей в типовых конфигурациях 1С принята суффиксная конвенция: суффикс имени отражает контекст и режим повторного использования. Четыре основных варианта: _Клиент — только клиент, _Сервер — только сервер, _КлиентСервер — смешанный контекст, _ПовтИсп — с кэшированием результатов.

Привилегированный режим отключает проверку прав доступа на время выполнения кода. Работает только на сервере. Пример: в 1С:ЗУП расчёт зарплаты обращается к данным сотрудников из привилегированного общего модуля — иначе каждая промежуточная операция проверяла бы права, что при больших объёмах ощутимо замедляет систему. Правило простое: помещайте в привилегированный модуль только изолированные алгоритмы. Никакой логики, которая зависит от прав конкретного пользователя.
Повторное использование позволяет кэшировать результаты функций общего модуля — актуально для вычислений, которые часто повторяются с одними и теми же аргументами. Настраивается тремя режимами: «Не использовать», «На время вызова», «На время сеанса». Время жизни кэша (TTL) при режиме «На время сеанса» — 20 минут. Флаг повторного использования несовместим с флагом «Глобальный»: кэширование работает только в не-глобальных модулях.
Модуль объекта содержит прикладную логику одного конкретного экземпляра: одного элемента справочника, одного документа, одной записи. Он выполняется исключительно на сервере — директивы компиляции не нужны. Экспортные методы и переменные этого модуля расширяют программный интерфейс объекта: к ним можно обратиться из внешнего кода через переменную, ссылающуюся на объект.
Модуль объекта реагирует на несколько стандартных событий жизненного цикла объекта.
ПередЗаписью — срабатывает непосредственно до записи. Здесь можно изменить данные объекта: добавить реквизиты, проверить условия, отменить запись через параметр Отказ.
Хотите сменить профессию или повысить квалификацию?
Федеральный проект «Активные меры содействия занятости» даёт возможность пройти обучение бесплатно за счёт государства
ПриЗаписи — объект уже записан в базу, но транзакция ещё не завершена. Это окно используют для записи связанных данных: документов-движений, записей регистров сведений.
ОбработкаЗаполнения — вызывается при создании нового экземпляра объекта. Используется для заполнения значений по умолчанию — например, подставить текущую дату, организацию, ответственного.
ОбработкаПроведения — только у документов. Именно здесь формируются движения по регистрам бухгалтерии или накопления.
Ключевое отличие от модуля формы: события объекта срабатывают при любой записи — и интерактивной через форму, и программной, когда объект записывается кодом без открытия формы. Поэтому бизнес-проверки надёжнее размещать именно здесь.

Начинающие разработчики часто путают два типа и выбирают не тот уровень.
| Критерий |
Модуль объекта |
Модуль менеджера |
|---|---|---|
| Уровень | Один экземпляр | Весь класс объектов |
| Доступ | Через ПолучитьОбъект() | Через Справочники.X.МойМетод() |
| Скорость | Медленнее (читает все данные объекта) | Быстрее (нет загрузки данных) |
| Задачи | Запись, проведение, заполнение, проверка | Представление, печать группы, выбор по строке |
| Экспорт | Экспортные методы и переменные | Только экспортные методы |
Выбирайте модуль менеджера там, где не нужен доступ к полным данным экземпляра: ОбработкаПолученияПредставления, ОбработкаПолученияДанныхВыбора, печать группы документов. Если задача требует изменения реквизитов или движений по регистрам — работайте через модуль объекта.
Модуль формы обеспечивает логику интерактивного взаимодействия: реакцию на нажатия кнопок, изменения полей, открытие и закрытие формы. Он работает в смешанном контексте — одновременно на клиенте и на сервере. Раздел основной программы выполняется при открытии формы. Код без явной директивы компиляции по умолчанию помещается на сервер.
Директивы компиляции — аннотации перед процедурой или функцией, которые указывают платформе, где выполнять этот код. В модуле формы и в общих модулях с флагом «КлиентСервер» они обязательны для разграничения контекста.
&НаКлиенте — код выполняется на клиентской машине. Доступны: пользовательский интерфейс (UI), файловая система клиента, диалоговые окна. Нет доступа к базе данных.
&НаСервере — код выполняется на сервере приложений. Доступны: база данных, файловая система сервера. Нет доступа к пользовательскому интерфейсу формы.
&НаСервереБезКонтекста — серверная процедура, которая не получает данные формы при вызове. Работает быстрее, чем &НаСервере, но не видит значений реквизитов формы.
Без директивы — Сервер.

Деление на управляемую и обычную форму параллельно делению приложений.
Управляемая форма — чёткое разграничение клиент/сервер. Директивы компиляции обязательны. Поддерживает тонкий клиент, веб-клиент и толстый клиент в режиме управляемого приложения.
Обычная форма — весь код выполняется на клиенте. Директивы не используются. Доступна только в толстом клиенте в режиме обычного приложения. Это унаследованный формат; новые разработки ведутся исключительно на управляемых формах.
Событие записи в управляемой форме появляется только у форм объектов — справочников, документов. В форме отчёта или обработки такого события нет.
Архитектура модулей одинакова во всех конфигурациях — различается лишь то, как типовые решения её используют. Три ведущие конфигурации демонстрируют разные паттерны применения одних и тех же инструментов. Разработчикам, работающим с типовыми решениями, важно понимать не только что такое модуль в 1С, но и какой тип применяется в конкретном бизнес-сценарии.
В 1С:Бухгалтерия бухгалтерская логика сосредоточена в модулях объектов документов: «Поступление товаров и услуг», «Реализация товаров и услуг», «Начисление зарплаты». Вся логика формирования проводок — в обработчике ОбработкаПроведения. Система обходит табличные части документа, рассчитывает суммы и создаёт движения по счетам в регистре бухгалтерии. Именно поэтому изменения в логике проводок всегда ищут в модуле объекта соответствующего документа.
В 1С:ЗУП расчёт заработной платы — классический пример привилегированного общего модуля. Алгоритм расчёта обращается к данным нескольких объектов: сотрудников, видов начислений, удержаний. Выполнение без проверки прав ускоряет обработку при расчёте для крупных организаций с сотнями и тысячами сотрудников.

В 1С:ERP цепочки модулей менеджера координируют сложные бизнес-процессы: производственные заказы, маршрутные листы, потребности в ресурсах. Принцип — один общий модуль, одна функциональная область. Это удерживает конфигурацию от разрастания в неструктурированную массу и упрощает доработки.
Флаг «Вызов сервера» в ERP активно задействован: клиентские формы производственного планирования вызывают серверные методы расчёта через общие модули с этим флагом. Граница клиент — сервер явная, точки перехода документированы в именах модулей и их флагах.
Программный модуль — файл с кодом на встроенном языке, принадлежащий объекту метаданных или конфигурации. Платформа 1С:Предприятие 8.3 различает 11 типов; каждый выполняется в своём контексте и обрабатывает определённые события. Модуль может быть пустым — платформа не требует содержимого.
Одиннадцать: модуль управляемого и обычного приложения, внешнего соединения, сеанса, общие модули, модуль формы, объекта, менеджера, менеджера значения, набора записей и команды. Каждый тип определяется контекстом исполнения и набором доступных разделов.
Не-глобальный — через ИмяМодуля.ИмяПроцедуры(). Если у модуля установлен флаг «Глобальный», процедуры доступны напрямую: ИмяПроцедуры(). Флаг «Глобальный» не рекомендуется применять массово: он замедляет старт системы и занимает имена в глобальном пространстве имён.
Модуль объекта работает на уровне одного экземпляра: для обращения нужен ПолучитьОбъект(), который читает все данные. Модуль менеджера — уровень всего класса: Справочники.X.МойМетод() без загрузки данных, быстрее. Менеджер подходит для представления, печати группы и выбора по строке.
Модуль сеанса нужен для инициализации параметров сеанса: запускается первым при любом старте — и интерактивном, и через COM. Модуль приложения нужен для реакции на открытие окна клиента; при COM-соединении он не запускается. В модуле сеанса нельзя объявлять переменные и экспортные методы.
Флаг «Вызов сервера» разрешает клиентскому коду явно вызывать экспортные методы этого серверного модуля. По умолчанию клиент не видит серверные модули. Флаг создаёт явную точку перехода клиент → сервер — без него такой вызов невозможен.
Привилегированный модуль исполняется без проверки прав: пользователь получает доступ к данным, которые ему не положены. Используйте только для массовых алгоритмов — расчёт зарплаты, перепроведение. Изолируйте такие процедуры и не помещайте туда код, зависящий от прав конкретного пользователя.
Событие в модуле объекта срабатывает при любой записи — и интерактивной через форму, и программной. Событие в модуле формы — только при записи через конкретную открытую форму. Если объект записывается кодом без формы, сработает только модуль объекта. Поэтому проверки данных надёжнее размещать именно в модуле объекта.
Подайте заявку — забронируйте место в группе
45 000 мест на 2026 год. Бесплатное обучение по федеральному проекту «Активные меры содействия занятости»