ReportHandler: различия между версиями

Материал из RunaWFE
Перейти к навигации Перейти к поиску
м (1 версия импортирована)
м
Строка 59: Строка 59:


[[Image:ReportHandler_5.png]]
[[Image:ReportHandler_5.png]]
[[Категория:Документация]]

Версия 08:29, 21 апреля 2023

Руководство по работе отчетами

Версия 4.6.0

© 2015-2023, ООО "Процессные технологии"


# Общее описание

В RunaWFE версии 4.3 была добавлена поддержка отчетов основанных на XML шаблонах - "JasperReports" (см. Руководство по работе отчетами).

XML шаблон можно подготовить используя специальные графические средства, например Jaspersoft Studio. Пример разработки отчета и использование его в RunaWFE можно посмотреть в документе "Пример разработки отчета по данным экземпляра БП"

В RunaWFE 4.4.0 добавлена возможность генерации отчета из БП с помощью специального обработчика "Создать отчет"

# Параметры обработчика генерации отчета

Параметры обработчика "ReportHandler"

  • "Наименование отчета"

Задается с помощью переменной формата "Строка", содержащей имя используемого для генерации отчета.

  • "Параметры"

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

  • "Формат отчета"

Полученный отчет может быть в одном из следующих форматах - DOCX, EXCEL, HTML, PDF, RTL

  • "Источник данных"

Необязательное поле. Если не заполнен, то используется источник данных по-умолчанию, иначе здесь должна быть выбрана переменная формата "Строка", содержащая имя зарегистрированного в RunaWFE источника данных (поддерживаются только JNDI источники). Подробнее об источниках данных - "Источники данных"

  • "Файл отчета"

Выходной параметр отчета - файловая переменная, содержащая сгенерированный отчет

# Пример использования обработчика-генератора отчетов

В качестве примера рассмотрим генерацию отчета со статистикой выполнения заданий пользователем.

Параметры, необходимые для построения отчёта "userTasks" (входит в состав дистрибутивов RunaWFE начиная с версии 4.3):

  • UserName - логин пользователя
  • ReportDateFrom - дата начала периода за который необходимо получить статистику
  • ReportDateTo - дата окончания периода

ReportHandler 1.png


Обработчик принимает параметры отчета в переменной пользовательского типа c соответствующими "userTasks" полями

ReportHandler 2.png

ReportHandler 3.png


Переменная ReportName имеет значение по умолчанию, соответствующее наименованию отчета

ReportHandler 4.png


В результате выполнения будет сформирован PDF файл отчета

ReportHandler 5.png