FastReport Business Graphics – это библиотека, содержащая несколько продвинутых способов визуализации данных. На сегодняшний день в ней содержатся диаграммы: Treemap, Sunburst, Icicle и диаграмма Гантта.
Сегодня мы рассмотрим, как подключить FastReport Business Graphics .NET к FastReport .NET. Это позволит вам использовать диаграммы из FastReport Business Graphics в ваших отчётах.
В первую очередь вам нужно установить FastReport Business Graphics и FastReport .NET на ваш компьютер. Установка этих продуктов описана в других наших статьях.
В папке установки FastReport .NET находится папка Extras\Objects\FastReportBGObjects. В этой папке откройте проект FastReportBGObjects.csproj. Это – проект для сборки.dll, которая нам нужна.
Откройте список ссылок проекта. Он будет выглядеть таким образом:
Удалите FastReport, FastReport.BG и FastReport.Compat из этого списка. Так как наша цель – добавить FastReport Business Graphics в FastReport .NET, необходимо добавить в проект именно те .dll-файлы, которые будут использоваться во время работы. Взамен удалённых файлов добавьте FastReport.dll и FastReport.Compat.dll из установочной папки FastReport .NET, а также файл FastReport.BG.dll, находящийся в корневой папке установки FastReport Business Graphics.
После того, как вы заменили ссылки на актуальные, соберите проект.
Если сборка прошла успешно, значит вы готовы перейти к следующему шагу инструкции: подключение плагина в FastReport .NET. Собранный dll-файл плагина называется FastReportBGObjects.dll и находится в подпапке проекта: Extras\Objects\FastReportBGObjects\bin\Debug
Вы можете переместить файл в другую папку, но при этом вам придётся делать это каждый раз, как вы собираете его повторно. Для демонстрации я перемещу его в папку C:\DLL.
Рассмотрим два отдельных случая.
1) Вы используете FastReport Designer. В этом случае вам нужно подключить dll-библиотеку в самом дизайнере и перезапустить его, или же указать её расположение в config-файле. Подключить плагин вы можете в меню Настройки – Плагины:
Для добавления ссылки на плагин откройте config-файл с помощью любого текстового редактора и модифицируйте его таким образом:
<?xml version="1.0" encoding="utf-8"?> <Config> ... <Plugins> <Plugin Name="c:\.....\FastReportBGObjects.dll"/> </Plugins> </Config>
Выделенная жирным область – путь к плагину.
2) Вы используете FastReport в составе какого-то проекта. В этом случае добавьте FastReportBGObjects.dll в список ссылок вашего проекта и добавьте следующий код к коду проекта:
RegisteredObjects.Add(typeof(SunburstObject), "ReportPage", 125);
Этот код должен выполняться единожды.
Внимание! Библиотеки FastReportBGObjects.dll и FastReportBG.dll должны дополнительно находиться рядом с приложением, которое их использует. Если вы используете FastReport Designer, скопируйте эти библиотеки в корневую папку приложения, а если используете FastReport Buriness Graphics в своём проекте - расположите их в той же папке, где располагается исполняемый файл.
Итак, после всех этих шагов вы сможете пользоваться продвинутыми диаграммами FastReport Business Graphics внутри отчётов, сгенерированных с помощью FastReport .NET. Если у вас возникнут вопросы по сборке плагина FastReportBGObjects или по подключению его к FastReport .NET, обращайтесь в нашу поддержку.
