FastReport Business Graphics jest biblioteką, która zawiera kilka zaawansowanych sposobów wizualizacji danych. Do tej pory zawiera diagramy: Treemap, Sunburst, Icicle oraz wykres Gantta.
Dzisiaj zajmiemy się tym, jak podłączyć FastReport Business Graphics .NET do FastReport .NET. Dzięki temu będziesz mógł wykorzystać w swoich raportach wykresy z FastReport Business Graphics.
Pierwszą rzeczą, którą musisz zrobić, to zainstalować FastReport Business Graphics i FastReport .NET na swoim komputerze. Instalacja tych produktów jest opisana w innych naszych artykułach.
W folderze instalacyjnym FastReport .NET znajduje się folder Extras\Objects\FastReportBGObjects. W tym folderze otwórz projekt FastReportBGObjects.csproj. To jest projekt dla assembly.dll, który jest nam potrzebny.
Otwórz listę linków projektu. Będzie ona wyglądać tak, jak na zdjęciu:
Usuń FastReport, FastReport.BG i FastReport.Compat z tej listy. Ponieważ naszym celem jest dodanie FastReport Business Graphics do FastReport .NET, powinieneś dodać dokładnie te pliki .dll, których będziesz używał w projekcie. W miejsce usuniętych plików dodaj FastReport.dll i FastReport.Compat.dll z katalogu instalacyjnego FastReport .NET oraz plik FastReport.BG.dll z katalogu głównego instalacji FastReport Business Graphics.
Po zastąpieniu linków na aktualne, zmontuj projekt.
Jeżeli kompilacja przebiegła pomyślnie, jesteś gotowy do następnego kroku instrukcji: podłączenie wtyczki do FastReport .NET. Zmontowany plik dll pluginu nazywa się FastReportBGObjects.dll i znajduje się w podkatalogu projektu: ExtrasObjectsFastReportBGObjectsDebug.
Możesz przenieść plik do innego folderu, ale będziesz musiał to robić za każdym razem, gdy będziesz budował go ponownie. Dla celów demonstracyjnych, przeniosę go do folderu C:\DLL.
Przyjrzyjmy się dwóm odrębnym przypadkom.
1) Korzystasz z FastReport Designer. W tym przypadku należy podłączyć bibliotekę dll do samego projektanta i zrestartować go, lub można określić jej lokalizację w pliku konfiguracyjnym. Wtyczkę można podłączyć w menu Ustawienia - Wtyczki:
Aby dodać link do wtyczki, otwórz plik konfiguracyjny za pomocą dowolnego edytora tekstu i zmodyfikuj go w następujący sposób:
<?xml version="1.0" encoding="utf-8"?> <Config> ... <Plugins> <Plugin Name="c:\.....\FastReportBGObjects.dll"/> </Plugins> </Config>
Obszar zaznaczony wytłuszczoną czcionką to ścieżka do wtyczki.
2) Używasz FastReport jako część jakiegoś projektu. W tym przypadku dodaj FastReportBGObjects.dll do listy referencyjnej projektu i dodaj następujący kod do kodu projektu
RegisteredObjects.Add(typeof(SunburstObject), "ReportPage", 125);
Ten kod powinien być wykonany tylko raz.
Ostrzeżenie. Biblioteki FastReportBGObjects.dll i FastReportBG.dll powinny być umieszczone dodatkowo obok aplikacji, która je wykorzystuje. Jeżeli korzystasz z FastReport Designer, skopiuj te biblioteki do głównego katalogu aplikacji, a jeżeli w projekcie wykorzystujesz FastReport Buriness Graphics, umieść je w tym samym katalogu co plik wykonywalny.
Tak więc, po wykonaniu tych wszystkich etapów będziesz mógł korzystać z zaawansowanej grafiki FastReport Business Graphics wewnątrz raportów generowanych przy pomocy FastReport .NET. Jeśli masz jakiekolwiek pytania, jak zbudować wtyczkę FastReportBGObjects lub jak ją podłączyć do FastReport .NET, skontaktuj się z naszym zespołem wsparcia technicznego