Rave Reports - Raporty Master-Detail

Witam wszystkich ;) Jest to mój pierwszy artykuł tutaj więc proszę o wyrozumiałość ;).

Na naszej stronce możemy znaleźć już 3 artykuły na temat Rave'a, ale żaden z nich nie mówi jak dokonać raportu Master/Detail, więc postanowiłem wziąć sprawy w swoje ręce i ku przyszłym pokoleniom opisać proces tworzenia takiego raportu.

Ok, do lewej ręki kubek z kawą, do prawej mysz i zaczynamy.

Na początku uruchamiamy Rave'a i tworzymy nowy project: File->New.
Z prawej strony naszego środowiska jest "project manager", przypominający nam troszkę tego z produktów Borland'a. Klikamy na Report Library -> Report1 -> Page1.

Z lewej strony Rave'a, mamy coś a'la Object Inspectora. Odnajdujemy pozycję PaperSize i zmieniamy na A4. Zmieniamy także właściwość FullName na Strona1.

Następnym krokiem jaki poczynimy, będzie stworzenie połączenia z bazą danych. Poniższy przykład opiszę na podstawie MS SQL Server 2008.

Zaraz pod głównym menu, znajduje się szereg przycisków (tzw Toolbar). Klikamy przycisk z fioletowym sześcianem i napisem "view":

Pojawi nam się okienko Data Connections:

Wybieramy w nim "Database Connection" klikamy "Next". W następnym kroku "Database Connetcion Type" wybieramy "ADO" i klikamy na Finish.

Pojawi nam się okienko "Database Connection Parameters". Klikamy w przycisk [...].

Otworzy się okno z właściwościami połączenia. Wybieramy w nim "Microsoft OLE DB Provider for SQL Server" i klikamy dalej.

Pokaże się zakładka połączenie. Tam wybieramy nazwę naszego serwera, sposób autoryzacji oraz bazę danych na podstawie której stworzymy raport.

Klikamy OK, dopóki nie znikną wszystkie okienka które pootwieraliśmy. Łyk kawy.

Przygryzamy kostką czekolady i ponownie klikamy na fioletowy sześcian z napisem "view" na toolbarze pod menu.
Tym razem w okienku poniżej, wybieramy "Driver Data view":

Klikamy next i finish. Pojawi się nam coś takiego:

Jest to "Query Advanced Designer". Przypomina nam on trochę Query Designera z SQL Server'a. Po prawej stronie znajduje się lista tabel i widoków. Nas będą interesowały widoki.

Kolejny łyk kawy ;)

Teraz stworzymy zapytanie dla tabeli master.

W moim przypadku tabelą "master" jest tabela Rodzaje_indeksów, a więc użyję widoku który sobie nazwałem "v_rodzaje_indeksow". A tabelą "Detail" będzie tabela "indeksy" i analogicznie widok v_indeksy. Odszukujemy więc po lewej stronie na liście widok który chcemy użyć jako master i klikamy na niego myszą i przeciągemy na żółte pole, tak aby wszystko wyglądało jak na załączonym obrazku:

UWAGA! Nie dodajemy teraz tabeli "Detail" (lub jak kto woli slave).
Klikamy Ok, okienko się zamyka. Z prawej strony okna programu w tzw Project Manager'ze odnajdujemy "DriverDataview1" i zmieniamy jego właściwość name na "TabelaMaster".

Ok, teraz czyniąc to samo co wyżej, tworzymy sobie tabele slave. Czyli znów klikamy fioletowy sześcian z napisem view na tolbarze pod menu. Wybieramy Driver Data view. Klikamy next i finish. Dodajemy teraz tabelę którą chcemy dodać jako detail (slave). W moim przypadku jest to tabela v_indeksy.

I tutaj znów chciałbym zwrócić uwagę, aby wszystko działało prawidłowo, to w tabelach musimy mieć utworzone Relationship (relacje). U mnie ta relacja w MS SQL Server wygląda w ten sposób:

Gdy już wybierzemy interesujący nas widok i przeciągniemy go na żółte pole, to nazywamy nowo dodany DriverDataview jako "TabelaSlave".

Ok, popijamy kawkę i z menu Tools wybieramy: Report Wizards -> Master/Detail Report.

Pojawi się następujące okienko:

Program pyta nas, który driverdataview chcielibyśmy używać jako Master. Wybieramy TabelaMaster i klikamy next. Następne pytanie, to pytanie o DetailDataview, wybieramy naszą "TabelaSlave" i ponownie klikamy next.

Kolejnym krokiem będzie wybór pól z naszej tabeli master:

