Перейти к содержанию

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

Материал из Химсофт Вики
← Предыдущая правка
Sidminik (обсуждение | вклад)
Бюрократы, Администраторы интерфейса, Скрывающие, Администраторы
4171 правка
 
(не показано 28 промежуточных версий 3 участников)
Строка 1: Строка 1:
==Общие сведения==
'''Параметр''' – это переменная, значение которой может быть определено как в самом отчете, так и вне его (программа, вызывающая отчет, может передавать в него значения параметров).  
*в отчетах можно использовать параметры для фильтрации или добавления данных, отображаемых в отчётах;
*возможно запрашивать у пользователей параметры, чтобы они могли управлять выводом;
*возможно задавать параметры автоматически.


==Создание простого параметра==
Параметр может использоваться в выражениях, выводиться в объектах типа <code>Текст</code>.
*добавить еще один DataSet (п. 1.4, рис. 1.5-1.10), например, FilterLaboratory;
*в качестве SQL-запроса в поле «Query» набора данных FilterLaboratory можно использовать SQL-запрос из набора данных MainDataSet или, по возможности, его упрощенный вариант (исключение неиспользуемых полей и соединений таблиц);
*добавить параметр в дереве отчета (рис. 5.1);
*в открывшемся окне на вкладке «General» (рис. 5.2)
**в поле «Name» ввести название фильтра, например, «ReportParameterLaboratory» (по умолчанию –  «ReportParameter1»);
**в поле «Text for prompting users for a value:» ввести текст-приглашение для выбора значения пользователем, например, «Выберите лабораторию:» (по умолчанию – «ReportParameter1»);
*в открывшемся окне на вкладке «General» (рис. 5.3)
**установить переключатель в значение «From query» (по умолчанию – «Non-queried»);
**в поле «Dataset:» выбрать используемый набор данных «FilterLaboratory »;
**в полях «Value field:» и «Label field:» установить необходимое поле из набора данных (например, «lab_name»);
**в поле «Condition:» установить значение «Value» или «Label» (если в полях «Value field:» и «Label field:» указано одно и то же значение, то любой вариант);
**в поле «Direction:» указать желаемый вариант сортировки («Ascending» – по возрастанию, «Descending» – по убыванию);
**нажать «OK».


==Подключение фильтра к таблице==
===Наиболее частые способы использования параметров===
*выделить таблицу на основном поле конструктора или в дереве;
*фильтрация данных по условию, заданному в параметре;
*нажать на кнопку диалогового окна свойств «Property dialog…» (рис. 4.17);
*печать значения параметра в отчете.
*в открывшемся окне в левом столбце перейти на вкладку «Table - Filters» и нажать на кнопку «+» (рис. 5.4);
*в результате появится «пустой» фильтр, не имеющий параметров;
*для добавления параметров нажать на стрелку поля «Expression» и в раскрывшемся списке выбрать поле из DataSet (например, «=Fields!lab_name.Value»), по которому будет проводиться группировка (рис. 5.5);
*в поле «Operator:» выбрать оператор «Equal» (рис. 5.6);
*в разделе «Values» в поле «Expression» нажать стрелку меню и выбрать из списка значение <Expression…> (рис. 5.6);
*в открывшемся окне «Expression Editor» в левой части окна в области «Fields:» раскрыть группу «Parameters» и выбрать пункт «ReportParameterLaboratory» (рис. 5.7);
*двойным кликом или кнопкой «Append» добавить пункт «ReportParameterLaboratory » в область «Expression:»;
*нажать кнопку «ОК» в окне «Expression Editor» и кнопку «ОК» в окне «Table - Filters»;
*при формировании отчета перед выводом документа на экран появится колонка с параметром в качестве фильтра (рис. 5.8).


==Создание связанного фильтра==
===Свойства параметров===
*для создания связанного фильтра на первом этапе создается простой фильтр, при этом все этапы полностью повторяют пп. 5.2-5.3
 
**создаем новый набор данных «FilterFio» с таким же или более коротким SQL-запросом;
{|class="wikitable" style="background-color: #fff;"
**создаем параметр «ReportParameterFio» (с принимаемым из набора данных значением «fio»);
|-
**при необходимости фильтрации таблицы по данному критерию подключаем созданный фильтр к таблице с общим значением фильтра «=[fio] In (=Parameters!ReportParameterFio.Value)»;
! Свойство
**если значение ФИО нужно только для однократного вывода на экран (например, для подписи документа), то шаг подключения фильтра к таблице пропускается;
! Описание
*в результате создается второй фильтр со значениями, не зависящими от первого;
|-
*для добавления зависимости необходимо в дереве отчета выбрать набор данных «FilterFio» правой кнопкой выбрать пункт меню «Edit» (рис. 5.9);
| '''<code>Name</code>'''
*в отрывшемся окне в левой части выбрать раздел «DataSet - Parameters» и нажать на кнопку «+» (рис. 5.10);
|Имя параметра может содержать любые символы, кроме точки <code>.</code>.
*в отрывшемся окне в поле «Name» (рис. 5.11) ввести имя параметра (например, «SelectedLaboratory»);
|-
*в поле «Value» нажать стрелку меню и выбрать пункт «Expression…» (рис. 5.11);
| '''<code>DataType</code>'''
*в левой части окна в области «Fields:» раскрыть группу «Parameters» и выбрать пункт «ReportParameterLaboratory » (рис. 5.12);
|Тип данных параметра.
*двойным кликом или кнопкой «Append» добавить пункт «ReportParameterLaboratory » в область «Expression:» (рис. 5.12);
|-
*нажать кнопку «OK»;
| '''<code>Expression</code>'''
*в оставшемся открытым окне свойств набора данных в левой части окна выбрать раздел «DataSet - Query» (рис. 5.13);
|Выражение, которое возвращает значение параметра. Подробнее о выражениях смотрите в главе <code>Выражения</code>.
*в поле «Query:» в конце запроса добавить условие «WHERE fio In (@SelectedLaboratory)» (рис. 5.13);
Это выражение будет вычислено при обращении к параметру.
*таким образом, итоговые записи данного запроса будут браться не напрямую из набора данных БД, а после предварительной фильтрации на основе лаборатории, выбранной в первом фильтре;
|-
*в результате (рис. 5.14) связанный фильтр функции не активен, пока не будет определено значение основного фильтра лаборатории.
| '''<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>

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

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

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

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

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

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

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

Это выражение будет вычислено при обращении к параметру.

Value Значение параметра. Это свойство недоступно в дизайнере и может быть заполнено программным способом.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пример

  1. Существует отчет, печатающий таблицу Employees (Сотрудники).
  2. Требуется распечатать информацию о сотруднике с указанным номером (поле EmployeeID).
  3. Для этого нужно создать параметр с именем Номер сотрудника.
  4. Укажем тип параметра – Int32, так как именно этот тип имеет поле EmployeeID.
  • Чтобы отфильтровать сотрудника с указанным номером, нужно зайти в редактор бэнда Данные и на закладке Фильтр указать следующее выражение:
[Employees.EmployeeID] == [Номер сотрудника]
  • Чтобы передать значение параметра из программы в отчет, нужно использовать следующий код:
Report.SetParameterValue("Номер сотрудника", 2);
Источник — https://wiki.chemsoft.ru/index.php?title=Параметры&oldid=4172