Создание переменных

<< Click to Display Table of Contents >>

Navigation:  Создание отчетов > Источники данных, переменные и функции > Переменные > Локальные переменные >

Создание переменных

Добавить локальную переменную можно выбрав пункт Новая переменная... (New Variable...) в меню Новый элемент (New Item) словаря данных:

 

peremennye.lokalnye_peremennye.sozdanie_peremennykh

Также создать новую переменную можно выбрав пункт Новая переменная... (New Variable...) в контекстном меню Словаря данных (Dictionary):

peremennye.lokalnye_peremennye.sozdanie_peremennykh1

После выбора данного пункта будет отображено окно Новая переменная (New Variable), в котором необходимо определить параметры переменной:

peremennye.lokalnye_peremennye.sozdanie_peremennykh2

Название

Назначение

Наименование (Name)

Указывается имя переменной используемое в отчете

Псевдоним (Alias)

Указывается имя переменной, которое выводится пользователю

Описание (Description)

Можно указать пояснения к переменной

Тип (Type)

Позволяет изменить тип данных, которые будут размещены в переменной, и вид переменной. Данное поле представлено двумя полями с выпадающими списками.:

Первый список перечень всех доступных типов данных разбитых на категории:

peremennye.lokalnye_peremennye.sozdanie_peremennykh3

Второй список содержит перечень видов переменной. В зависимости от вида переменной могут отображаться или не отображаться некоторые дополнительные поля параметров. Перечень видов переменной представлен во втором списке поля Тип (Type) (см. рисунок выше). На рисунке снизу представлен список видов переменной:

peremennye.lokalnye_peremennye.sozdanie_peremennykh4

Переменная может быть следующих видов: Значение (Value), Значение с null (Nullable Value), Список (List), Диапазон (Range).

Инициализировать

Определяет способ инициализации.

Значение - переменная инициализируется значением заданным в поле Значение.

Выражение - в этом режиме инициализация выполняется кодом на языке C#. В этом режиме есть возможность работать с другими переменными, то есть можно инициализировать переменную результатом расчета над другой переменной. Например, можно прибавить в коде к переменной времени 1 месяц и получить дату конца отчета.

Важно! При инициализации выражением нужно помнить, что если переменная в коде инициализации обращается к другим переменным, то у нее необходимо установить флаг Только чтение. Изменить эту переменную в процессе построения отчета нельзя (то есть в нее нельзя будет что-либо записывать в событиях. Если же вам требуется изменять значение переменной в процессе построения отчета через события, то используйте способ инициализации Значение, а затем присваивайте переменной значение, используя событие Начало построение отчета (см. События)

Только чтение (Read Only)

Устанавливает режим только чтения, т.е. в данном случае будет возвращаться значение хранимое в переменной и изменить его пользователь не сможет. При этом,если значение инициализируется как выражение, то в момент обращения к нашей переменной, выражение будет вычисляться каждый раз заново.

Запросить у пользователя (Request from User)

Устанавливает режим, при котором возвращаемое значение может быть изменено пользователем. Следует отметить, что если установлен параметр Запросить у пользователя (Request from User), то будет отображаться дополнительная панель. На этой панели расположены настройки переменной, которые определяют возможности взаимодействия с пользователем, в случае использования данной переменной в отчете. Кроме того, окно Новая переменная (New Variable) может видоизменяться.

Важно! При построении отчетов в исполнительной системе рекомендуется значения всех переменных задавать при помощи элементов окна визуализации. Т.е. из окна передавать значение в параметр дерева MasterSCADA 4D, а затем в переменную источника данных Текущий проект

Использовать как параметр SQL запроса (Allow using as SQL parameter)

Предоставляет возможность использовать переменную как параметр в запросе при выборке из базы данных.

При редактировании ранее созданной переменной, в окне будет отображена кнопка Сохранить копию (Save a Copy).  При нажатии на данную кнопку, произойдет создание копии редактируемой переменной, с присвоением постфикса Copy в имени переменной.