Как открыть модуль сеанса в 1С и что в нём настраивать

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

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

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

Что такое модуль сеанса и когда он выполняется

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

Главное событие модуля — обработчик УстановкаПараметровСеанса(ИменаПараметровСеанса). Он вызывается платформой, когда прикладной код впервые обращается к параметру сеанса, и позволяет присвоить ему значение. Типовой пример — установка текущего пользователя, параметров учёта, ограничений доступа к данным.

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

Требования перед открытием: права и режим работы

Чтобы открыть модуль сеанса, нужно запустить программу в режиме «Конфигуратор», а не «1С:Предприятие». Пользователь, под которым выполняется вход, должен обладать правами на администрирование и изменение конфигурации — обычно это роль с полными правами или право «Администрирование» и «Обновление конфигурации базы данных».

Если конфигурация закрыта для редактирования (стоит запрет изменений у поставщика или включён режим поддержки без возможности изменения), модуль откроется только на просмотр. Для правки потребуется снять объект с поддержки или включить возможность изменения через меню «Конфигурация → Поддержка → Настройка поддержки».

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

Пошаговая инструкция: как открыть модуль сеанса

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

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

1. 1
   Запустите ярлык 1С, выберите нужную информационную базу и нажмите кнопку «Конфигуратор».
2. 2
   Войдите под пользователем с правами на изменение конфигурации.
3. 3
   Выполните команду меню «Конфигурация → Открыть конфигурацию» и дождитесь построения дерева объектов.
4. 4
   В дереве конфигурации раскройте корневой узел (строка с именем конфигурации) и найдите ветку «Общие».
5. 5
   Внутри ветки «Общие» найдите строку «Модуль сеанса» и дважды щёлкните по ней левой кнопкой мыши.
6. 6
   Модуль откроется в редакторе кода. Внесите изменения и сохраните конфигурацию (Ctrl+S), затем обновите конфигурацию базы данных (F7).

Альтернативный способ через свойства конфигурации

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

Если строка «Модуль сеанса» не видна

В редких случаях узел может не отображаться из-за фильтра в окне конфигурации или потому, что дерево открыто в режиме просмотра по подсистемам. Переключитесь на полный режим просмотра объектов или воспользуйтесь поиском по дереву (Ctrl+F в окне конфигурации).

Что обычно размещают в модуле сеанса

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

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

Процедура УстановкаПараметровСеанса(ИменаПараметровСеанса) Экспорт
	// Пример: установка параметра текущего пользователя
	ПараметрыСеанса.ТекущийПользователь = Справочники.Пользователи.НайтиПоНаименованию(ИмяПользователя());
КонецПроцедуры

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

Сохранение изменений и проверка результата

После правки модуля недостаточно просто сохранить текст — нужно обновить конфигурацию базы данных. Для этого нажмите F7 или выполните «Конфигурация → Обновить конфигурацию базы данных». В клиент-серверном режиме потребуется монопольный доступ: завершите сеансы пользователей через консоль кластера или дождитесь, пока все выйдут.

Проверка результата выполняется простым входом в режим «1С:Предприятие». Если сеанс стартует без ошибок и параметры сеанса получают ожидаемые значения — изменения применены корректно. Дополнительно полезно открыть журнал регистрации и убедиться в отсутствии новых ошибок, связанных с инициализацией сеанса.

Типичные ошибки и ограничения

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

Ещё одна ловушка — рекурсивная установка параметров: если при установке параметра А код читает параметр Б, который в свою очередь зависит от А, платформа зациклит вызовы обработчика. Такие зависимости нужно разрывать, вычисляя значения локально.

FAQ