Доступно начиная с версии ExeReport 1.4.

Параметры отчета — это переменные, которые определяют выборку данных для отчета. Они позволяют пользователю настраивать вывод данных в зависимости от его потребностей и предпочтений. Использование параметров отчета позволяет создавать более целенаправленные и информативные документы, которые лучше соответствуют запросам пользователей. При разработке отчета в формате frx параметры настраиваются в окне «Data» в раскрывающемся списке «Parameters» основного экрана дизайнера отчетов FastReport. Для каждого параметра при вызове отчета передается значение, которое определяет параметры выборки и фильтрации данных в отчете.

Настройка отображения параметров отчетов

Для настройки отображения параметров отчета необходимо воспользоваться пунктом меню «Управление отчетами». В списке отчетов выбрать отчет и нажать кнопку «Настройки»:

В появившемся окне необходимо перейти на вкладку «Настройка параметров»:

Для параметра отчетов доступны следующие настройки:

НастройкаОписание

Отображать

 Включение видимости параметра отчета в режиме просмотра отчета.

Код свойства

 Название параметра, которое указал разработчик при разработке отчета в файле frx.

Название в форме

 Описание параметра, которое будет отображаться в режиме просмотра отчета.

Тип

 Тип параметра, который может быть выбран из списка.

Значение по умолчанию

Значение параметра по умолчанию. Значение по умолчанию будет автоматически подставлено в параметр при построении отчета.

Порядок отображения параметров отчета можно изменить. Для изменения порядка отображения параметров отчета необходимо навести курсор на область левее переключателя «Отобразить», нажать на появившийся объект и перетащить параметр вверх или вниз по списку:

Типы параметров отчета

Тип параметраОписание

Строка


Строковое значение:

Целое число

Целочисленное значение:

Число с плавающей точкой

Число с плавающей точкой - число с дробной частью,:

Дата

Значение в формате даты:Для типа параметра «Дата» можно задать статическое значение по умолчанию, назначить ручной ввод значения параметра перед построением отчета, а также назначить скрипт, который будет подставлять определенное значение параметра перед построением отчета. Для назначения ручного ввода параметра или выбора скрипта автоматического формирования значения параметра типа «Дата» нажмите кнопку , доступные скрипты представлены на рисунке ниже:

Дата и время

Время в формате "Дата и время":Для параметров данного типа предоставлена возможность выбора способа конфигурации значения по умолчанию. Для этого необходимо нажать на кнопку справа от поля "Значение по умолчанию". Для выбора доступно 2 конфигурации значения по умолчанию:

  • статическое значение, для выбора статического значения необходимо выбрать позицию "Ручной ввод" в открывшемся меню;
  • скрипт - генерация значения по умолчанию с использованием одного из предопределенных алгоритмов, для выбора скрипта необходимо выбрать одну из доступных позиций в открывшемся меню.

Время

Время в формате "Время"::

Для параметров данного типа предоставлена возможность выбора способа конфигурации значения по умолчанию. Для этого необходимо нажать на кнопку справа от поля "Значение по умолчанию". Для выбора доступно 2 конфигурации значения по умолчанию:

  • статическое значение, для выбора статического значения необходимо выбрать позицию "Ручной ввод" в открывшемся меню;
  • скрипт - генерация значения по умолчанию с использованием одного из предопределенных алгоритмов, для выбора скрипта необходимо выбрать одну из доступных позиций в открывшемся меню.



Переключатель

Булевое значение:

Флажок,

Радиокнопка,

Список,

Список с множественным выбором.

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

Пример конфигурации параметра типа «Флажок»:

Пример конфигурации параметра типа «Радиокнопка»:

Пример конфигурации параметра типа «Список»:

Пример конфигурации параметра типа «Список с множественным выбором»:

Типы параметра «Флажок» и «Список с множественным выбором» допускают возможность передачи нескольких значений из списка. 

Типы параметра «Радиокнопка» и «Список» допускают возможность передачи только одного значения из списка. 

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

Пример отображения параметра типа «Флажок»:

Пример отображения параметра типа «Радиокнопка»:

Пример отображения параметра типа «Список»:

Пример отображения параметра типа «Список с множественным выбором»:

Для использования данных типов параметров необходимо настроить списки доступных значений. ExeReport предоставляет возможность настроить списки значений двумя способами:

Статический список - список фиксированных значений, доступных к выбору и конфигурируемых вручную.

Для настройки статического списка необходимо выбрать настраиваемый отчет и нажать кнопку «Настройки»:

Далее перейти на вкладку «Настройка параметров» и нажать кнопку «Настройка списков» для настраиваемого параметра:

Окно настройки статического списка значений параметра отчета представлено ниже:

При настройке статического списка значений параметра отчета необходимо настроить следующие поля:

  1. «Использовать» - включает элемент списка для выбора при построении отчета;
  2. «Выбрано по умолчанию» - признак указывает, что значение «Ключ» этого элемента будет автоматически подставлен в значение параметра перед построением отчета;
  3. «Ключ» - уникальное значение в рамках одного списка, значение ключа будет передано в параметр отчета при построении отчета;
  4. «Значение» - отображаемое значение в списке для пользователя.

После конфигурации полей «Использовать», «Выбрано по умолчанию», «Ключ» и «Значение» необходимо нажать кнопку , после этого элемент списка является сконфигурированным. Для удаления элемента списка необходимо использовать кнопку . 

Каждый настроенный список должен сожержать хотя бы один элемент.

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

Ниже представлен пример конфигурации статического списка материалов:

Для работы с данным функционалом необходимо настроить взаимодействие с ExeMES.

Динамический список - список значений, формируемый на основании данных, возвращаемых web API ExeMES.

Для настройки динамического списка необходимо выбрать настраиваемый отчет и нажать кнопку «Настройки»:

Далее перейти на вкладку «Настройка параметров» и нажать кнопку «Настройка списков» для настраиваемого параметра:

 Затем необходимо выбрать в выпадающем списке «Источник значений  для списка» значение «MesMiddleware API». В окне появится анимация загрузки перечня API MesMiddleware :

После загрузки перечня API, в выпадающем списке «Используемое Api» выберите API для получения данных от сервера MesMiddleware:

Для любых API из списка MesMiddleware API есть возможность настройки фильтра значений списка. Для настройки фильтра, разверните область «Фильтр»:

В выпадающем списке «Параметр» доступны для выбора все поля, которые возвращаются выбранной API:

В поле «Значение» вводится значение параметра, по которому будет отфильтрован список MesMiddleware API. Фильтр может состоять из нескольких параметров. Добавление параметра фильтра осуществляется по нажатию кнопки . Для удаления параметра фильтра необходимо использовать кнопку . В приведенном ниже примере сконфигурирован фильтр списка из 2-х параметров для API ItemProd - Производство Материала. Запрос в MesMidleware будет сформирован с фильтрацией по идентификатору материала (item_id) «S101» и качеству производства (good_prod) «true»:

Фильтр не является обязательной настройкой списка элементов для параметра отчета

Для настройки динамического списка необходимо сконфигурировать следующие поля:

  1. «Ключ» - уникальное значение в рамках одного списка, значение ключа будет передано в параметр отчета при построении отчета;
  2. «Значение» - отображаемое значение в списке для пользователя.

Ключ и значение выбираются из выпадающих списков. Выпадающие списки формируются на основании всех полей, которые возвращает выбранная API. Таким образом можно сформировать любую пару ключ-значение для передачи в параметр и построения отчета:


В выпадающем списке присутствуют преднастроенные API, которые выделены цветом. 

Для них уже настроены поля «Ключ» и «Значение»: