Versions Compared

Old Version 9

changes.mady.by.user Eduard Zhitenev

Saved on

compared with

New Version 10

changes.mady.by.user Eduard Zhitenev

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Note

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

Info

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

Table of Contents

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

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

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

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

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

Отображать

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

Код свойства

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

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

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

Тип

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

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

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

Tip

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

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

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

Строка


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

Целое число

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

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

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

Дата

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

Дата и время

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

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

Image Added

Время

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

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

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



Image Added

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

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

Флажок,

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

Список,

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

Выбор из списка значений:


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

Note

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

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

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

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

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

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

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

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

Expand
titleСтатический список

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

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

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

Image Added

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

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

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

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

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

Note

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

Image Added

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

Image Added

Expand
titleДинамический список на базе данных из ExeMES
Note

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

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

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

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

Image Added

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

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

Image Added

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

Image Added

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

Image Added

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

Image Added

Tip

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

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

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

Image Added

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

Image Added


Tip

В выпадающем списке присутствуют преднастроенные API, которые выделены цветом. Для них уже настроены поля «Ключ» и «Значение»:

Image AddedImage Added