Формирование отчетов средствами Rave Reports

В Delphi 7 появилась новая система создания отчетов Rave Reports. Система состоит из двух частей: конструктора отчетов Rave и компонентов Rave, подключающих сохранен­ную форму отчета к приложению. Чтобы вызвать конструктор Rave, нужно выполнить команду Tools/Rave Designer.

Данный пункт подготовлен М.В. Зыковым.

Компоненты отчета

RvProject - компонент предназначен для связи с Rave и подключения формы отчета к приложению. Это основной компонент проекта.

Специфичные свойства

ProjectFile - подключает к приложению файл *.rav, в котором хранятся формы отчетов.

Engine - позволяет подключить компонент TRvSystem, содержащий дополнительные опции просмотра и печати отчетов.

Специфичные методы

Open - открывает проект, заданный свойством ProjectFile этого компонента. (frmReport.RvProject1.Open).

LoadFromFile(Filename: string) - открывает проект, заданный параметром Filename.

Save- сохраняет отчет в текущий файл.

SaveToFile(Filename: string) – сохраняет проект в файл под именем, заданным параметром Filename.

Close - закрывает проект и освобождает занимаемую им память (frmReport.RvProject1.Close).

Execute - вызывает выполнение текущего отчета.

ExecuteReport(ReportName: string) - вызывает выполнение отчета, имя которого указано в параметре ReportName.

GetReportList(ReportList: TStrings; Fullname: Boolean) - каждый проект Rave может содержать несколько отчетов. Этот метод возвращает список отчетов проекта, причем если аргумент Fullname=True, то возвращается имена, заданные свойствами FullName отчетов. Если аргумент Fullname=False, то возвращаются имена, заданные свойствами Name отчетов.

SelectReport(ReportName: string, FullName: Boolean) – делает отчет, за­дан­ный параметром ReportName, текущим. Параметр FullName имеет тот же смысл, что и в GetReportList.

Специфичные события

BeforeOpen/AfterOpen- наступают до/после открытия отчета.

BeforeClose/AfterClose- наступают до/после закрытия отчета.

RvSystem - обеспечивает дополнительные возможности настройки просмотра и печати отчетов. Объединяет в себе свойства компонентов RvRenderPreview и RvRenderPrinter.

Специфичные свойства

DefaultDest- устанавливает операцию, выполняемую по умолчанию: предварительный просмотр отчета, вывод его в файл или на принтер.

SystemOptions- свойство с множеством подсвойств, управляющих выводом диалогового окна Output Options.

soUseFiler - возможность направить вывод отчета в файл, заданный под­свойством FileName свойства SystemFiler, независимо от других настроек компонента.

soWaitForOK - возможность задержать генерацию отчета до момента, ког­да пользователь нажмет кнопку ОК в диалоге настройки печати компонента.

soShowStatus - управляет видимостью окна процесса вывода отчета.

soAllowPrintFromPreview – управляет возможностью печатать отчет из окна предварительного просмотра.

soPreviewModal - делает окно предварительного просмотра модальным.

SystemPreview- список свойств, управляющих предварительным прос­мот­ром отчета.

SystemSetups- список свойств, делающих доступными или не доступными некоторые опции диалогового окна Output Options.

SystemPrinter- список свойств, управляющих печатью отчета.

ssAllowSetup - разрешает или запрещает использование диалога настройки печати.

ssAllowCopies - разрешает/запрещает устанавливать число копий отчета.

ssAllowCollate - разрешает/запрещает установку режима печати с раз­бо­ром страниц по копиям.

ssAllowDuplex - разрешает/запрещает настройку двусторонней печати.

ssAllowDestPreview - разрешает/запрещает использование окна предва­рительного просмотра.

ssAllowDestPrinter - разрешает/запрещает использование принтера.

ssAllowDestFile - разрешает/запрещает использование файла для вывода отчета.

ssAllowPrinterSetup - разрешает/запрещает использование диалога настройки параметров принтера.

RvNDRWriter- записывает отчет в файл специального формата, пригодного для просмотра и печати.

RvCustomConnection- устанавливает способ передачи данных в отчет.

RvDataSetConnection - соединяет с наборами данных, потомками класса TDataSet. Свойство DataSet подключает к отчету Rave набор данных.

RvTableConnection- соединяет с наборами данных Table. Свойство Table содержит имя таблицы типа TTable.

RvQueryConnection- соединяет с наборами данных Query. Свойство Query содержит имя компонента типа TQuery.

RvRenderPreview- пересылает данные из файла, созданного ком­по­нентом RvNDRWriter, на экран для предварительного просмотра.

RvRenderPreview- пересылает данные из файла, созданного компонентом RvNDRWriter, на текущий принтер.

RvRender - конвертирование отчетов в файлы форматов PDF, HTML, RTF, TEXT. Варианты сохранения отчета добавятся в меню Format окна Output options.

Конструктор отчетов

Конструктор отчетов Rave Reports служит для разработ­ки форм отчетов. Чтобы вызвать конструктор Rave, нужно выполнить команду Tools/Rave Designer или дважды щелкнуть по компоненту RvProject, и появится окно конструктора отчетов (рис. 3.11.2.1).

В дереве проекта отчетов (в правой части окна конструктора) имеются следующие вершины.

Report Library (библиотека отчетов) – содержит все отчеты проекта. При запуске конструктора текущим становится первый отчет. Двойным щел­ч­ком мыши в дереве проекта можно установить текущим нужный отчет.

Рис. 3.11.2.1. Окно конструктора отчетов

 

Отчет имеет специфические свойства:

FullName - определяет полное имя отчета (допускается краткое описание отчета, можно использовать символы кириллицы).

PageList - список страниц отчета, редактор этого свойства можно вызвать кнопкой с многоточием; в окне редактора можно добавлять в отчет глобальные страницы и изменять порядок вывода страниц.

Parameters/PIVars - список параметров/переменных отчета. Параметры и переменные используются при написании кодов обработки событий, воз­ни­кающих во время выполнения отчета.

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

Global Page Catalog (каталог глобальных страниц) - содержит перечень глобальных страниц проекта. Глобальные страницы доступны для любого отчета в проекте, на них удобно располагать титульные листы, рамки для чертежей и т.п. Чтобы добавить в отчет пустую глобальную страницу, нужно выполнить команду File/New Global Page. Глобальные страницы добавляются в отчет с помощью редактора списка страниц.

Data View Dictionary (словарь просмотра данных) - содержит перечень объектов, соединенных с данными из внешних источников. Пользователь может добавить в проект новый объект данных, выполнив команду File/New Data Object. При этом откроется диалоговое окно Data Connections, в котором для выбора предлагаются следующие типы объектов:

Data Lookup Security Controller - контроллер безопасности просмотра данных. Обеспечивает аутентификацию пользователей по имени и паролю;

Database Connection - соединение с внешней базой данных с использованием технологий ADO, BDE, dbExpress;

Direct Data View - прямой просмотр данных. Создает просмотр данных для активного соединения с источником, например с компонентами данных Rave в приложении Delphi;

Driver Data View - просмотр данных с помощью драйвера. Создает просмотр данных на основе уже имеющегося в словаре соединения;

Simple Security Controller - простой контроллер безопасности. Поддерживает список пар «имя пользователя = пароль» для организации доступа к отчету.