Для установки шрифтов в панели меню выберите пункт Tools - Options. В открывшемся окне перейдите на вкладку «Classpath»:

Рисунок 2.1. Окно «Options», вкладка «Classpath»

Мы предлагаем сформированный файл fonts.jar, который сразу можно добавить в iReport. Для этого нажмите на кнопку Add JAR. Откроется диалог выбора ресурса:

Рисунок 2.2. Выбор jar-файла

Выберите нужный файл и нажмите на кнопку ОК.

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

В секции # Font settings изменить значения свойств на следующие (как на стороне сервера, так и в редакторе отчетов):

net.sf.jasperreports.default.font.name=Arial
net.sf.jasperreports.default.font.size=10
net.sf.jasperreports.default.pdf.font.name=Arial
net.sf.jasperreports.default.pdf.encoding=Identity-H
net.sf.jasperreports.default.pdf.embedded=true
net.sf.jasperreports.awt.ignore.missing.font=false

Кроме того, убедитесь, что в библиотеке jasperreports в файле default.jasperreports.properties есть строка вида:

# Query executer settings
net.sf.jasperreports.query.executer.factory.xpath2=com.jaspersoft.jrx.query.JRXPathQueryExecuterFactory

При ее отсутствии работа отчетов в формате xml не гарантируется.

Отчет состоит из следующих основных секций:

Если какая-либо секция в отчете не нужна, то достаточно просто уменьшить ее размер до 0 и не помещать в нее компонентов. Если необходимо, чтобы область начиналась на следующей странице, следует вставить в конец предыдущей области компонент разрыва (Break).

Доступ к редактирования отчета возможен двумя способами:

Откроется окно редактирования запроса отчета:

Рисунок 2.10. Запрос отчета

В поле Query language можно выбрать нужный язык запросов.

Текст запроса можно написать вручную, загрузить из файла txt или sql (кнопка Load query), либо создать с помощью составителя отчетов (кнопка Query designer, необходимо работающее соединение с базой данных).

Полученный текст запроса можно сохранить в файл txt или sql.

В качестве примера напишем простой запрос выбора всех пользователей:

SELECT lastname, firstname, patronymic FROM users

Для упрощения написания запросов рекомендуем обращаться к описанию базы данных Synergy.

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

После завершения составления отчета нажмите на кнопку OK.

После формирования запроса обновляется дерево элементов отчета. Поля, полученные в запросе, содержатся в элементе Fiels. Для того, чтобы отобразить поле в отчете, нужно перетащить поле из дерева в нужную секцию отчета:

Рисунок 2.11. Добавление нового поля в отчет

При этом в отчете одновременно появляются два элемента: Static Text, содержащий заголовок поля, и элемент вида $F{field_name}, содержащий значение поля. Заголовок поля следует расположить в секции Column Header, а значение поля - вплотную под заголовком в секции Detail 1.

Настройки текста, отображаемого в элементе, отображаются в правой части окна при выделении элемента в виде его свойств. В частности, форматирование текста настраивается в группе свойств Text properties:

Рисунок 2.12. Текстовые свойства элемента «Поле»

Аналогично в отчете размещаются и настраиваются остальные элементы.

Часто возникает необходимость формировать отчет с использованием данных, которые должен вводить пользователь. Например, пользователь должен указать условие поиска сотрудников. Для того, чтобы это сделать, в отчете необходимо использовать параметры.

Параметры отчета расположены в правой части окна редактирования запроса:

Рисунок 2.13. Запрос отчета

Для добавления нового параметра нужно нажать на кнопку New Parameter. Откроется окно редактирования параметра:

Рисунок 2.14. Окно редактирования параметра

Обращение к параметру в запросе производится в формате $P{<имя_параметра>}, например:

SELECT * FROM users WHERE lastname LIKE CONCAT($P{params1}, '%')

В результате в отчет будут включены пользователи, чья фамилия начинается на значение, введенное пользователем.

Описание параметра - текст, который будет отображаться пользователю при генерации отчетов из Synergy. Он заполняется в свойстве Description:

Рисунок 2.15. Заполнение описания параметра

2.2.1.4.4.2. Опциональные параметры

Для того, чтобы параметр стал опциональным, необходимо добавить для него специальное свойство:

1. Выбрать нужный параметр в дереве объектов

