Параметры: различия между версиями

Текущая версия от 07:57, 19 октября 2026

Параметр – это переменная, значение которой может быть определено как в самом отчете, так и вне его (программа, вызывающая отчет, может передавать в него значения параметров).

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

Наиболее частые способы использования параметров

фильтрация данных по условию, заданному в параметре;
печать значения параметра в отчете.

Свойства параметров

Свойство	Описание
`Name`	Имя параметра может содержать любые символы, кроме точки `.`.
`DataType`	Тип данных параметра.
`Expression`	Выражение, которое возвращает значение параметра. Подробнее о выражениях смотрите в главе `Выражения`. Это выражение будет вычислено при обращении к параметру.
`Value`	Значение параметра. Это свойство недоступно в дизайнере и может быть заполнено программным способом.

Вы должны настроить свойства Name и DataType.

Свойство Expression можно оставить пустым. В этом случае значение параметра надо передавать программным способом.

Создание параметра

Чтобы создать параметр, выберите элемент Параметры отчета в окне Данные и выберите пункт Новый параметр в контекстном меню:

Нажмите клавишу F2 и задайте желаемое имя параметра, затем переключитесь в окно Свойства и укажите тип данных параметра (свойство DataType).

Параметры могут быть вложенными. Чтобы создать вложенный параметр, выберите родительский параметр и выберите пункт Новый параметр в контекстном меню:

При этом можно обращаться как к родительскому параметру, так и к вложенному.

Количество уровней вложенности не ограничено.

Использование параметров в отчете

Простой параметр

К параметру можно обращаться из выражения, используя квадратные скобки:

[Имя параметра]

Вложенный параметр

К вложенному параметру надо обращаться следующим образом:

[Родительский параметр.Дочерний параметр]

Строковый параметр

Так как параметр имеет определенный тип (он задан в свойстве DataType), с параметром можно выполнять действия, разрешенные для типа данных.

Так, параметры строкового типа можно использовать в выражении следующим образом:

[Строковый параметр].Substring(0, 2)

Пример

Существует отчет, печатающий таблицу Employees (Сотрудники).
Требуется распечатать информацию о сотруднике с указанным номером (поле EmployeeID).
Для этого нужно создать параметр с именем Номер сотрудника.
Укажем тип параметра – Int32, так как именно этот тип имеет поле EmployeeID.

Чтобы отфильтровать сотрудника с указанным номером, нужно зайти в редактор бэнда Данные и на закладке Фильтр указать следующее выражение:

[Employees.EmployeeID] == [Номер сотрудника]

Чтобы передать значение параметра из программы в отчет, нужно использовать следующий код:

Report.SetParameterValue("Номер сотрудника", 2);

@@ Строка 1: / Строка 1: @@
-В отчете можно определить параметры. Параметр – это переменная, значение которой может быть определено как в самом отчете, так и вне его (программа, вызывающая отчет, может передавать в него значения параметров – подробнее об этом см. "Руководство программиста"). Параметр может использоваться в выражениях, выводиться в объектах типа "Текст".
+'''Параметр''' – это переменная, значение которой может быть определено как в самом отчете, так и вне его (программа, вызывающая отчет, может передавать в него значения параметров).
-Наиболее частые способы использования параметров:
+Параметр может использоваться в выражениях, выводиться в объектах типа <code>Текст</code>.
-фильтрация данных по условию, заданному в параметре;
+===Наиболее частые способы использования параметров===
-печать значения параметра в отчете.
+*фильтрация данных по условию, заданному в параметре;
-Параметр имеет следующие свойства:
+*печать значения параметра в отчете.
+===Свойства параметров===
+{|class="wikitable" style="background-color: #fff;"
+|-
+! Свойство
+! Описание
+|-
+| '''<code>Name</code>'''
+|Имя параметра может содержать любые символы, кроме точки <code>.</code>.
+|-
+| '''<code>DataType</code>'''
+|Тип данных параметра.
+|-
+| '''<code>Expression</code>'''
+|Выражение, которое возвращает значение параметра. Подробнее о выражениях смотрите в главе <code>Выражения</code>.
+Это выражение будет вычислено при обращении к параметру.
+|-
+| '''<code>Value</code>'''
+|Значение параметра. Это свойство недоступно в дизайнере и может быть заполнено программным способом.
+|-
+|}
+Вы должны настроить свойства <code>Name</code> и <code>DataType</code>.
+Свойство <code>Expression</code> можно оставить пустым. В этом случае значение параметра надо передавать программным способом.
+==Создание параметра==
+Чтобы создать параметр, выберите элемент <code>Параметры отчета</code> в окне <code>Данные</code> и выберите пункт <code>Новый параметр</code> в контекстном меню:
+[[Файл: create_parameter_1.png | center | border]]
+Нажмите клавишу <code>F2</code> и задайте желаемое имя параметра, затем переключитесь в окно <code>Свойства</code> и укажите тип данных параметра (свойство <code>DataType</code>).
+Параметры могут быть вложенными. Чтобы создать вложенный параметр, выберите родительский параметр и выберите пункт <code>Новый параметр</code> в контекстном меню:
+[[Файл: create_parameter_2.png | center | border]]
+При этом можно обращаться как к родительскому параметру, так и к вложенному.
+Количество уровней вложенности не ограничено.
+==Использование параметров в отчете==
+===Простой параметр===
+К параметру можно обращаться из выражения, используя квадратные скобки:
+<syntaxhighlight lang="js">
+[Имя параметра]
+</syntaxhighlight>
+===Вложенный параметр===
+К вложенному параметру надо обращаться следующим образом:
+<syntaxhighlight lang="js">
+[Родительский параметр.Дочерний параметр]
+</syntaxhighlight>
+===Строковый параметр===
+Так как параметр имеет определенный тип (он задан в свойстве <code>DataType</code>), с параметром можно выполнять действия, разрешенные для типа данных.
+Так, параметры строкового типа можно использовать в выражении следующим образом:
+<syntaxhighlight lang="js">
+[Строковый параметр].Substring(0, 2)
+</syntaxhighlight>
+===Пример===
+#Существует отчет, печатающий таблицу <code>Employees</code> (Сотрудники).
+#Требуется распечатать информацию о сотруднике с указанным номером (поле <code>EmployeeID</code>).
+#Для этого нужно создать параметр с именем <code>Номер сотрудника</code>.
+#Укажем тип параметра – <code>Int32</code>, так как именно этот тип имеет поле <code>EmployeeID</code>.
+::*Чтобы отфильтровать сотрудника с указанным номером, нужно зайти в редактор бэнда <code>Данные</code> и на закладке <code>Фильтр</code> указать следующее выражение:
+:::<syntaxhighlight lang="js">
+[Employees.EmployeeID] == [Номер сотрудника]
+</syntaxhighlight>
+::*Чтобы передать значение параметра из программы в отчет, нужно использовать следующий код:
+:::<syntaxhighlight lang="js">
+Report.SetParameterValue("Номер сотрудника", 2);
+</syntaxhighlight>