Добавление шаблона PRD. Настройка структуры шаблона PRD

Добавление нового шаблона PRD

Чтобы добавить новый шаблон PRD для отчетов (печатных форм), выполните одно из следующих действий:

  • Нажмите иконку Создать новый отчет слева вверху.

  • Нажмите комбинацию клавиш Ctrl+N.
  • Разверните меню "Файл" и выберите "Новый".

В рабочем пространстве конструктора PRD отобразится вкладка шаблона PRD. Каждый шаблона PRD и подотчет открывается на отдельной вкладке.

Атрибуты шаблона PRD см. Атрибуты элемента шаблона PRD

Структура шаблона PRD

Структура шаблона PRD формируется с помощью областей. В каждую область можно добавлять элементы, см. Управление элементами шаблона PRD.

Области шаблона PRD

Все области шаблона PRD представлены на вкладке "Структура", см. Вкладка "Структура".

В рабочем пространстве конструктора PRD ярлыки с наименованием видимых областей отображаются слева, см. Настройка видимости области шаблона PRD. Ярлык выбранной области выделяется серым цветом.

Основные области шаблона PRD:

  • Верхний колонтитул — элементы, размещенные в этой области, отображаются на каждой странице шаблона PRD, вверху.
  • Заголовок отчета — элементы этой области отображаются только на первой странице шаблона PRD. В этой области размещаются заголовки колонок таблицы данных.

  • Группа — область появляется в структуре шаблона PRD, если в шаблоне PRD используется группировка. Элементы, размещенные в этой области, отображаются в средней части страницы шаблона PRD:

    • Заголовок группы.
    • Подробная информация:
      • Заголовок отчета — заголовок для строки таблицы данных или группы строк.
      • Отчет — таблица данных отчета.
      • Отсутствие данных — область, которая используется для вывода информационного сообщения, если в отчете нет данных.
      • Итоговые данные.
    • Итого группы.
  • Итоговые данные — заключительная строка.
  • Нижний колонтитул — элементы, размещенные в этой области, отображаются на каждой странице, внизу.
  • Водяной знак — отображается на каждой странице печатной версии отчета, вверху. По умолчанию скрыта.

Размеры всех областей отчета можно изменить, перемещая вверх-вниз нижнюю границу области.

Вкладка "Структура"

Вкладка "Структура" находится рядом с вкладкой "Данные" в правой части страницы конструктора PRD.

На вкладке "Структура" отображается иерархия всех элементов шаблона PRD. Корневая категория для главного шаблона PRD называется "Мастер отчетов", для подотчетов — "Подотчет", см. Подотчет.

Каждый элемент, добавленный в шаблон PRD, отображается на вкладке "Структура".

При выборе элемента на вкладке, ниже на экране, отображаются свойства элемента, см. Атрибуты элемента шаблона PRD и Форматирование элементов шаблона PRD.

На вкладке "Структура" доступны следующие операции с элементами шаблона PRD:

Настройка видимости области шаблона PRD

Чтобы настроить видимость области, выполните следующие действия:

  1. На вкладке "Структура" выберите название области.

  2. На вкладке "Атрибуты" в блоке "Общие" выберите параметр "Скрывать на холсте";

  3. Установите значение параметра "Скрывать на холсте":

    • true — выбранная область не будет отображаться в шаблоне PRD.
    • false — выбранная область будет отображаться в шаблоне PRD.

Выбранная область не будет отображаться в шаблоне PRD.

Аналогичным образом настраивается видимость элемента "Полоса"

Полоса

Полоса — структурный элемент шаблона PRD. Полоса позволяет группировать несколько элементов в рамках одной области шаблона PRD.

