Где задаются параметры сеанса в 1С и как их правильно заполнить

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

Задаются параметры сеанса в двух местах, которые часто путают. Первое — ветка метаданных «Параметры сеанса» в конфигураторе, где разработчик объявляет сам параметр: имя, тип данных и длину. Второе — программный код, который присваивает параметру конкретное значение при старте сеанса или в процессе работы. Объявление без присвоения оставляет параметр пустым, а присвоение без объявления невозможно.

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

Где в конфигураторе объявляются параметры сеанса

В конфигураторе параметры сеанса находятся в дереве метаданных: ветка «Общие» → «Параметры сеанса». Если дерево конфигурации открыто в стандартном виде, нужно развернуть узел «Общие» — там же расположены общие модули, роли, подсистемы. У каждого параметра есть имя, тип (любой допустимый тип, включая ссылки, списки значений и составные типы) и, для строк, длина.

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

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

Модуль сеанса и процедура УстановкаПараметровСеанса

Основное место, где задаются начальные значения параметров, — модуль сеанса. Он открывается из корня дерева конфигурации (контекстное меню корневого узла → «Открыть модуль сеанса»). В нём существует предопределённая процедура УстановкаПараметровСеанса, которую платформа вызывает при каждом старте сеанса — до открытия каких-либо форм.

Процедура получает параметр ТребуемыеПараметры — массив имён параметров, которые запросила платформа. Если сеанс стартует «холодно», массив пуст, и следует устанавливать все параметры. Если платформа обратилась за конкретными именами (например, при первом обращении к параметру из кода), достаточно заполнить только их — это экономит время запуска.

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

Процедура УстановкаПараметровСеанса(ТребуемыеПараметры) Экспорт

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

КонецПроцедуры

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

Как задать значение параметра из кода в любой момент

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

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

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

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

Где задаются параметры, влияющие на запуск сеанса

Часть «параметров сеанса» в широком смысле задаётся не в конфигурации, а в настройках подключения. В параметрах командной строки и диалоге запуска указываются режим (тонкий, толстый, веб-клиент), строка подключения к серверу 1С или файловой базе, имя пользователя. Эти значения определяют, как сеанс будет создан, ещё до того, как исполнится модуль сеанса.

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

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

Как проверить, что параметр установлен правильно

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

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

Косвенный признак корректной установки — поведение функционала, завязанного на параметр: отборы в списках, проверки прав, подстановка значений по умолчанию в документах. Если после входа документ подставляет не тот склад, а отладчик показывает пустой параметр, причина почти всегда в логике УстановкаПараметровСеанса: либо условие не сработало, либо поиск по данным вернул пустую ссылку.

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

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

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

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

Частые вопросы