RestoreValue

RestoreValue (Серверные функции)
Объект: Функции общего назначения Статус разработки: Реализована Тип: Функция Обращение к БД: Сервер Исключения: Невозможно превратить в строку Визуальность: Нет

• Начальная страница
• Общее описание
• Объекты
• Функции общего назначения

Функция получает, сохраненное ранее на сервере для текущего пользователя произвольное значение с выбранным именем. Функция работает только если клиент имеет подключение к серверу. Если значение с указанным именем не было сохранено, будет возвращено пустое значение. Cохраняемые значения существуют вне сессии, даже если сервер будет выключен и включен, значение по-прежнему будет доступно для пользователя с текущим именем. Функция позволяет хранить установки пользователя, не связанные с формами и системой (к примеру, предпочитаемое для него количество знаков после точки при выводе в отчеты вещественных чисел и пр.).

Синтаксис

RestoreValue(<Имя переменной (STRING)>):<Значение переменной>

Аргументы

• <Имя переменной (STRING)> - Имя, под которым сохранено необходимое значение.

Возвращаемое значение

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

Примеры

//спОтбор -- список, хранящий переменные с фильтрами для журнала, ниже производится сохранение этого списка под именем "ЖурналБанковскихДокументовОтбор"
StoreValue("ЖурналБанковскихДокументовОтбор",спОтбор);

...

//Следующий блок читает сохраненную переменную. Блок располагается внутри визуального события OnOpen
спОтбор:=RestoreValue("ЖурналБанковскихДокументовОтбор");
If isEmpty(спОтбор) Then
  спОтбор:=List.Create();
EndIf;