Доступно начиная с версии ExeReport 1.4.
Параметры отчета — это переменные, которые определяют выборку данных для отчета. Они позволяют пользователю настраивать вывод данных в зависимости от его потребностей и предпочтений. Использование параметров отчета позволяет создавать более целенаправленные и информативные документы, которые лучше соответствуют запросам пользователей. При разработке отчета в формате frx параметры настраиваются в окне «Data» в раскрывающемся списке «Parameters» основного экрана дизайнера отчетов FastReport. Для каждого параметра при вызове отчета передается значение, которое определяет параметры выборки и фильтрации данных в отчете.
Настройка отображения параметров отчетов
Для настройки отображения параметров отчета необходимо воспользоваться пунктом меню «Управление отчетами». В списке отчетов выбрать отчет и нажать кнопку «Настройки»:
В появившемся окне необходимо перейти на вкладку «Настройка параметров»:
Для параметра отчетов доступны следующие настройки:
| Настройка | Описание |
|---|---|
Отображать | Включение видимости параметра отчета в режиме просмотра отчета. |
Код свойства | Название параметра, которое указал разработчик при разработке отчета в файле frx. |
Название в форме | Описание параметра, которое будет отображаться в режиме просмотра отчета. |
Тип | Тип параметра, который может быть выбран из списка. |
Значение по умолчанию | Значение параметра по умолчанию. Значение по умолчанию будет автоматически подставлено в параметр при построении отчета. |
Порядок отображения параметров отчета можно изменить. Для изменения порядка отображения параметров отчета необходимо навести курсор на область левее переключателя «Отобразить», нажать на появившийся объект 
и перетащить параметр вверх или вниз по списку:
Типы параметров отчета
| Тип параметра | Описание |
|---|---|
Строка | Строковое значение: |
Целое число | Целочисленное значение: |
Число с плавающей точкой | Число с плавающей точкой - число с дробной частью,: |
Дата | Значение в формате даты: |
Дата и время | Время в формате "Дата и время":
|
Время | Время в формате "Время":: Для параметров данного типа предоставлена возможность выбора способа конфигурации значения по умолчанию. Для этого необходимо нажать на кнопку
|
Переключатель | Булевое значение: |
Флажок, Радиокнопка, Список, Список с множественным выбором. | Список значений параметров отчета — это набор возможных значений, которые могут быть использованы в качестве значения параметра при генерации отчета. Пример конфигурации параметра типа «Флажок»:
Пример конфигурации параметра типа «Радиокнопка»:
Типы параметра «Флажок» и «Список с множественным выбором» допускают возможность передачи нескольких значений из списка. Типы параметра «Радиокнопка» и «Список» допускают возможность передачи только одного значения из списка. Указанные типы параметров отличаются визуально. Пример отображения параметра типа «Флажок»: Пример отображения параметра типа «Радиокнопка»: Пример отображения параметра типа «Список»: Пример отображения параметра типа «Список с множественным выбором»:
Статический список - список фиксированных значений, доступных к выбору и конфигурируемых вручную. Для настройки статического списка необходимо выбрать настраиваемый отчет и нажать кнопку «Настройки»:
Окно настройки статического списка значений параметра отчета представлено ниже: При настройке статического списка значений параметра отчета необходимо настроить следующие поля:
После конфигурации полей «Использовать», «Выбрано по умолчанию», «Ключ» и «Значение» необходимо нажать кнопку Каждый настроенный список должен сожержать хотя бы один элемент. Поле ключ должно быть уникальным в рамках одного списка элементов, при дублировании значения поля ключ появляется сообщение об ошибке
Ниже представлен пример конфигурации статического списка материалов:
Для работы с данным функционалом необходимо настроить взаимодействие с ExeMES. Динамический список - список значений, формируемый на основании данных, возвращаемых web API ExeMES. Для настройки динамического списка необходимо выбрать настраиваемый отчет и нажать кнопку «Настройки»:
Затем необходимо выбрать в выпадающем списке «Источник значений для списка» значение «MesMiddleware API». В окне появится анимация загрузки перечня API MesMiddleware :
Для любых API из списка MesMiddleware API есть возможность настройки фильтра значений списка. Для настройки фильтра, разверните область «Фильтр»:
В выпадающем списке «Параметр» доступны для выбора все поля, которые возвращаются выбранной API:
В поле «Значение» вводится значение параметра, по которому будет отфильтрован список MesMiddleware API. Фильтр может состоять из нескольких параметров. Добавление параметра фильтра осуществляется по нажатию кнопки
Фильтр не является обязательной настройкой списка элементов для параметра отчета Для настройки динамического списка необходимо сконфигурировать следующие поля:
Ключ и значение выбираются из выпадающих списков. Выпадающие списки формируются на основании всех полей, которые возвращает выбранная API. Таким образом можно сформировать любую пару ключ-значение для передачи в параметр и построения отчета:
В выпадающем списке присутствуют преднастроенные API, которые выделены цветом.
Для них уже настроены поля «Ключ» и «Значение»: |
