Параметры сеанса в 1С: что это, зачем нужны и как их использовать

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

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

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

Что такое параметр сеанса и чем он отличается от других хранилищ

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

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

Основные задачи, которые решают параметры сеанса

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

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

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

Как создать и установить параметр сеанса

Создание выполняется в конфигураторе: откройте ветку «Общие → Параметры сеанса», добавьте новый параметр, задайте имя и тип. Если параметр будет использоваться в RLS, тип должен точно совпадать с типом поля, с которым он сравнивается в шаблоне, иначе ограничение не скомпилируется или будет работать некорректно.

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

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

Чтение в прикладном коде выглядит просто: ПараметрыСеанса.ТекущийПользователь. Если параметр не был установлен, платформа автоматически вызовет обработчик установки. Если и после обработчика значение не задано, при обращении возникнет исключение — это частая причина ошибок «Параметр сеанса не установлен» у пользователей.

1. 1
   Откройте конфигуратор, ветка Общие → Параметры сеанса, добавьте параметр и укажите тип
2. 2
   В модуле сеанса в обработчике УстановкаПараметровСеанса добавьте код установки для этого имени
3. 3
   Проверьте, что при отсутствии данных устанавливается безопасное значение по умолчанию (пустая ссылка, Ложь)
4. 4
   Обновите конфигурацию базы данных и перезайдите в сеанс
5. 5
   Проверьте чтение параметра в клиентском коде и в отладчике

Особенности работы обработчика установки параметров

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

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

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

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

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

Третья группа проблем связана с фоновыми заданиями и внешними соединениями. Фоновое задание наследует параметры сеанса родительского сеанса в момент запуска, но дальше живёт со своей копией. При COM-соединении и веб-сервисах обработчик установки параметров также вызывается, и если он завязан на интерактивные возможности (например, на клиентский контекст), соединение завершится ошибкой.

Как проверить и отладить параметры сеанса

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

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

Если ошибка «параметр сеанса не установлен» возникает только у части пользователей, проверьте, что обработчик корректно обрабатывает случаи, когда пользователь не найден в справочнике или у него не заполнены ключевые реквизиты. Безопасный приём — устанавливать пустую ссылку или значение по умолчанию, а прикладной код должен уметь работать с таким значением.

Когда параметры сеанса использовать не стоит

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

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

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