Событие предназначено для инициализации параметров сеанса. Вызывается системой: при установке соединения с информационной базой до вызова всех остальных обработчиков. Значение параметра "Параметры сеанса" - Неопределено; перед фактическим использованием значений параметров сеанса, которые не были инициализированы ранее. В этом случае значением параметра "Параметры сеанса" является массив идентификаторов неинициализированных параметров сеанса, значения которых используются. Если после выполнения обработчика хотя бы один из перечисленных параметров сеанса остается неинициализированным, то генерируется исключение.
Синтаксис
УстановкаПараметровСеанса(<ТребуемыеПараметры>)Полное описание, параметры и ограничения
Глобальный контекст.УстановкаПараметровСеанса (Global context.SessionParametersSetting)
Глобальный контекст (Global context)
УстановкаПараметровСеанса (SessionParametersSetting)
Доступен, начиная с версии 8.1.
Синтаксис:
УстановкаПараметровСеанса(<ТребуемыеПараметры>)
Параметры:
<ТребуемыеПараметры>
Тип: Массив, Неопределено.
Массив устанавливаемых идентификаторов параметров сеанса, которые нужно инициализировать, если обработчик вызывается перед использованием неинициализированных параметров сеанса.
Неопределено, если обработчик события вызывается системой при начале сеанса.
Описание:
Событие предназначено для инициализации параметров сеанса.
Вызывается системой:
при установке соединения с информационной базой до вызова всех остальных обработчиков. Значение параметра "Параметры сеанса" - Неопределено;
перед фактическим использованием значений параметров сеанса, которые не были инициализированы ранее. В этом случае значением параметра "Параметры сеанса" является массив идентификаторов неинициализированных параметров сеанса, значения которых используются. Если после выполнения обработчика хотя бы один из перечисленных параметров сеанса остается неинициализированным, то генерируется исключение.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение.
См. также:
Глобальный контекст, свойство ПараметрыСеанса
ПараметрыСеанса
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Инициализировать свой параметр при старте и отложенном чтении
Собственный параметр сеанса имеет конкретное имя и числовой тип. Инициализатор обрабатывает и начальный вызов с Неопределено, и массив требуемых имён.
Где и как запускать
Модуль сеанса собственной учебной конфигурации и отдельная серверная процедура своей обработки.
Подготовка
В отдельной пустой учебной конфигурации создайте параметр сеанса УчебныйПорог типа Число 10.0. Рабочие параметры, разделение данных и ограничения доступа не меняйте.
Процедуру УстановкаПараметровСеанса разместите в модуле сеанса своей конфигурации. Не помечайте её &НаКлиенте и не вызывайте вручную: платформа передаёт ТребуемыеПараметры при старте либо отложенном чтении.
Читающий фрагмент разместите в теле серверной процедуры своей учебной обработки. Он читает только собственный параметр и сравнивает с собственной суммой 150.
Процедура УстановкаПараметровСеанса(ТребуемыеПараметры)
Если ТребуемыеПараметры = Неопределено Тогда
ПараметрыСеанса.УчебныйПорог = 100;
ИначеЕсли ТребуемыеПараметры.Найти("УчебныйПорог") <> Неопределено Тогда
ПараметрыСеанса.УчебныйПорог = 100;
КонецЕсли;
КонецПроцедурыСерверная процедура обработки: прочитать свой инициализированный параметр
Порог = ПараметрыСеанса.УчебныйПорог;
Сумма = 3 * 50;
Превышен = Сумма > Порог;
Сообщить("Учебный порог: " + Строка(Порог));
Сообщить("Сумма 150 превышает порог: " + Строка(Превышен));Разбор по шагам
Создаём в редакторе именно тот реквизит, элемент, параметр или модуль, имя которого используется кодом.
Работаем с конкретным подготовленным владельцем динамического свойства.
Проверяем изменение своей формы / результат расчёта, не обращаясь к рабочим данным.
Как проверить результат
Чтение показывает УчебныйПорог = 100; сравнение 150 > 100 даёт Истина.
Инициализатор устанавливает только собственное имя; после добавления других параметров им потребуется собственная логика.
Ожидаемый результат
Динамическое имя показано на собственном созданном контексте, а не на неизвестном входном объекте.
На что обратить внимание
Имя внутри угловых скобок из справки не вставляется в код буквально: его заменяет имя реально созданной метадаты / колонки / элемента.
Коллекция только для чтения может возвращать элемент с изменяемыми свойствами. Не присваивайте новый объект самому именованному свойству коллекции.
Код 1С при сборке HTML не исполнялся; рабочая конфигурация и её данные не изменялись.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.