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

<< Click to Display Table of Contents >>

Navigation:  Проект > Документы объектов > Генератор отчетов > Источники данных и переменные > Переменные > Локальные переменные >

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

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

peremennye.lokalnye_peremennye.sozdanie_peremennykh

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

peremennye.lokalnye_peremennye.sozdanie_peremennykh1

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

peremennye.lokalnye_peremennye.sozdanie_peremennykh2

 

img1 В поле Наименование (Name) указывается имя переменной используемое в отчете.

img_2 Псевдоним, имя переменной, которое выводится пользователю, можно указать в поле Псевдоним (Alias).

img_3 В поле Описание (Description) можно указать пояснения к переменной.

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

peremennye.lokalnye_peremennye.sozdanie_peremennykh3

 

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

 

peremennye.lokalnye_peremennye.sozdanie_peremennykh4

 

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

 

img_5 Инициализация значения. Существует два способа инициализации:

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

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

 

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

 

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

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

img_8 Параметр Использовать как параметр SQL запроса (Allow using as SQL parameter) предоставляется возможность использовать переменную как параметр в запросе при выборке данных.

 

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