StoreValue

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

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

Синтаксис

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

Аргументы

  • <Имя переменной (STRING)> - Имя, под которым необходимо сохранить текущее значение.
  • <Значение переменной> - Произвольное (или почти произвольное) значение для сохранения. Значения, которые невозможно превратить в строку с помощью функции ObjectToString не поддерживаются.

Примеры

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

...

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