Klikając dalej, wybieramy sobie kolejność pól, które zaznaczyliśmy na poprzedniej formatce.
Klikamy next i wybieramy pola, które chcemy wyświetlić z naszej tabeli slave - w moim przypadku będą to pola indeks, nazwa indeksu, rozmiar i kolor. Klikamy dalej w celu ustalenia kolejności pól.
Po ustaleniu kolejności pól musimy przypisać tzw "relacje", czyli które id z tabeli podrzędnej jest przypisane do tabeli nadrzędnej. W moim wypadku wygląda to tak:

(czerwoną linię dorysowałem w Photoshop'ie w celu zobrazowania relacji ;) ).

Klikamy next i w okienku Report Layout Options ustawiamy opcję naszego raportu:

Report title wpisujemy nazwę raportu, w margins ustawiłem wartości z 1.0 na 0.2, gdyż 1.0 to zdecydowanie za dużo.

Next ;)

W następnym okienku możemy ustawić sobie fonty naszego raportu. Tym razem zostawiam domyślne.

Popijamy kawy. Klikamy Generate. I powinien się wygenerować projekt raportu.

Projekt powinien wyglądać tak:

Jak widzimy jest on podzielony na kilka sekcji. Szare pole które widzimy to tzw "Region", na którym umieszczamy elementy raportu zwane "Band-ami". Pierwszy Band od góry to title Band. Tam możemy umieszczać dodatkowe elementy raportu jak pola tekstowe, pola tekstowe z parametrami, obrazy, kody kreskowe, kształty itp. Nie będę tutaj opisywał jak to się robi i jak się ustawia parametry poszczególnych komponentów, ponieważ są już tutaj artykuły na ten temat.

Klikamy lewym przyciskiem myszy na "TabelaMasterRegion: TabelaMasterTitleBand" i w Object Inspectorze Otwieramy właściwości "Band Style".
Pojawi się nam okienko podobne do tego:

Kreskami oznaczyłem jaka właściwość odpowiada jakiemu band'owi. Uwaga! Aby w tym okienku pojawia się lista wszystkich band'ów, ale edytujemy właściwości tylko zaznaczonego w oknie projektu!
Cyferkami oznaczyłem osobną właściwość bandu którą poniżej wyjaśnię:
1 - Band tytułu - możemy na nim umieszczać dowolne komponenty.
2 - Tabela Master Band - jest to band na którym znajdują się tytuły kolumn naszej tabeli master. Tytułom tym można przypisać swoje nazwy, czcionkę i inne parametry. Można je także usunąć. Do tego Bandu można również dodawać różne komponenty. Myślę że metoda prób i błędów we wszystkich bandach będzie najodpowiedniejszą ;).
3 - Tabela Master DataBand Master - jest to band w którym będą znajdywać się poszczególne rekordy z tabeli master.
4 - Tabela Slave Band - jest to band w którym znajdują się tytuły pól tabeli slave. Jest on bardzo podobny w działaniu jak band nr 2.
5 - TabelaSlaveDataBand - jest to band w którym wyświetlać się będą rekordy tabeli slave.

Sekcja Prin Location określa ile razy i gdzie ma być drukowany poszczególny Band.
6 - Body Header - będzie drukowany u góry strony (w nagłówku).
7 - Group Header - będzie drukowany na początku każdej grupy.
8 - Row Header - będzie drukowany na początku każdego rekordu.

Ja TabelaMaster badn ustawiłem na Row Header, tak aby tytuły pól były drukowane przy każdym rekordzie z tabeli id. Ale mówię, najodpowiedniejszą metodą jest tutaj metoda prób i błędów.

Sekcja Print Occurrence. W niej określamy na jakich stronach ma się dodatkowo pojawić dany Band. Tutaj proponuję zostawić domyślne ustawienia, bądź też pobawić się różnymi kombinacjami.
9 - Pierwsza strona.
10 - Każda następna strona.

Spróbujcie przerobić wasz projekt tak, aby wyglądał jak mój:

Po dokonanych modyfikacjach, zapisujemy nasz raport: File -> Save.
Teraz nadeszła "wiekopomna chwiła" :D. Tworzymy podgląd naszego raportu:
File -> Execute Raport -> Preview -> Ok. Powinniśmy zobaczyć coś takiego (lub podobnego ;p):

Możecie teraz już wykorzystać w Delphi pliki *.rav waszego raportu. Oczywiście nie zapomnijcie w sekcji uses dodać: RvDLADO.

Dziękuję wszystkim za uwagę. Mnie się już kawa skończyła, nie wiem jak wam ;)

Pozdrawiam
-Mariusz Jernalczyk