Когда инициируются параметры сеанса в 1С

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

Инициализация происходит в момент старта сеанса — при входе пользователя в информационную базу, при запуске фонового задания, при подключении через веб-сервис или COM-соединение. Платформа вызывает обработчик УстановкаПараметровСеанса модуля сеанса, передавая в него массив имён требуемых параметров. Разработчик обязан присвоить значения всем запрошенным параметрам либо явно удалить их имя из массива, иначе платформа выдаст ошибку.

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

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

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

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

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

Когда именно вызывается обработчик УстановкаПараметровСеанса

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

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

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

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

Сценарии инициализации для разных типов сеансов

Момент инициализации зависит от того, как создаётся сеанс. Для интерактивного входа пользователя обработчик выполняется сразу после успешной аутентификации — до открытия главного окна и до события ПередНачаломРаботыСистемы. Если обработчик завершился ошибкой, пользователь увидит сообщение об ошибке и не попадёт в систему.

Фоновые задания

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

Веб-сервисы, HTTP-сервисы и внешние соединения

При обращении к веб-сервису или HTTP-сервису создаётся сеанс с аутентификацией, указанной в публикации или в запросе. Обработчик выполняется для каждого такого сеанса. При COM-соединении и соединении через внешнее соединение инициализация также происходит — в сеансе внешнего соединения.

Регламентные задания и сеанс планировщика

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

Порядок установки значений и требования платформы

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

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

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

1. 1
   Откройте модуль сеанса и создайте экспортную процедуру УстановкаПараметровСеанса с параметром ТребуемыеПараметры
2. 2
   Добавьте проверку: если ТребуемыеПараметры = Неопределено — выйти из процедуры
3. 3
   Для каждого параметра проверьте наличие его имени в массиве через Найти()
4. 4
   Установите значение через ПараметрыСеанса.ИмяПараметра и удалите имя из массива методом Удалить()
5. 5
   Предусмотрите ветку для фоновых и служебных сеансов со значением по умолчанию
6. 6
   Протестируйте вход интерактивным пользователем и запуск фонового задания

Типичные ошибки и их последствия

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

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

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

Как проверить и отладить инициализацию

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

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

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

Ограничения и альтернативные подходы

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

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

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

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