4.12.4. Работа с модулем конструирования отчетов 4.12.4.1. Установка
1. Для установки необходимо на компьютере пользователя извлечь архив дистрибутива в папку ReportDesigner.
2. В папке ReportDesigner следует запустить файл с именем startdesigner, который подходит для вашей операционной системы (рис. 26).
Рисунок 26 – Папка ReportDesigner
4.12.4.2. Добавление образца набора данных
Для добавления образца набора данных в окне инструментов «Структура» следует нажать правой кнопкой мыши на узел "Наборы данных" и выбрать в появившемся всплывающем меню пункт "Добавить набор данных" (рис. 27).
Рисунок 27
В появившемся окне можно сконфигурировать запрос, используемый набором данных (рис. 28).
Рисунок 28 – Запрос
Можно использовать для построения запроса конструктора запросов. Для этого надо открыть его с помощью кнопки «Конструктор запросов». После формирования запроса можно посмотреть результат его выполнения с помощью кнопки «Preview». В рассматриваемом примере используется таблица «Products», которая состоит из некоторого списка продаж, где отображены клиенты, купившие несколько DVD (рис. 29).
Рисунок 29
При нажатии на кнопку «ОК» набор данных добавляется в отчет. Окно инструментов «Свойства» отображает доступные колонки и тип данных каждой колонки (рис.30). Изменить конфигурацию набора данных можно нажатием на кнопку «Конфигурация».
Рисунок 30
4.12.4.3. Работа с областью определения отчета
Область определения отчета – это центральная часть конструктора отчета. Она используется для графического оформления и предварительного просмотра отчета. Рис. 31 показывает одну из секций области определения отчета.
Рисунок 31
При нажатии мышью на описание секции будут получены входные данные данной секции. Вызов команд, таких как «выделить все» или «вставить», будет происходить в контексте этой секции. Текущее выделение не изменяется этим действием.
При нажатии на границы страницы секция выделится и получит входные данные. При нажатии на область содержимого секция получает входные данные, а также возможно выделятся элементы под курсором.
Секция может быть изменена в размерах, путем растягивания разделителя секций. Это никак не влияет на внешний вид сгенерированного отчета и делается только для удобства в процессе разработки отчета (рис. 32).
Рисунок 32
4.12.4.4. Добавление элементов в определение отчета
Интерфейс отчета содержит набор элементов, которые можно размещать в области определения отчета в соответствующих секциях. Элементы отчета – это отдельные компоненты, которые в целом формируют сам отчет.
Существуют статичные элементы, а также элементы, которые динамично наполняются данными из базы данных.
Например, для создания статичной надписи, которая будет печататься на первой странице, необходимо поместить элемент этой надписи в секцию заголовка отчета. Такая надпись не зависит от предоставленной набором данных информации, поэтому она называется статичной.
Для добавления элемента надписи следует выбрать элемент отчета "Надпись" в окне инструментов «Палитра» и перетащить его удержанием кнопки мыши в полосу заголовка отчета (рис. 33).
Рисунок 33
При помощи мыши можно перемещать надпись или менять ее размеры, растягивая границы надписи. Окно инструментов «Свойства» позволяет скорректировать текст элемента и используемый шрифт (рис. 34).
Рисунок 34
Если первоначально не изменить размер надписи, то в окне инструментов «Сообщения» может появиться предупреждение о том, что границы надписи не достаточно расширены для отображения текста. С помощью мышки можно растянуть границы надписи до размеров, достаточных для отображения содержимого. Сообщение с предупреждением исчезает, как только устанавливается подходящий размер надписи.
Внешний вид секции заголовка отчета представлен на рис. 35.
Рисунок 35
Предварительный просмотр отчета осуществляется нажатием на кнопку «Просмотр» в нижней части области определения отчета (рис. 36).
Рисунок 36
Предварительный просмотр отчета выглядит так же, как и конечный вариант, только имеет ограниченное число строк. Процесс загрузки происходит один раз, последующие вызовы предварительного просмотра выполняются практически мгновенно. Вернуться обратно в режим разработки можно нажатием кнопки «Конструктор».
Для добавления в отчет текстовых полей, в которых будет отображаться информация из набора данных, используется элемент «Поле-текст». Элемент «Поле-текст» необходимо перетащить с помощью мыши из окна инструментов «Палитра» в секцию деталей (рис. 37). Такие элементы отчета, динамически наполняемые данными, имеют префикс «field».
Рисунок 37
Каждое текстовое поле должно отображать колонку из набора данных. Поэтому необходимо установить для каждого текстового поля свойство "Имя поля" в окне инструментов «Свойства» таким образом, чтобы они совпадали с колонками из набора данных (рис. 38).
 