Чтобы создать полосу и сгруппировать несколько элементов шаблона PRD, выполните следующие действия:

  1. Нажмите иконку на панели иконок слева и перетащите в нужную область шаблона PRD.
  2. Укажите размеры элемента, см. Регулировка размера элемента и перемещение элемента между разделами

  3. Добавьте элементы в полосу.

    Элементы, добавленные в полосу, можно перемещать в рамках полосы, изменять из размер, вырезать и перенести в другую область (полосу) шаблона PRD.

    При переносе полосы в другую область шаблона PRD все элементы, включенные в полосу, переносятся вместе с ней.

    Видимость элемента "Полоса" настраивается по общим правилам, см. Настройка видимости области шаблона PRD.

Подотчет

Подотчет (subreports) используется при необходимости отобразить в одном шаблоне PRD данные из различных источников. В рамках одного шаблона PRD может быть создано несколько подотчетов по количеству источников данных.

Подотчет(subreports) является структурным элементом шаблона PRD.

Создание подотчета

Чтобы в одном отчете отобразить диаграмму и таблицу, построенные по разным выборкам данных, создайте шаблон PRD и добавьте таблицу в область с основными данными. Создайте подотчет и добавьте в него диаграмму.

Чтобы создать подотчет, выполните следующие действия:

  1. Нажмите иконку на панели иконок слева и перетащите в нужную область шаблона PRD. В диалоговом окне отобразится вопрос "Вы хотите встроить подотчет на одном уровне или под разделом, к которому он относится?". Выберите вариант ответа: "Строчно" или "Полосой".

    Подотчет отобразится в области шаблона PRD. Ширина элемента "подотчет" всегда 100%.

  2. Дважды кликните по элементу "Подотчет"

    ИЛИ на вкладке "Структура" выберите элемент "Подотчет", откройте правой кнопкой контекстное меню и выберите пункт "Редактировать подотчет".

    На экране отобразится отдельная вкладка подотчета, в которой размещается содержание подотчета.

Атрибуты подотчета

Атрибуты подотчета и его структура настраиваются также как и для основного шаблона PRD.

  • Название — для удобства можно задать название подотчета. В основном шаблоне PRD один раз нажмите на элемент "Подотчет", на вкладке "Атрибуты" в блоке "общие" в поле "Имя" указываем название подотчета, см. Атрибуты элемента "Подотчет".

Набор данных подотчета

Для подотчета рекомендуется создавать свой набор данных. Если запрос для подотчета добавить в набор данных для основного шаблона PRD, то при построении отчета в системе данные подотчета могут быть пустыми.

Особенности и ограничения при использовании подотчетов:

  • Если какое-то значение получено в основном шаблона PRD, то рекомендуется его импортировать в качестве параметра в подотчет, а не получать заново в подотчете.
  • Параметры, передаваемые из системы в шаблон PRD (с формы добавления отчета), в подотчете будут равны null.
  • Groovy-скрипты не работают для подотчетов.

Передача параметров из шаблона PRD в подотчет и передача параметров, которые передаются из приложения

В подотчет можно передать любую колонку выборки из основного шаблона PRD как параметр:

  1. Перейдите в содержание подотчета, дважды кликнув по элементу "Подотчет" в основном шаблона PRD.
  2. В правой панели перейдите на вкладку "Данные".

  3. В правой панели перейдите на вкладку "Данные". В группе "Параметры" в контекстном меню выберите "Редактировать параметры отчета".

  4. На открывшемся форме с параметрами подотчета в блоке "Импорт параметров" выберите нужные параметры.

    Пример. Чтобы передать в подотчет дату, относительно которой будет строиться отчет:

    1. Переведите дату в колонку основной выборки и добавьте ее значение к основному SELECT, используя конструкцию типа:

      SELECT ID as id, ${dateParametr} AS parametr FROM tbl_serviceCall

    2. Полученную колонку parameter импортируйте в выборку параметров подотчета. Для этого примера настройка импорта параметров выглядит как на рисунке ниже.

    3. Внутреннее имя paramInSubReport укажите вручную, это название параметра потом можно использовать в подотчете, следующим образом:

      SELECT title FROM tbl_serviceCall
WHERE registration_date > ${paramInSubReport}

Использование подотчетов для группировки данных

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

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

Перекрестный отчет

