16 ноября 2026

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

Программный модуль в 1С — фрагмент кода на встроенном языке платформы, закреплённый за конкретным объектом метаданных или за конфигурацией в целом. Платформа 1С:Предприятие 8.3 различает 11 типов модулей: каждый выполняется в строго определённом контексте — только на клиенте, только на сервере или в обоих местах с разграничением через директивы компиляции.

Монитор разработчика с архитектурой программных модулей 1С

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

Что такое программный модуль в 1С

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

Структура: три раздела модуля

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

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

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

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

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

Контексты исполнения: клиент, сервер и варианты запуска

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

Только сервер: модуль объекта, менеджера, набора записей, сеанса. Код выполняется на сервере в любом сценарии — директивы компиляции не нужны.

Только клиент: модуль управляемого (или обычного) приложения. Реагирует на события запуска и завершения клиентского приложения.

Клиент + сервер: модуль формы и общие модули с флагами «Клиент» и «Сервер» одновременно. Разграничение внутри таких модулей задают директивы компиляции — &НаКлиенте и &НаСервере.

Платформа 1С:Предприятие 8.3 поддерживает три клиентских режима запуска: тонкий клиент, толстый клиент и веб-клиент. COM-соединение (интерфейс взаимодействия с внешними программами) — четвёртый вариант, без пользовательского интерфейса. Это влияет на то, какие модули запускаются вообще: при COM не запускается модуль приложения, но обязательно запускается модуль сеанса.

Виды модулей в 1С — полная классификация

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

Тип
Контекст
Доступные разделы
Назначение
Модуль управляемого приложения Клиент Переменные, Процедуры/функции, Основная программа Старт и завершение управляемого клиента
Модуль обычного приложения Клиент (толстый) Переменные, Процедуры/функции, Основная программа Старт и завершение в режиме обычного приложения
Модуль внешнего соединения Сервер Переменные, Процедуры/функции, Основная программа COM-сценарии без пользовательского интерфейса
Модуль сеанса Сервер Только процедуры/функции Инициализация параметров сеанса
Общий модуль Настраиваемый Только процедуры/функции Переиспользуемый код вне привязки к объекту
Модуль формы Клиент + сервер Переменные, Процедуры/функции, Основная программа Интерактивная работа пользователя с экраном
Модуль объекта Сервер Переменные, Процедуры/функции Логика одного экземпляра: справочник, документ
Модуль менеджера Сервер Только процедуры/функции Методы на уровне класса объектов
Модуль менеджера значения Сервер Только процедуры/функции Аналог объекта для констант
Модуль набора записей Сервер Переменные, Процедуры/функции Аналог объекта для регистров
Модуль команды Клиент/сервер Только процедуры/функции Выполнение команды объекта

Разобраться с модулями на практике — написать первые обработчики событий, создать общий модуль, разобрать структуру типовой конфигурации — поможет программа «1С Программист»: обучение с нуля, онлайн-формат, 144 часа, документ установленного образца.

Модули конфигурации: приложение, сеанс, внешнее соединение

Это модули, принадлежащие конфигурации в целом, а не конкретному объекту. Они управляют жизненным циклом приложения.

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

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

Модуль сеанса запускается первым при любом старте — и при интерактивном открытии, и при COM. Он привилегированный по умолчанию: не требует отдельного флага. Единственная задача — обработчик УстановкаПараметровСеанса. В этом модуле нельзя объявлять переменные и экспортные методы, раздела основной программы нет.

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

Порядок запуска при старте системы всегда фиксирован: сначала модуль сеанса, затем модуль приложения (или внешнего соединения), после — модули открываемых форм.

Порядок запуска модулей 1С: Сеанс, Приложение, Форма

Модули прикладных объектов: форма, объект, менеджер

Эти модули принадлежат конкретным объектам конфигурации.

Модуль формы обеспечивает интерактивное взаимодействие пользователя с экраном. Код выполняется и на клиенте, и на сервере — разделение задают директивы компиляции. Без директивы код компилируется на сервере.

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

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

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

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

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

