Symfonia Produkcja. Kreator raportów. Wersja 2013

Transkrypt

1 Symfonia Produkcja Kreator raportów Wersja 2013

2 Windows jest znakiem towarowym firmy Microsoft Corporation. Adobe, Acrobat, Acrobat Reader, Acrobat Distiller są zastrzeżonymi znakami towarowymi firmy Adobe Systems Inc. Btrieve jest zastrzeżonym znakiem towarowym firmy Btrieve Technologies, Inc. System Symfonia jest zastrzeżonym znakiem towarowym firmy Sage sp. z o.o. Opracowanie i skład: Sage sp. z o.o. Warszawa lipiec 2012 Symbol dokumentu MXPRKRV2012P0001 Copyright Sage sp. z o.o. Wszelkie prawa zastrzeżone. All Rights Reserved.

3 Spis treści Wstęp 1 Modyfikacja istniejącego raportu... 1 Dodawanie nowego raportu... 1 Składniki definicji SQL 2 Zapytanie SQL... 2 Warunki typu data... 3 Warunki typu tekst... 3 Warunki typu lista rozwijalna/combo... 4 Warunki typu lista... 4 Edytor szablonu 6

4 Wstęp Kreator raportów umożliwia modyfikację istniejących oraz tworzenie nowych raportów. Kreator dostępny jest wyłącznie dla Administratora. Definicja każdego raportu składa się z 2 części: zapytania SQL wraz z parametrami (np. zakres daty) szablonu wydruku (layout'u) Do edycji/tworzenia każdej z tych części używa się osobnych funkcji systemu. Zapytania SQL tworzymy zgodnie ze standardem dla Microsoft SQL Server, język ten jest opisany w dokumentacji MS SQL Server (Books Online). Do wprowadzania/modyfikacji zapytania przeznaczone jest okno edycji dostępne poprzez menu na liście raportów. Modyfikacja istniejącego raportu 1. Edycja zapytania SQL: menu edytuj definicję SQL 2. Edycja szablonu: Podgląd Raportu > Edycja Dodawanie nowego raportu 1. Nowa definicja SQL - według opisu poniżej 2. Nowy szablon: Podgląd raportu -> system pyta o utworzenie nowego szablonu. UWAGA! Program każdorazowo zapyta o utworzenie nowego szablonu w sytuacji, gdy w zdefiniowanym w połączeniach katalogu raportów nie znajdzie pliku odpowiadającego definicji raportu!

5 2 Składniki definicji SQL Zapytanie SQL Podstawowy element każdego raportu, zwracający dane z bazy systemu do szablonu. W ogólności możemy konstruować dowolne zapytania w oparciu o składnię SQL. Najprostszy przykład (bez kryteriów) wygląda następująco: SELECT * FROM MFORDERMSTR Przykład ten spowoduje wynikowo zwrócenie wszystkich nagłówków zleceń do szablonu raportu. Oprócz zapytania SQL, należy zdefiniować przy nowym raporcie następujące pola: ID raportu - unikatowy identyfikator raportu (np MF_ORDERS) Nazwa ekranowa - nazwa raportu na liście Nazwa fizyczna - nazwa pliku z szablonem raportu (BEZ ROZSZERZENIA) Kolejność - kolejność na liście ID grupy raportów - grupa, do której należeć będzie raport. Warunki (kryteria wywołania raportu). Każdy raport możemy wywołać ze zdefiniowanym zakresem - np data od, data do, typ zlecenia, etc. Zdefiniowane parametry użytkownik musi wpisać w oknie wywołania raportu. Raport bez zdefiniowanych warunków pobierze wszystkie dane, które zwróci zapytanie SQL.

6 3 Warunki typu data Przy zdefiniowaniu warunku typu data, w oknie wywołania raportu system wygeneruje pole wyboru daty. Wymagane pola w definicji to: ID pola Opis, Typ (pole daty) Kolejność na liście kryteriów Wartości domyślne są dopuszczalne na zasadzie podania zapytania SQL, np bieżąca data to SQL=select getdate(). W internecie znaleźć można szereg przykładów zapytań zwracających różne daty, np początek miesiąca, początek poprzedniego miesiąca, etc. Podanie do zapytania SQL takiego warunku wygląda następująco: SELECT... WHERE... = convert(datetime, #ID POLA# ) lub SELECT... WHERE... AND... = convert(datetime, #ID POLA# ) Dla przykładu: WHERE ItemType=2 AND MFOrderStatus=30 AND MFORDERMSTR.CreateDate > convert(datetime, #DateStart# ) - 1 AND MFORDERMSTR.CreateDate < convert(datetime, #DateEnd# ) + 1 Warunki typu tekst

7 4 Proste warunki, gdzie w pole tekstowe wpisać możemy dowolną wartość. Użyteczne w przypadku, gdy chcemy wyszukiwać według podanego ciągu. Przykład: WHERE tablename.nazwa like #%ID POLA%# Warunki typu lista rozwijalna/combo Warunek typu lista rozwijalna (combo) wymaga zdefiniowania w dane. zapytania SQL zasilającego listę Definicja warunku wymaga dodatkowo podania nazwy pola kluczowego oraz pola z wartością wyświetlaną użytkownikowi. Przykład: chcemy wyświetlić ograniczenie do wybranego typu zlecenia. Zapytanie SQL do listy wyglądać będzie następująco: select MFOrderTypeID,Description from MFOrderTypes Pola kluczowe: MFOrderTypeID Pola wyświetlane: Description W ten sposób na liście warunków wyświetli się następujące pole wyboru Przy czym zdefiniowana wartość domyślna (wartość pola kluczowego) spowoduje automatyczne wybranie właściwej wartości na liście. Warunki typu lista Warunek typu lista wymaga zdefiniowania zapytania SQL zasilającego listę w dane. Wynik wyświetlany jest w postaci tabelki, w której użytkownik zaznacza potrzebne wartości

8 5 Zapytanie do takiej listy wygląda podobnie jak w typie combo: select ReceiptCode, ReceiptName from MFReceiptMSTR Pola kluczowe: ReceiptCode Pola wyświetlane: ReceiptName Przekazanie warunku do zapytania SQL odbywa się wtedy następująco: WHERE ReceiptCode IN #CardID# UWAGA! W momencie wpisania w zapytanie SQL zdefiniowanych warunków funkcja Testuj przestanie działać - jest to podyktowane tym, że konkretne wartości do warunków przekazywane są dopiero przy uruchomieniu raportu z listy raportów po podaniu ich przez użytkownika.

9 6 Edytor szablonu Edytor szablonu dostępny jest z poziomu Okna Podglądu - zarówno dla nowych jak i istniejących raportów. Zasada tworzenia i modyfikacji szablonu raportu nie odbiega znacząco od podobnych narzędzi, np MS Access czy Crystal Reports. Wykorzystuje on dane przygotowane przez wcześniej zdefiniowane zapytanie SQL, a zawartość raportu umieszczona jest w sekcjach. UWAGA! Po powrocie do podglądu raportu konieczne może być ponowne wywołanie raportu, Pola danych przekazane do raportu widoczne są w okienku "Field List"

10 7 Listę rekordów wyświetlamy w sekcji szczegółów - w nowym raporcie należy poprzez kliknięcie na Tag w lewym, górnym rogu raportu wyświetlić następujące okno: I wybrać w polu Data Member tabelę, która będzie używana przez raport - w tym przypadku jest to tblreportdata. Szczegółowy opis funkcji edytora szablonu znajduje się w pliku pomocy DXHelp.chm (rozdział Report Designer). Plik ten znajduje się w folderze Dokumentacja Dokumentacja wyłącznie w języku angielskim. Niniejszy opis nie dotyczy Edytora Wydruków - funkcjonalność udostępniona dotyczy wyłącznie edycji szablonów, dane zwracane do wydruków dokumentów pochodzą z obiektów biznesowych systemu i są niemodyfikowalne (zaawansowani użytkownicy mogą dodatkowo wykorzystać mechanizmy skryptów)