Плагин предназначен для разработки отчётов в HTML формате с гибкими фильтрами. Логика отчёта реализуется с помощью обычных либо динамических Java классов, отображение - JSP шаблоном. Возможна разработка отчётов, где и логика выборки помещена в JSP шаблон, так называемые JSP отчёты. Данный подход обладает следующими недостатками:

  • работа с БД удобнее и стандартнее выполняется в Java коде;

  • невозможно реализация выгрузки данных в различные форматы;

  • смешивание слоёв логики и представления усложняют сопровождение.

Конфигурация

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

report:report.<id>.title=<title>
report:report.<id>.daoClass=<daoClass>

Либо для JSP отчёта:

report:report.<id>.title=<title>
report:report.<id>.jspFile=<jspFile>

Где:

  • <id> - числовая идентификатор отчёта;

  • <daoClass> - обычный либо динамический Java класс, расширяющий

  • <jspFile> - путь к JSP шаблону, генерирующему отчёт, расположенный в каталоге WEB-INF/custom/plugin/report/.

Перенести старые объявления отчётов из XML файлов каталога report в конфигурацию. Поддержка будет в скором времени отключена.

Стандартные отчёты

С программой поставляются встроенные отчёты, конфигурация:

report:report.100.title=Процессы
report:report.100.daoClass=ru.bgcrm.plugin.report.dao.ProcessReportDAO

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

Оснастка "Отчеты"

В оснастке отображаются все сконфигурированные в системе отчёты.

report general

Примеры JSP отчётов

Числовые коды отчётов в конфигурациях примеров даны случайно и в реальной системе могут быть любыми.

Пример отчёта

Поставляется с системой для изучения. Отчёт выводит список процессов с различными фильтрами. В теле отчёта приведена ссылка на JSP страницу с доступными элементами ввода и выведен список справочников.

report sample

Конфигурация:

report:report.1.title=Пример отчёта
report:report.1.jspFile=/WEB-INF/custom/plugin/report/example.jsp

Пример отчёта BGBilling

Поставляется с системой для изучения. Осуществляет прямую работу с базой биллинга. Необходимое дополнительное конфигурирование описано в файле example_bgbilling.jsp

Конфигурация:

report:report.2.title=Пример отчёта BGBilling
report:report.2.jspFile=/WEB-INF/custom/plugin/report/example_bgbilling.jsp

Смены ЦУС

Конфигурация:

report:report.3.title=Отчёт ЦУС по сменам
report:report.3.jspFile=/WEB-INF/custom/plugin/report/ncc_smena.jsp

JSP файл

Должники BGBilling

Выводит должников из базы BGBilling.

image debtors

Конфигурация:

report:report.4.title=Отчет по должникам
report:report.4.jspFile=/WEB-INF/custom/plugin/report/debtors.jsp

В JSP необходима дополнительная конфигурация. JSP файл

В дин. коде установите корректные значения полей billingId, adressParamId, nameParamId и cityId. Dyn файл