Рисунок 2.16. Выбранный парамер в дереве объектов

2. В свойствах параметра (Properties в правой части окна) открыть список свойств параметра:

Рисунок 2.17. Список свойств параметра

3. Нажать на кнопку Add и добавить новое свойство kz.arta.synergy.reports.parameters.optional с любым значением:

Рисунок 2.18. Добавление нового свойства параметра

Чтобы проверить значение опционального параметра в отчете, используется условие вида:

IF($P{param}='', true, t=$P{param})

То есть если параметр param не задан, его значение не учитывается (результат сравнения true). Если параметр задан, то он сравнивается с переменной t.

Если же параметр - это мультивыбор значения справочника, то условие имеет вид:

IF('$P!{param_dictionary}' <> '[]', $X{IN, t, param_dictionary}, true)

То есть если список значений param_dictionary не имеет элементов, то условие считается верным, иначе - выполняется проверка, содержится ли (ключевое слово IN) значение поля t в значениях param_dictionary. Если необходимо проверить, что значение поля не содержится в списке значений параметра, можно использовать ключевое слово NOTIN.

Для просмотра результата составления отчета нужно перейти во вкладку Preview.

Если отчет содержит параметры, то в первую очередь отобразится диалог ввода параметров:

Рисунок 2.19. Ввод параметров отчета

Для использования значения по умолчанию нужно нажать на кнопку Use default.

После ввода параметра отображается результат составления отчета, содержащий данные, полученные в результате выполнения запроса:

Рисунок 2.20. Итоговый вид отчета

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

1. Получение информации о карточке документа и его визах (подписях, согласованиях и т.д.)

Сервис доступен по ссылке:

http://host:port/Synergy/docsightings?docID={elementid}&type={type}

Здесь:

Пример получаемых данных:

<document>
   <docInfo>
      <number />
      <subject>111111 - 23333</subject>
      <regDate />
      <author>Ермолаев М.О.</author>
      <docType>Служебные записки между департаментами</docType>
      <registry />
   </docInfo>
   <signatures>
      <signature>
         <userID>73635fff7b742f7aa5af93c96bd6c2ae</userID>
         <userName>Ермолаев М.О.</userName>
         <position>Председатель правления</position>
         <signDate>20.11.2014 10.25.26</signDate>
         <comment />
         <signType>Согласовано</signType>
         <signResult>Согласовано</signResult>
         <value>Обычная</value>
      </signature>
      <signature>
         <userID>a8773e4f56b4cc73381bb1e74d479902</userID>
         <userName>Абдазимова Г.А.</userName>
         <position>Инженер ПО</position>
         <signDate>19.11.2014 10.31.53</signDate>
         <comment>Согласен</comment>
         <signType>Согласовано</signType>
         <signResult>Согласовано с комментарием</signResult>
         <value>Обычная</value>
      </signature>
   </signatures>
</document>

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

Формат вызова: getFullName(userID, addPosition)

Функция возвращает полное имя пользователя в формате Фамилия И.О..

Параметр addPosition регулирует, передавать ли дополнительно должность пользователя.

Примеры использования:

Select getFullName('<userID>', true)

Select getFullName('<userID>', false)

3. Сортировка по иерархической структуре подразделений

Во многих отчетах требуется сортировать данные согласно какой-либо иерархической структуре, например, по департаментам. В таблице departments есть поле struct_number вида 1.2.1. Поскольку это строковое поле, сортировать по этому полю прямо не получится. Для сортировки по департаментам используется функция вида:

getStruct(struct_number)

Пример использования:

SELECT nameru FROM departments WHERE deleted IS NULL ORDER BY getStruct(struct_number) - отобразить названия неудаленных подразделений, отсортированные согласно иерархии в орг.структуре.

Сохраняет информацию об отчетах в базу, формирует отчеты.

svn+ssh://scm.forge.arta.local/var/lib/gforge/chroot/scmrepos/svn/synergy/trunk/reports/ReportBean

Модуль представляет собой стандартную кнопку отчетов (о ней далее).

svn+ssh://scm.forge.arta.local/var/lib/gforge/chroot/scmrepos/svn/synergy/trunk/reports/clientmodule

Админка отчетов svn+ssh://scm.forge.arta.local/var/lib/gforge/chroot/scmrepos/svn/synergy/trunk/reports/Admin