Ветка Общие в дереве конфигурации 1С — общие модули

Пять флагов общего модуля и правила именования

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

Флаг
Что делает
Риски
Глобальный Методы доступны без имени модуля: ИмяМетода() Замедляет старт системы; захватывает глобальное пространство имён
Привилегированный Выполняется без проверки прав доступа Пользователь получает доступ к данным, которые ему не положены
Сервер Компилируется на сервере Нет доступа к пользовательскому интерфейсу
Клиент Компилируется на клиенте Нет доступа к базе данных
Вызов сервера Клиентский код может явно вызывать экспортные методы этого серверного модуля Создаёт явную точку перехода клиент → сервер

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

Флаг «Вызов сервера» нужен именно тогда, когда клиентский код должен напрямую обратиться к серверному методу. Без него клиент просто не видит серверный модуль.

Для структурирования имён общих модулей в типовых конфигурациях 1С принята суффиксная конвенция: суффикс имени отражает контекст и режим повторного использования. Четыре основных варианта: _Клиент — только клиент, _Сервер — только сервер, _КлиентСервер — смешанный контекст, _ПовтИсп — с кэшированием результатов.

Четыре суффикса имён общих модулей в 1С

Привилегированный режим и кэширование значений

Привилегированный режим отключает проверку прав доступа на время выполнения кода. Работает только на сервере. Пример: в 1С:ЗУП расчёт зарплаты обращается к данным сотрудников из привилегированного общего модуля — иначе каждая промежуточная операция проверяла бы права, что при больших объёмах ощутимо замедляет систему. Правило простое: помещайте в привилегированный модуль только изолированные алгоритмы. Никакой логики, которая зависит от прав конкретного пользователя.

Повторное использование позволяет кэшировать результаты функций общего модуля — актуально для вычислений, которые часто повторяются с одними и теми же аргументами. Настраивается тремя режимами: «Не использовать», «На время вызова», «На время сеанса». Время жизни кэша (TTL) при режиме «На время сеанса» — 20 минут. Флаг повторного использования несовместим с флагом «Глобальный»: кэширование работает только в не-глобальных модулях.

Модуль объекта в 1С

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

Обработчики событий модуля объекта

Модуль объекта реагирует на несколько стандартных событий жизненного цикла объекта.

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

Хотите сменить профессию или повысить квалификацию?

Федеральный проект «Активные меры содействия занятости» даёт возможность пройти обучение бесплатно за счёт государства

  • Программы от ведущих вузов России — от 2 месяцев
  • Удостоверение или диплом установленного образца
  • Центр карьеры: 7 500+ вакансий, помощь с трудоустройством
Оставить заявку
image

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

ОбработкаЗаполнения — вызывается при создании нового экземпляра объекта. Используется для заполнения значений по умолчанию — например, подставить текущую дату, организацию, ответственного.

ОбработкаПроведения — только у документов. Именно здесь формируются движения по регистрам бухгалтерии или накопления.

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

События модуля объекта в конфигураторе 1С: ПередЗаписью, ПриЗаписи

Модуль объекта vs Модуль менеджера

Начинающие разработчики часто путают два типа и выбирают не тот уровень.

Критерий
Модуль объекта
Модуль менеджера
Уровень Один экземпляр Весь класс объектов
Доступ Через ПолучитьОбъект() Через Справочники.X.МойМетод()
Скорость Медленнее (читает все данные объекта) Быстрее (нет загрузки данных)
Задачи Запись, проведение, заполнение, проверка Представление, печать группы, выбор по строке
Экспорт Экспортные методы и переменные Только экспортные методы

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

Модуль формы и директивы компиляции

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

Директивы компиляции: &НаКлиенте и &НаСервере

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

&НаКлиенте — код выполняется на клиентской машине. Доступны: пользовательский интерфейс (UI), файловая система клиента, диалоговые окна. Нет доступа к базе данных.