Перекрестные отчет — это шаблон PRD, в котором количество колонок и строк величины переменные.

Чтобы настроить шаблон PRD с перекрестными группами, выполните следующие действия:

  1. Включите возможность использования экспериментальных возможностей. Перекрестные отчеты crosstab входят в число экспериментальных возможностей Pentaho Report Designer.

    Чтобы включить использование экспериментальных возможностей в конструкторе PRD, выберите в меню "Редактирование" пункт "Настройки". На отобразившейся форме "Установки" установите флажок Включение (неподдерживаемых) экспериментальных возможностей и нажмите кнопку Применить.

  2. Добавьте перекрестную группу. На вкладке "Структура" выберите корневой элемент дерева мастера отчета. Откройте правой кнопкой контекстное меню и выберите пункт "Добавить перекрестную группу".

    На вкладке "Структура" отобразятся элементы перекрестной группы.

  3. Добавьте SQL запрос, который вернет три столбца данных (должна быть сортировка значений по столбцам).

    В результатах SQL запроса каждому заголовку строки должен быть поставлен в соответствие заголовок столбца. Следует использовать CROSS JOIN.
    В результатах SQL запроса ни в одной из колонок не должно быть null, следует заменять null на 0 или пробел.
    В отчете не должно быть двух одинаковых заголовков строк или колонок.

  4. Создайте структуру отчета. Элементы в перекрестную группу добавляются только на вкладке "Структура", см. Добавление элемента в шаблон PRD.

    • Перекрестный ряд группы (мастер отчета → перекрестный → перекрестный ряд тела группы → перекрестный ряд группы): на вкладке "Атрибуты" в группе "Общие" атрибут "группа" — выберите группу, которая будет размещена в заголовке строк.

      В область "Название верхнего колонтитула" (мастер отчета → перекрестный → перекрестный ряд тела группы → перекрестный ряд группы → название верхнего колонтитула) следует добавить элемент, в значении которого должен быть хотя бы пробельный символ.

    • Заголовок группы (мастер отчета → перекрестный → перекрестный ряд тела группы → перекрестный ряд группы → заголовок группы) добавьте элемент. На вкладке "Атрибуты" в группе "Общие" укажите значение атрибута "Поле" — набор данных, который будет размещен в заголовки строк.
    • Перекрестная колонка группы (мастер отчета → перекрестный → перекрестный ряд тела группы → перекрестный ряд группы → перекрестная колонка группы тела → перекрестная колонка группы): на вкладке "Атрибуты" в группе "Общие" атрибут "группа" — выберите группу, которая будет размещена в заголовке столбцов.
    • Заголовок группы (мастер отчета → перекрестный → перекрестный ряд тела группы → перекрестный ряд группы → перекрестная колонка группы тела → перекрестная колонка группы → заголовок группы) добавьте элемент. На вкладке "Атрибуты" в группе "Общие" укажите значение атрибута "Поле" — набор данных, который будет размещен в заголовки столбцов.

    • Отчет (мастер отчета → перекрестный → перекрестный ряд тела группы → перекрестный ряд группы → перекрестная колонка группы тела → перекрестная колонка группы → подробная информация отчета → отчет) добавьте элемент. На вкладке "Атрибуты" в группе "Общие" укажите значение атрибута "Поле" — набор данных, который будет размещен на пересечение строк и столбцов.

    В CrossTab не работают: функции, которые создаются на вкладке "Данные", см. Обработка данных в шаблоне Pentaho Report Designer. Функции и области шаблона PRD "заголовок группы" и "итого группы". При необходимости посчитать сумму по строкам или столбцам, следует создать SQL-запрос получения данных или Groovy скрипт.

Предпросмотр шаблона PRD

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

Чтобы предварительно посмотреть созданный шаблон PRD, выполните следующие действия:

  1. Нажмите иконку слева вверху экрана.

    На экране отобразится шаблон PRD, построенный согласно настройке.

  2. Чтобы выйти из режима предпросмотра, нажмите иконку слева вверху экрана.