Рисунок 38
Элементы секции могут быть выбраны нажатием кнопки мыши. Если под курсором мыши находится множество наложенных друг на друга элементов, то можно повторно нажимать на одно и то же место, и по очереди будут выбираться возможные элементы. Сразу несколько элементов можно выбрать с помощью удерживания кнопки «CTRL».
Двойной щелчок мыши на элементе текста запускает режим линейного редактирования, при котором можно набирать текст, как в любом другом текстовом поле. Выход из данного режима с помощью клавиши «Enter» сохранит внесенные изменения, а с помощью клавиши «Escape» - не сохранит внесенные изменения.
Всплывающее меню для таких часто используемых команд, как копирование и вставка, доступно с помощью нажатия правой кнопки мыши (рис. 39).
Рисунок 39
4.12.4.5. Работа с функциями
Функции могут быть добавлены в окне инструментов «Структура» в пункте меню "Функции отчета". Все доступные функции перечислены в окне инструментов «Свойства» с коротким описанием в строке-подсказке (рис. 40).
Рисунок 40
Для подсчета суммы цен всех наименований в отчете необходимо выбрать в разделе математических функций пункт "ItemSumFunction (сумма)" и нажать на кнопку «Добавить функцию в отчет» (рис. 41).
Рисунок 41
Для задания функции необходимо указать поле для подсчета суммы и имя функции. Значение суммы будет доступно с помощью этого имени. В окне инструментов «Сообщения» отображается ошибка до тех пор, пока не установлено имя. При отображении ошибки предварительный просмотр отчета недоступен.
В рассматриваемом примере поле «BUYPRICE» используется при подсчете суммы, колонка «ИТОГО» выступает в качестве имени функции.
Для отображения этого значения в отчете можно добавить текстовое поле в секцию нижнего колонтитула отчета и установить свойству «Имя поля» значение имени функции «ИТОГО» (рис. 42).
 