&НаСервере — код выполняется на сервере приложений. Доступны: база данных, файловая система сервера. Нет доступа к пользовательскому интерфейсу формы.

&НаСервереБезКонтекста — серверная процедура, которая не получает данные формы при вызове. Работает быстрее, чем &НаСервере, но не видит значений реквизитов формы.

Без директивы — Сервер.

Директивы компиляции НаКлиенте и НаСервере в модуле формы 1С

Управляемая форма vs обычная форма

Деление на управляемую и обычную форму параллельно делению приложений.

Управляемая форма — чёткое разграничение клиент/сервер. Директивы компиляции обязательны. Поддерживает тонкий клиент, веб-клиент и толстый клиент в режиме управляемого приложения.

Обычная форма — весь код выполняется на клиенте. Директивы не используются. Доступна только в толстом клиенте в режиме обычного приложения. Это унаследованный формат; новые разработки ведутся исключительно на управляемых формах.

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

Модули 1С в реальных конфигурациях

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

1С:Бухгалтерия и 1С:ЗУП

В 1С:Бухгалтерия бухгалтерская логика сосредоточена в модулях объектов документов: «Поступление товаров и услуг», «Реализация товаров и услуг», «Начисление зарплаты». Вся логика формирования проводок — в обработчике ОбработкаПроведения. Система обходит табличные части документа, рассчитывает суммы и создаёт движения по счетам в регистре бухгалтерии. Именно поэтому изменения в логике проводок всегда ищут в модуле объекта соответствующего документа.

В 1С:ЗУП расчёт заработной платы — классический пример привилегированного общего модуля. Алгоритм расчёта обращается к данным нескольких объектов: сотрудников, видов начислений, удержаний. Выполнение без проверки прав ускоряет обработку при расчёте для крупных организаций с сотнями и тысячами сотрудников.

Процедура ОбработкаПроведения в типовой конфигурации 1С

Модули в 1С:ERP

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

Флаг «Вызов сервера» в ERP активно задействован: клиентские формы производственного планирования вызывают серверные методы расчёта через общие модули с этим флагом. Граница клиент — сервер явная, точки перехода документированы в именах модулей и их флагах.

Часто задаваемые вопросы

Что такое программный модуль 1С простыми словами?

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

Сколько типов модулей есть в 1С и какие?

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

Как вызвать общий модуль в 1С?

Не-глобальный — через ИмяМодуля.ИмяПроцедуры(). Если у модуля установлен флаг «Глобальный», процедуры доступны напрямую: ИмяПроцедуры(). Флаг «Глобальный» не рекомендуется применять массово: он замедляет старт системы и занимает имена в глобальном пространстве имён.

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

Модуль объекта работает на уровне одного экземпляра: для обращения нужен ПолучитьОбъект(), который читает все данные. Модуль менеджера — уровень всего класса: Справочники.X.МойМетод() без загрузки данных, быстрее. Менеджер подходит для представления, печати группы и выбора по строке.

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

Модуль сеанса нужен для инициализации параметров сеанса: запускается первым при любом старте — и интерактивном, и через COM. Модуль приложения нужен для реакции на открытие окна клиента; при COM-соединении он не запускается. В модуле сеанса нельзя объявлять переменные и экспортные методы.

Что такое «Вызов сервера» в свойствах общего модуля?

Флаг «Вызов сервера» разрешает клиентскому коду явно вызывать экспортные методы этого серверного модуля. По умолчанию клиент не видит серверные модули. Флаг создаёт явную точку перехода клиент → сервер — без него такой вызов невозможен.

Чем опасен флаг «Привилегированный» у общего модуля?

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

Когда модуль объекта срабатывает при записи, а когда — нет?

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

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

45 000 мест на 2026 год. Бесплатное обучение по федеральному проекту «Активные меры содействия занятости»

  • Онлайн
  • От 2 месяцев
  • Бесплатно
  • Диплом
Учиться бесплатно
icon