ПараметрыСеанса.<Имя параметра сеанса>

Свойства · <Session parameter name>

Тип: Произвольный. Набор свойств содержит значения параметров сеанса. Доступ к значению осуществляется по имени. Имена свойств совпадают с именами параметров сеанса, как они заданы в Конфигураторе. Позволяет получить или установить значение одноименного параметра сеанса. Типы, допустимые для значения параметра сеанса, определяются при создании параметра сеанса в Конфигураторе. Среди допустимых могут быть следующие типы: Число; Строка; Дата; Булево; Неопределено; Null; ХранилищеЗначения; ФиксированныйМассив; ФиксированноеСоответствие; ФиксированнаяСтруктура; УникальныйИдентификатор; ОписаниеТипов; ВидСчета; ВидДвиженияБухгалтерии; ВидДвиженияНакопления; ДвоичныеДанные; ВидДвиженияНакопления; ВидСчета; ВидДвиженияБухгалтерии; Любая ссылка.

Полное описание, параметры и ограничения

ПараметрыСеанса.<Имя параметра сеанса> (SessionParameters.<Session parameter name>)

ПараметрыСеанса (SessionParameters)

<Имя параметра сеанса> (<Session parameter name>)

Доступен, начиная с версии 8.0.

Использование:
Чтение и запись.
Описание:
Тип: Произвольный.
Набор свойств содержит значения параметров сеанса. Доступ к значению осуществляется по имени. Имена свойств совпадают с именами параметров сеанса, как они заданы в Конфигураторе.
Позволяет получить или установить значение одноименного параметра сеанса. Типы, допустимые для значения параметра сеанса, определяются при создании параметра сеанса в Конфигураторе. Среди допустимых могут быть следующие типы:
Число;

Строка;

Дата;

Булево;

Неопределено;

Null;

ХранилищеЗначения;

ФиксированныйМассив;

ФиксированноеСоответствие;

ФиксированнаяСтруктура;

УникальныйИдентификатор;

ОписаниеТипов;

ВидСчета;

ВидДвиженияБухгалтерии;

ВидДвиженияНакопления;

ДвоичныеДанные;

ВидДвиженияНакопления;

ВидСчета;

ВидДвиженияБухгалтерии;

Любая ссылка.

Доступность:

Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.

Примечание:
При попытке обращения к неинициализированному параметру сеанса (в течении сеанса не происходило присвоение параметра) генерируется исключение.
Элементами значений типов ФиксированныйМассив, ФиксированноеСоответствие, ФиксированнаяСтруктура могут быть значения только перечисленных типов.
См. также:
Глобальный контекст, событие УстановкаПараметровСеанса

Использование в версии:

Доступен, начиная с версии 8.0.

Методическая информация

Практические примеры

Прочитать собственный инициализированный параметр сеанса

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

Где и как запускать

Модуль сеанса собственной учебной конфигурации и отдельная серверная процедура своей обработки.

Подготовка

  1. В отдельной пустой учебной конфигурации создайте параметр сеанса УчебныйПорог типа Число 10.0. Рабочие параметры, разделение данных и ограничения доступа не меняйте.

  2. Процедуру УстановкаПараметровСеанса разместите в модуле сеанса своей конфигурации. Не помечайте её &НаКлиенте и не вызывайте вручную: платформа передаёт ТребуемыеПараметры при старте либо отложенном чтении.

  3. Читающий фрагмент разместите в теле серверной процедуры своей учебной обработки. Он читает только собственный параметр и сравнивает с собственной суммой 150.

Порог = ПараметрыСеанса.УчебныйПорог;
Сумма = 3 * 50;
Превышен = Сумма > Порог;
Сообщить("Учебный порог: " + Строка(Порог));
Сообщить("Сумма 150 превышает порог: " + Строка(Превышен));
Модуль сеанса своей конфигурации: инициализатор параметра
Процедура УстановкаПараметровСеанса(ТребуемыеПараметры)
    Если ТребуемыеПараметры = Неопределено Тогда
        ПараметрыСеанса.УчебныйПорог = 100;
    ИначеЕсли ТребуемыеПараметры.Найти("УчебныйПорог") <> Неопределено Тогда
        ПараметрыСеанса.УчебныйПорог = 100;
    КонецЕсли;
КонецПроцедуры

Разбор по шагам

  1. Создаём в редакторе именно тот реквизит, элемент, параметр или модуль, имя которого используется кодом.

  2. Работаем с конкретным подготовленным владельцем динамического свойства.

  3. Проверяем изменение своей формы / результат расчёта, не обращаясь к рабочим данным.

Как проверить результат

  1. Чтение показывает УчебныйПорог = 100; сравнение 150 > 100 даёт Истина.

  2. Инициализатор устанавливает только собственное имя; после добавления других параметров им потребуется собственная логика.

Ожидаемый результат

Динамическое имя показано на собственном созданном контексте, а не на неизвестном входном объекте.

На что обратить внимание

  1. Имя внутри угловых скобок из справки не вставляется в код буквально: его заменяет имя реально созданной метадаты / колонки / элемента.

  2. Коллекция только для чтения может возвращать элемент с изменяемыми свойствами. Не присваивайте новый объект самому именованному свойству коллекции.

  3. Код 1С при сборке HTML не исполнялся; рабочая конфигурация и её данные не изменялись.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.