System raportw - typy parametrw
Poniej przedstawiona zostaa lista parametrw moliwych do wykorzystania przy tworzeniu raportw.
Skadnia:
Wymagane skadniki: PARAM=nazwa_parametru - okrela nazw parametru uytego w zapytaniu SQL TYPE=typ_parametru - okrela typ uytego parametru Skadnik VALUE VALUE="warto" - okrela warto domyl parametru, lub w przypadku parametru typu select definiuje moliwe wartoci Skadnik LABEL LABEL="etykieta" - okrela etykiet wywietlan obok pola z miejscem na wpisanie (wybranie) wartoci
- TYP text
Ten typ parametru suy do wprowadzania wyszukiwanych fraz do zapytania SQL, np. fragment nazwiska klienta, nazwa miasta czy regionu Przykady uycia:
[PARAM=search TYPE=text] [PARAM=search TYPE=text VALUE="kowalski"] [PARAM=search TYPE=text LABEL="Sowo szukane"] [PARAM=search TYPE=text VALUE="kowalski" LABEL="Sowo szukane"]
- TYP date
Ten rodzaj parametru suy do wprowadzania daty do zapytania SQL. Dat bdzie mona wprowadzi za pomoc zbudowanego kalendarzyka. Przykady uycia:
[PARAM=date1 TYPE=date] [PARAM=date1 TYPE=date VALUE="2010-01-01"] [PARAM=date1 TYPE=date LABEL="Data od"] [PARAM=date1 TYPE=date VALUE="2010-01-01" LABEL="Data od"] [PARAM=date1 TYPE=date VALUE=":DZISIAJ" LABEL="Data od"]
- TYP select
Ten typ parametru umoliwia wstawienie do zapytania wartoci wybieranej z (zdefiniowanej wczeniej w parametrze VALUE) listy. Definicja listy: "warto1=etykieta1,warto2=etykieta2,warto3=etykieta3" Przykady uycia:
[PARAM=state TYPE=select VALUE="A=Anulowana,W=Wstpna,D=Do potwierdzenia,P=Pena"] [PARAM=state TYPE=select VALUE="A=Anulowana,W=Wstpna,D=Do potwierdzenia,P=Pena" LABEL="Stan rezerwacji"]
- TYP selectSQL_l
Ten typ parametru umoliwia wyciganie z lokalnej bazy danych organizatora danych ktre posu do wygenerowania raportu. Zapytanie powinno wyciga z bazy danych pary warto np.: id i nazw miasta, a nastpnie system tworzy na ich podstawie rozwijan list, gdzie pierwsza zwracana kolumna bdzie, przekazywan do raportu, wartoci a druga jej etykiet. Przykady uycia
[PARAM=skladnik TYPE=selectSQL_l VALUE="SELECT id,nazwa FROM tabela WHERE typ='1' ORDER BY nazwa"] [PARAM=skladnik TYPE=selectSQL_l VALUE="SELECT id,nazwa FROM tabela WHERE typ='1' ORDER BY nazwa" LABEL="Wybierz skadnik"]
- TYPY selectSQL_system i selectSQL_s_www
Ten rodzaj parametru umoliwia skonstruowanie rozwijanej listy w oparciu o wynik innego zapytania SQL. Zapytanie powinno wyciga z bazy danych pary warto np.: id i nazw miasta, a nastpnie system tworzy na ich podstawie rozwijan list, gdzie pierwsza zwracana kolumna bdzie, przekazywan do raportu, wartoci a druga jej etykiet. Przykady uycia
[PARAM=user TYPE=selectSQL_system VALUE="SELECT id,nazwa FROM miasta ORDER BY nazwa"] [PARAM=user TYPE=selectSQL_system VALUE="SELECT id,nazwa FROM miasta ORDER BY nazwa" LABEL="Wybierz miasto"]
- Parametr warunkowy
Parametry warunkowe su do budowy bardziej zaawansowanych raportw, ktrych dziaanie zmienia si w zalenoci od podanych przez uytkownika parametrw. Odpowiednie uycie parametrw warunkowych pozwala na skonstruowanie jednego raportu czcego funkcjonalno kilku raportw. W przypadku pozostawienia przez uytkownika pustego pola opcjonalnego fragment zapytania SQL zawarty pomidzy nawiasami [ i ] zostanie z niego usunity, dziki temu moliwe jest jest zbudowanie zupenie innych klauzul WHERE w zalenoci od podanych przez uytkownika parametrw. Przykady
[tabela.kolumna = :parametr AND] [tabela.kolumna = :parametr AND tabela.rodzaj = 'agent']