Рисунок 42
На рис. 43 изображен предварительный просмотр отчета.
Рисунок 43
4.12.4.6. Работа с группами отчета
Группы могут быть добавлены в окне инструментов «Структура». Для этого необходимо выделить узел "Группы" и выбрать пункт меню "Добавить группу".
Группа объединяет или группирует все последующие наименования с одинаковыми значениями. Каждый раз при начале новой группы печатается верхний колонтитул этой группы, а при окончании группы - нижний колонтитул группы.
Для создания групп клиентов необходимо задать группе связь с полями «CONTACTFIRSTNAME» и «CONTACTLASTNAME». (Только поля «CONTACTFIRSTNAME» будет недостаточно, так как в списке могут присутствовать потребители с одинаковыми именами ). Поэтому следует установить значения свойства «Поля группы» так, как показано на рис. 44:
Рисунок 44
Кроме того, рекомендуется дать группе осмысленное название. В рассматриваемом примере используется имя группы «Группа потребителей».
В окне инструментов «Структура» можно увидеть, что доступны также секции верхнего и нижнего колонтитула группы. Эти секции еще не появились в области графического определения отчета. Для того чтобы сделать их видимыми достаточно выбрать обе секции в окне инструментов «Структура» и активизировать свойство «Показывать в дизайнере» (рис. 45).
Рисунок 45
После этого секция верхнего колонтитула группы появится над секцией деталей и секцией нижнего колонтитула группы (рис. 46).
Рисунок 46
Чтобы группа визуально отображалась, необходимо переместить текстовые поля «CONTACTFIRSTNAME» и «CONTACTLASTNAME» в заголовок группы. Для этого можно удалить существующие поля и создать новые в заголовке группы или вырезать и вставить их. Выбор обоих полей в графическом отображении или в окне инструментов «Структура» осуществляется путем удержания клавиши «CTRL» и выбора полей курсором мыши.
Для вырезания элемента используется выпадающее меню (рис. 47)
Рисунок 47
Вставка элемента осуществляется нажатием правой кнопкой на полосу заголовка группы и выбором функции «вставить» (рис. 48):
Рисунок 48
Внешний вид секции после перемещения элементов представлен на рис. 49.
Рисунок 49
Добавление общей суммы для отдельной группы почти полностью идентично определению и вставке общей суммы по всему отчету в целом и осуществляется следующей последовательностью действий:
выбор узла «Функции отчета» в окне инструментов «Структура»;
выбор функции «ItemSumFunction» и добавление ее к отчету;
ввод значения «BUYPRICE» в качестве поля, «Группа потребителей» в качестве группы и «ИТОГО ЦЕНЫ ПО ПОТРЕБИТЕЛЯМ» в качестве имени функции;
добавление текстового поля в секцию нижнего колонтитула группы. В поле «Имя поля» следует выбрать функцию «ИТОГО ЦЕНЫ ПО ПОТРЕБИТЕЛЯМ» (рис. 50).
Рисунок 50
В результате получается отчет, суммирующий общие продажи и подсчитывающий общую сумму для каждого из клиентов (рис. 51).
Рисунок 51
4.12.5. Работа с мастером конструирования отчетов 4.12.5.1. Установка и конфигурация
Для установки мастера конструирования отчетов следует распаковать архив дистрибутива. Путь к каталогу расположения дистрибутива следует в рамках руководства условно назвать «{WIZARDROOT}».
Мастер конструирования отчетов распространяется в ZIP-архиве, он является уже сконфигурированным, поэтому нет никакого процесса установки или настройки, кроме извлечения из архива.
Для использования источника данных JNDI, необходимо отредактировать файл «{WIZARDROOT}/ resources/solutions/system/simplejndi/jdbc.properties». В указанный файл необходимо добавить следующие строки:
SampleData/type=javax.sql.DataSource
SampleData/driver=org.hsqldb.jdbcDriver
SampleData/url=jdbc:hsqldb:hsql://localhost/sampledata
SampleData/user=pentaho_user
SampleData/password=password
Правые части равенств представляют собой параметры «имя/значение». Эти параметры используются для конфигурации информации соединения. Имя «SampleData» – это имя установленного JNDI-соединения. В настройках присутствуют следующие значения:
«type» - сообщает JNDI - соединению о типе источника данных, в рассматриваемом примере указан источник данных SQL;
«driver» – это имя класса JDBC-драйвера для используемой базы данных;
«url» – это строка JDBC-соединения для сервера; в рассматриваемом примере используется локальный сервер базы данных Hypersonic;
«user», «password» - это имя пользователя и пароль для подключения к базе данных.
Для установки драйвера базы данных необходимо, чтобы драйверы были расположены в папке «{WIZARDROOT}/lib/jdbc». Драйвер базы данных Hypersonic включен в мастер конструирования отчетов в каталоге «{WIZARDROOT}/lib/jdbc». Дополнительные драйверы могут быть выложены в том же самом месте и будут найдены приложением автоматически.
Самый простой тип соединения, который можно создать – это XQuery соединение. Используя файл XML-данных, с помощью мастера можно создать спецификацию отчета. В каталоге «{WIZARDROOT}/samples/data» есть файл XML-данных под названием Quad_Data.xml. Этот файл представляет собой те же самые данные, что и в базе данных Hypersonic.
4.12.5.2. Запуск
Запуск осуществляется двойным нажатием на файл reportwizard.bat.
Существует возможность создать отчет с нуля или продолжить работу с уже существующим отчетом. Мастер конструирования отчетов поддерживает шаблоны. Шаблоны являются заранее заданными определениями (макетами) для специальных типов отчетов (например, счет-фактур клиента) и поддерживают использование пользователем подстановок.
Поле «Имя отчета» используется для установки имени отчета в определении JFreeReport XML, а также в качестве имени файла временного пути решения АИС ЛОД. Временный путь указывает на каталог, в котором хранятся отчеты, сгенерированные для предварительного просмотра. Когда отчет экспортируется, по заданному пути копируется несколько файлов: определение JFreeReport XML, документ Pentaho Report-Spec, изображения, используемые в отчете (водяные знаки) и документ последовательности действий, необходимый для составления отчета с помощью механизма ядра решений АИС ЛОД.
Рисунок 52
4.12.5.3. Работа с запросом
В первом пункте мастера необходимо выбрать в качестве шаблона «Чистый» и нажать кнопку «Далее» (рис. 52). После этого осуществится переход в пункт «Запрос».
В рассматриваемом примере используется следующий запрос:
«select QUADRANT_ACTUALS.REGION, QUADRANT_ACTUALS.DEPARTMENT,
QUADRANT_ACTUALS.POSITIONTITLE, QUADRANT_ACTUALS.ACTUAL,
QUADRANT_ACTUALS.BUDGET, QUADRANT_ACTUALS.VARIANCE
from QUADRANT_ACTUALS
order by QUADRANT_ACTUALS.REGION,QUADRANT_ACTUALS.DEPARTMENT».
На данном шаге предоставляется выбор типа соединения JNDI или XQuery (рис.53). Для базы данных «SampleData» следует выбрать тип JNDI.
Рисунок 53
4.12.5.3.1. JNDI-соединение
Для создания нового JNDI-соединения необходимо нажать на кнопку «Добавить» и ввести JDBC-данные для JNDI-соединения. Требуется задать имя для подключения. Список драйверов, найденный в каталоге «lib/jdbc» заполняется автоматически (рис. 54).
Рисунок 54 - Добавление нового JNDI-соединения.
После нажатия кнопки «ОК» соединение становится доступно в списке JNDI-соединений (рис. 55).
Рисунок 55
4.12.5.3.2. Мастер запросов
SQL запросы можно проектировать с помощью конструктора запросов. Конструктор запросов позволит графически конструировать запрос, что значительно облегчает задачу (рис. 56).
При использовании MDX вместо SQL необходимо выбрать параметр «Использовать Мондриан-описание куба (MDX)» и затем выбрать Mondrian файл определения куба. Возможно ввести MDX-запрос для Mondrian куба.
Рисунок 58
Для использования XQuery с шаблонными данными следует загрузить файл Quad_Data.xml, который находится в каталоге: «{WIZARD_ROOT}/samples/data». Для этого типа соединения необходимо использовать запрос «/result-set/*». В качестве более сложного запроса можно выбрать данные только для центрального региона. Такой запрос выглядит следующим образом: «/descendant::row[REGION='Central']».
4.12.5.3.3. Подстановки шаблона
В отчетах, которые создаются на основе шаблона, можно использовать подстановки. При использовании шаблона отчета необходимо задать значения определенных надписей, которые будут использованы в отчете. У шаблонов также будут пользовательские заголовки и нижние колонтитулы, относящиеся к определенным столбцам из запроса. Имя столбца в шаблоне невозможно определить заранее, поэтому используется подстановка в шаблоне.
Установка значения подстановки для значения «Report_Title» производится в поле «Другое значение» (рис. 57).
Рисунок 57
Существует три различных вида подстановок. Подстановка надписи - это простая замена текста, используемого только для отображения. Подстановка данных используется для изменения столбца, который будет отображен в отчете в секции данных. Подстановка группы используется для настройки групп отчета. Когда осуществлена подстановка групп, мастер автоматически обновляет отчет, и нужные столбцы используются в качестве групп.
4.12.5.4. Макет отчета
После определения запроса следует перейти к определению области данных и групп (рис. 58). По умолчанию, все возвращаемые запросом столбцы помещаются в область данных. Группировка данных не является обязательной. В рассматриваемом примере осуществляется выбор двух групп «QUADRANT_ACTUAL_REGION» и «QUADRANT_ACTUAL_DEPARTMENT», по которым и будут сгруппированы данные отчета. В отчете будет четыре столбца с данными и две группы.
Следует обратить внимание, что на данном этапе мастер дает возможность сортировать область данных и групп. Порядок расположения данных указывает также и порядок расположения столбцов в отчете. Если рассматривать группы как вложенные, то группа на верхнем уровне вложенности – наивысшая в списке групп и группа на самом нижнем уровне вложенности соответственно самая нижняя в списке.
Рисунок 58 - Этап работы с настройками расположения
4.12.5.5. Параметры формата
Шаг задания параметров формата не является обязательным. На данном шаге можно придать форму будущему отчету. Для каждого поля существует свой набор настроек, который может быть установлен (рис. 59).
 Рисунок 59 - Форматирование отчета
Текстовое поле «Отображаемое имя» позволяет вводить осмысленное имя столбца. Таким образом, если имя столбца по умолчанию будет не наглядным, существует возможность присвоить ему другое значение. Поле «Пустая строка» является текстовой заменой, используемой при отсутствии данных. По умолчанию это поле имеет значение «-».
Для создания итоговой строки для группы в ее нижнем колонтитуле используются выражения. Если не выбрано ни одно из выражений, то нижний колонтитул группы будет пустым. Типы выражений отбираются согласно назначению столбца.
В рассматриваемом примере следует задать выражение суммы полям «QUADRANT_ACTUALS_ACTUAL», «QUADRANT_ACTUALS_BUDGET» и «QUADRANT_ACTUALS_VARIANCE». Для каждой группы данные выражения будут отображены в нижнем колонтитуле.
Раздел ширины столбца доступен только для области данных, но не доступен для групп. Ширина выражается в процентах, где 100% - это максимально возможно значение. По умолчанию значения создаются путем разделения всей ширины (100% пространства) на равные части в зависимости от количества столбцов. Столбец «QUADRANT_ACTUALS_POSITIONTITLE» содержит данные строкового типа, занимающие больше места, чем числовые поля. Поэтому рекомендуется установить этому столбцу 40% от ширины используемой страницы, а остальное пространство поделить на равные части. Таким образом, «QUADRANT_ACTUALS_ACTUAL», «QUADRANT_ACTUALS_BUDGET» и «QUADRANT_ACTUALS_VARIANCE» будут занимать по 20% ширины. Следует удостовериться, что в сумме ширина будет составлять не более 100%.
Для полей, которые используются как группы, целесообразно делать разрыв страницы при начале новой группы путем включения или выключения флажка «Разрыв страницы после нижнего колонтитула». Также возможно повторить заголовки групп на каждой странице, входящей в состав данной группы, путем включения или выключения флажка «Повторять верхний колонтитул при переносе на другую страницу».
Для каждого поля по умолчанию задано горизонтальное выравнивание по левому краю. Возможно изменить выравнивание, установив значение выравнивания по правому краю или по центру. Выравнивание в группах задает место расположения группы в заголовке. Например, внешнюю группу Группа «QUADRANT_ACTUALS_REGION» можно расположить по центру. Возможно также задавать вертикальное выравнивание, по умолчанию оно установлено по центру.
Мастер области данных создает специальный заголовок групп для самой вложенной группы (последняя группа в списке «Группы»), отображаемый под заголовком столбца и над данными.
Кроме того, возможно задать цвет фона для группы, причем заданный цвет фона для группы будет использоваться до тех пор, пока не будет специально отключен. Мастер области данных также получит собственный заголовок столбца, так что потребуется сдвинуть столбцы. Мастер конструирования отчетов делает это автоматически, принимая за основу заданную ширину в параметрах столбца. Следует заметить, что ширина столбца мастера области данных должна быть задана, иначе она будет установлена равной нулю, и столбец не будет отображаться в отчете.
На рис. 60 проиллюстрирована работа мастера форматирования.
Рисунок 60 - Форматирование отчета
4.12.5.6. Параметры страницы
На этапе настройки параметров страницы задаются такие параметры, как формат страницы, границы и водяные знаки.
Параметры бумаги состоят из трех разделов: ориентация, размеры страницы и поля.
Ориентация устанавливается книжная или альбомная. Для представленного примера выбирается книжная ориентация.
Размеры страницы рассматриваются как тип используемой бумаги. По умолчанию выбрано значение «LETTER». Другие часто используемые варианты – «LEGAL» и «A4». Список поддерживаемых типов страниц достаточно длинный.
Поля задают отступы от краев со всех сторон. В рассматриваемом примере задается значение отступа «12».
Водяной знак – это элемент страницы, который отображается в качестве фонового изображения. Изображение не должно мешать отображению отчета. Можно выбрать файл, содержащий изображение, с помощью кнопки «Найти». Ширина, высота, настройки координат X и Y для водяного знака также основаны на процентном соотношении. Флажок масштаба указывает, следует ли растягивать изображение для соответствия установленным значениям ширины и высоты. Сохранение коэффициента пропорциональности означает сохранение соотношения высоты и ширины в оригинальной пропорции при растягивании изображения. Эти параметры позволяют избежать превращения прямоугольного изображения в квадратное или наоборот.
На рис. 61 проиллюстрирована настройка страницы.
Рисунок 61
4.12.5.7. Дополнительные параметры отчета 4.12.5.7.1. Вкладка «Параметры»
Пункт дополнительных параметров отчета позволяет задать некоторые общие настройки отчета, такие как чередование подсветки строк, линии координатной сетки и шрифты.
Чередование подсветки строк используется для улучшения читаемости отчета. Данное свойство позволяет изменить фоновый цвет каждой строки. Чтобы включить чередование подсветки, необходимо выбрать значение «Использовать чередование подсветки строк». Окно выбора цвета открывается нажатием на расположенную рядом кнопку.
При использовании линий координатной сетки можно задавать отображение вертикальных и горизонтальных линий сетки и задавать их цвет.
Горизонтальное смещение сдвигает отчет вправо. Величина смещения выражается в процентах по отношению ко всему пространству. При этом перемещение сдвигает все элементы отчета, включая заголовки групп, заголовки столбцов и секцию данных.
Возможна ситуация, когда группа связанных между собой отчетов входит в основной отчет или заголовок страницы, но при этом существует как отдельный XML файл. Этот файл может быть включен в отчет, таким образом можно произвести настройку, которую невозможно сделать с помощью мастера.
4.12.5.7.2. Вкладка «Выражения»
Данная вкладка используется для конфигурации разнообразных свойств отчета. С его помощью можно рассчитать общий итог (подсчет по всем группам), настроить подчеркивание подсчитываемых значений одной или двумя чертами, задать цвет фона общего итога.
4.12.5.7.3. Вкладка «Заголовки столбцов»
Заголовки столбцов создаются для самой вложенной группы, так что их значения по умолчанию берутся из настроек этой группы. При необходимости можно вручную настроить высоту заголовка столбца и цвет его фона.
4.12.5.7.4. Вкладка «Шрифты»
Шрифты могут определяться для всех наиболее важных частей отчета. На данной вкладке также предоставляется предварительный просмотр шрифта.
Работа с дополнительными опциями представлена на рис. 62.
Рисунок 62
4.12.5.7.5. Предварительный просмотр
Все параметры, установленные в мастере, используется для создания XML документа спецификации отчета. Для предварительного просмотра отчета спецификация отчета соединяется с шаблоном в XML-файле JFreeReport. К XML-файлу JFreeReport затем обращается последовательность действий для создания выходных данных. Выходные данные в формате PDF, HTML или Excel отображаются в компоненте SWT-браузера, который позволяет осуществлять предварительный просмотр отчета прямо в мастере PDF, HTML или Excel.
Предварительного просмотр производится по нажатию кнопки «Просмотр». При закрытии предварительного просмотра происходит возврат назад к приложению мастера. Таким образом возможно корректировать и уточнять настройки отчета.
С помощью SWT-браузера возможно использовать надстройку Adobe Reader в мастере. Внешний вид предварительного просмотра отчета представлен на рис. 63.
Рисунок 63
После того как отчет будет полностью настроен, следует нажать на кнопку «ОК» для завершения работы Мастера конструирования отчетов.
|
