Просмотр исходного текста страницы Модуль сеанса 1Сv8

[[Категория: Программирование в 1Cv8]]
{| align="right"
| __TOC__
|}
===Модуль сеанса===

Модулем сеанса называется модуль, который автоматически выполняется при старте системы 1С:Предприятие 8 в момент загрузки конфигурации. 

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

{{notice|Модуль сеанса может содержать только определения процедур и функций. }}

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

{{notice|Модуль сеанса может вызывать только процедуры и функции, доступные в режиме '''сервера'''. }}

Модуль сеанса '''должен''' содержать обработчик УстановкаПараметровСеанса (SessionParametersSetting), другим способом он не может получить управление.

==Особенности==
При старте системы процедуры модуля сеанса вызываются в момент, когда интерфейс ещё не инициализирован, поэтому любые функции вывода (например, '''"Сообщить"''') там не работают, хотя и не вызывают ошибок.

Первый вызов процедуры '''"УстановкаПараметровСеанса"''' - это самый первый программно доступный обработчик событий.

Уже '''''после него''''' вызываются обработчики ПередНачаломРаботыСистемы и ПриНачалеРаботыСистемы модулей клиенских приложений.

==Обработчики событий==
===УстановкаПараметровСеанса===
====Синтаксис:====
УстановкаПараметровСеанса(<Параметры сеанса>)
====Параметры:====
=====<Параметры сеанса>=====
Тип: Массив; Неопределено. 

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

Неопределено, если обработчик события вызывается системой при начале сеанса или при захвате соединения из пула.

====Описание:====
Событие предназначено для инициализации параметров сеанса. 

====Вызывается системой:====
*при установке соединения с информационной базой или при захвате соединения с информационной базой из пула до вызова всех остальных обработчиков. Значение параметра "Параметры сеанса" - Неопределено;
*перед фактическим использованием значений параметров сеанса, которые не были инициализированы ранее. В этом случае значением параметра "Параметры сеанса" является массив идентификаторов неинициализированных параметров сеанса, значения которых используются. Если после выполнения обработчика хотя бы один из перечисленных параметров сеанса остается неинициализированным, то возникает исключение.