Zmiany pomiędzy wersją 1 and wersją 2 dla NewBusinessAdmin/Reports/Filters

Data i czas:

09/11/15 16:01:26 (9 years temu)

Autor:

msawkiewicz (IP: 79.188.124.105)

Komentarz:

--

NewBusinessAdmin/Reports/Filters

@@ -22 +22 @@
 Warunki stosowania operatorów:
 || Operator || Kiedy stosować || Przykład parametru ||
-|| IN || dla listy gdyż możemy otrzymać kilka zaznaczonych elementów.[[BR]] Token zostanie zamieniony na identyfikatory z danej listy np.: 1,2,3,4 || '''Miejsce:''' Lista klientów [[BR]] '''Parametr:''' contid IN ({CONTID}) ||
+|| IN || dla listy, gdyż możemy otrzymać kilka zaznaczonych elementów. [[BR]] Token zostanie zamieniony na identyfikatory z danej listy np.: 1,2,3,4 || '''Miejsce:''' Lista klientów [[BR]] '''Parametr:''' contid IN ({CONTID}) ||
 || znak = || dla kartoteki przekazywana jest tylko jedna wartość do parametru || '''Miejsce:''' Kartoteka klienta [[BR]] '''Parametr:''' contid = {CONTID} ||
 
-W przypadku, jeśli w definicji raportu użyjemy np.: {CONTID} a raport zostanie wywołany z modułu (przekazane zostaną zaznaczone elementy) wtedy token zostanie zamieniony na pierwszy z zaznaczonych elementów. [[BR]]
+W przypadku, jeśli w definicji raportu użyjemy np.: {CONTID} a raport zostanie wywołany z modułu (przekazane zostaną zaznaczone elementy), token zostanie zamieniony na pierwszy z zaznaczonych elementów. [[BR]]
 
 W przypadku niewłaściwego podpięcia raportu lub niewłaściwego użycia operatora raport wygeneruje błąd.
@@ -60 +60 @@
 || {RES_ID} || Zasób (z listy lub kartoteka) || 0 || TAK ||
 
-W momencie jeśli w danym raporcie zostanie użyty taki token to system wygeneruje odpowiednie pole na formularzu parametrów do raportu - jeśli jest obsługiwane. Poniższy zrzut ekranu przedstawia wszystkie tokeny możliwe do określania poprzez formularz.
-
-[[BR]][[Image(podstawowe_parametry.png)]][[BR]] (''Parametry'')[[BR]]
-
 == Definiowanie filtrów == #definiowanie_filtrow
 
-Od wersji 4.0 system eDokumenty umożliwia definiowanie własnych parametrów do raportów określanych jako Filtry.
-
-Na wstępie należy wyszukać interesujący nas raport lub dodać nowy [wiki:UserGuide/AdvancedConfiguration/DefiningReports Tworzenie raportów w SQL].
+System eDokumenty umożliwia definiowanie własnych parametrów do raportów określanych jako '''Filtry'''. [[BR]]
 
 Przykładowa definicja raportu (kod SQL):
@@ -88 +82 @@
 == Ważne uwagi == #wazne_uwagi
 
-Aby filtrowanie było możliwe wymagane jest dodanie specjalnego tokenu '''{FILTER_STRING}''', który w momencie akceptacji filtrów zostanie zamieniony na warunki SQL zgodne z definicją filtrów. Jeśli w definicji raportu zabraknie tego tokenu to pomimo definicji filtrów nie będą one dostępne na panelu parametrów.
-
-Istotną kwestią jest również miejsce w którym jest dodany token {FILTER_STRING} oraz operator jaki go poprzedza (AND/OR zalecany AND).
-Być może przykład będzie dość abstrakcyjny jednak proszę zwrócić uwagę na zapytanie zagnieżdżone:
+Aby filtrowanie było możliwe, wymagane jest dodanie specjalnego tokenu '''{FILTER_STRING}''', który w momencie akceptacji filtrów zostanie zamieniony na warunki SQL zgodne z definicją filtrów. Jeśli w definicji raportu zabraknie tego tokenu, to pomimo definicji filtrów nie będą one dostępne na panelu parametrów. [[BR]]
+
+Istotną kwestią jest również miejsce, w którym jest dodany token {FILTER_STRING} oraz operator, jaki go poprzedza (AND/OR - zalecany AND).
+
+__'''Przykład'''__
 
 {{{
@@ -108 +103 @@
     AND {FILTER_STRING}
 }}}
-Ważne jest aby przy takiej definicji raportu filtry wskazywały na kolumny umieszczone w głównym zapytaniu.
+
+Ważne jest, aby przy takiej definicji raportu filtry wskazywały na kolumny umieszczone w głównym zapytaniu.
 
 == Definicja nowego filtra == #definicja_nowego_filtra
 
-Po otwarciu dialoga raportu powinna nam się pojawić dodatkowa zakładka - "Filtry".
-
-[[BR]][[Image(panel_filtry.png)]][[BR]] (''Panel "Filtry"'')[[BR]]
-
-Przyciski na widocznym zrzucie umożliwiają standardowe zarządzanie filtrami:
+Filtrami możemy zarządzać w zakładce '''Filtry''' w kartotece raportu.
+
+[[BR]][[Image(wiki:NewBusinessAdmin/Attachments:raport_filtry.png, 500)]][[BR]]
+''Zakładka '''Filtry'''''[[BR]]
+
+Przyciski na widocznym rysunku umożliwiają standardowe zarządzanie filtrami:
 || Nazwa przycisku || Opis ||
 || Nowy || definicja nowego filtra/grupy ||
@@ -123 +120 @@
 || Odśwież listę || odświeża listę filtrów ||
 
-Klikając przycisk "Nowy" otrzymujemy formularz dzięki, której możemy zdefiniować nowy filtr lub grupę (zależne od wyboru pola Rodzaj - poniższy zrzut ekranu).
-
-[[BR]][[Image(filtr_raportu.png)]][[BR]] (''Definicja filtra'')[[BR]]
-
-Opis pól:
-|| Nazwa pola || Opis ||
-|| Nazwa || nazwa filtra lub grupy filtrów w zależności co zostanie wybrane w polu rodzaj ||
-|| Opis || dodatkowa informacja wyświetlania po najechaniu na nazwę filtra w panelu filtrów raportu (dostępny na wygenerowanym raporcie) ||
-|| Nadrzędny || w przypadku jeśli dany filtr lub grupa ma należeć do grupy należy wybrać z dostępnej listy ||
-|| Rodzaj || '''Grupa''' - grupuje kilka filtrów lub innych grup[[BR]] '''Filtr''' - konkretny filtr - filtry mogą być definiowane bez elementu nadrzędnego lub mogą należeć do grupy. Filtr nie może należeć do innego filtra ||
-|| Typ opcji || rodzaj wygenerowanego pola na panelu filtrów w wygenerowanym raporcie. Szczegóły poniżej ||
-|| Filtr || wyrażenie filtrujące. W zależności od typ opcji może wymagać podanie tokenu {value} - szczegóły poniżej ||
-|| Wartości dla listy || tylko dla typu:  Lista jednokrotnego wyboru, Lista wielokrotnego wyboru, Pola radiowe - kwerenda SQL, gdzie pierwsza wartość to klucz, który '''musi być typu INTEGER''' natomiast druga to opis wartości. Można stosować następujące tokeny: [[BR]] {LOGGED_USER} - identyfikator zalogowanego pracownika (users.usr_id) [[BR]] {LOGGED_ORUNID} - identyfikator jednostki zalogowanego pracownika (organization_units.orunid) [[BR]] {ENT_ID} - identyfikator podmiotu (podmioty.id_pod) [[BR]] {CURRENT_DATE} - bieżąca data w formacie YYYY-MM-DD [[BR]] {CURRENT_TIME} - bieżący czas w formacie HH:MM  ||
+Nowy filtr lub grupę filtrów definiujemy w formularzu '''Typ raportu'''.
+
+[[BR]][[Image(wiki:NewBusinessAdmin/Attachments:raport_filtry_nowy_filtr.png, 400)]][[BR]]
+
+Wypełniane pola:
+* '''Nazwa''' - nazwa filtra lub grupy filtrów, w zależności od wartości polu '''Rodzaj'''
+* '''Opis''' - dodatkowa informacja wyświetlania po najechaniu na nazwę filtra w panelu filtrów raportu (dostępny na wygenerowanym raporcie)
+* '''Nadrzędny''' - w przypadku, jeśli dany filtr lub grupa ma należeć do grupy, wybieramy ją z listy
+* '''Rodzaj'''. Wartość '''Grupa''' grupuje kilka filtrów lub innych grup, wartość '''Filtr''' oznacza konkretny filtr - filtry mogą być definiowane bez elementu nadrzędnego lub mogą należeć do grupy. Filtr nie może należeć do innego filtra.
+* '''Typ opcji''' - rodzaj wygenerowanego pola w panelu filtrów w wygenerowanym raporcie. Szczegóły poniżej.
+* '''Filtr''' - wyrażenie filtrujące. W zależności od typu opcji może wymagać podania tokena {value} - szczegóły poniżej.
+* '''Wartości dla listy''' - tylko dla typu:  '''Lista jednokrotnego wyboru''', '''Lista wielokrotnego wyboru''', '''Pola radiowe - kwerenda SQL''', gdzie pierwsza wartość to klucz, który '''musi być typu INTEGER''', natomiast druga to opis wartości. Można stosować następujące tokeny: '''{LOGGED_USER}''' - identyfikator zalogowanego pracownika (users.usr_id), '''{LOGGED_ORUNID}''' - identyfikator jednostki zalogowanego pracownika (organization_units.orunid), '''{ENT_ID}''' - identyfikator podmiotu (podmioty.id_pod), '''{CURRENT_DATE}''' - bieżąca data w formacie YYYY-MM-DD, '''{CURRENT_TIME}''' - bieżący czas w formacie HH:MM
 
 == Typ opcji == #typ_opcji
-Poniżej znajduje się aktualna lista typów opcji oraz przykład definicji:
+Aktualna lista typów opcji oraz przykład definicji:
 
 || Typ opcji || Opis || Przykład filtru || Wymaga tokenu {value} ||
@@ -158 +154 @@
 || Drzewko || Zwraca identyfikator wybranego elementu drzewka. Napełniane kwerendą podaną poniżej w przykładach || category = {value} || Tak ||
 
-
-W moim przypadku chcę filtrować listę klientów według parametru opiekun dlatego:
- - Typ opcji : Lista pracowników
- - Filtr: macrtk IN ({value}) - pole macrtk przechowuje id opiekuna (users.usr_id)
-
-Po zapisaniu filtr jest dostępny z poziomu listy filtrów danego raportu:
-
-[[BR]][[Image(nowy_filtr_na_liscie.png)]][[BR]] (''Nowy filtr na liście filtrów w raporcie'')[[BR]]
-
-Oraz dodatkowo po wygenerowaniu raportu klikając przycisk Określ parametry otrzymujemy formularz jak na zrzucie poniżej:
-
-[[BR]][[Image(filtr_na_raporcie.png)]][[BR]] (''Filtr na wygenerowanym raporcie'')[[BR]]
-
-Po zatwierdzeniu (przycisk Zapisz na formularzu Określ parametru raportu) raport zostanie ponownie wygenerowany uwzględniając nasz wybór.
+__'''Przykład'''__ [[BR]]
+Chcę filtrować listę klientów według parametru '''Opiekun'''. Wtedy:
+* wybieram '''Typ opcji''': '''Lista pracowników'''
+* definiuję '''Filtr''': '''macrtk IN ({value})''' - pole macrtk przechowuje id opiekuna (users.usr_id)
+
+Po zapisaniu filtr zostaje dodany do listy w zakładce '''Filtry''', a po [http://support.edokumenty.eu/trac/wiki/NewBusinessAdmin/Reports/PrintCharts wygenerowaniu raportu] wyświetla się w oknie po kliknięciu odnośnika '''Określ parametry'''.
 
 == Jeden filtr wiele raportów == #powiazania
-Nowa wersja 4.7.7 umożliwia publikację filtrów w wielu raportach. Dodatkowo został dodany słownik definicji filtrów dostępny z poziomu modułu Raporty -> Akcje -> Edycja definicji filtrów lub z poziomu zakładki Filtry w raporcie na pasku zadań.
-
-Przy dodawaniu filtru bezpośrednio z raportu system tworzy definicję filtru oraz publikuje go w danym raporcie w kontekście, którego aktualnie pracujemy. Zachowanie to możemy zmienić poprzez dodawanie już istniejącej definicji filtru do danego raportu. Można to zrobić poprzez opcję w menu Nowy na zakładce Filtry "Dodaj istniejący (powiązanie)". Z otwartego słownika wybieramy filtry lub grupę i klikamy Dodaj lub Dodaj i zamknij. Ważne jest, że jeśli publikujemy (dodajemy) element, który ma elementy podrzędne nastąpi automatyczne dodanie również tych elementów podrzędnych.
-
-Publikować (dodawać powiązania) można również poprzez metodę drag & drop danego elementu drzewka definicji filtrów na panel drzewka filtrów w raporcie.
-
+Raz zdefiniowane filtry mogą być publikowane (dodawane zostają powiązania) w wielu raportach. Słownik definicji filtrów dostępny jest z menu '''Akcje''' po wybraniu pozycji '''Edycja definicji filtrów''' lub z poziomu zakładki '''Filtry''' kartoteki raportu - po kliknięciu ikony '''Edytuj definicje filtrów raportów''' w '''Pasku narzędzi'''.
+
+Przy dodawaniu filtra bezpośrednio z kartoteki raportu system tworzy definicję filtra i publikuje go w edytowanym raporcie. Zachowanie to możemy zmienić poprzez dodawanie już istniejącej definicji filtra do raportu. Można to zrobić poprzez opcję w menu '''Nowy''' na zakładce Filtry '''Dodaj istniejący (powiązanie)'''. Z otwartego słownika wybieramy filtry lub grupę i klikamy '''Dodaj''' lub '''Dodaj i zamknij'''. Ważne jest, że jeśli publikujemy (dodajemy) element, który ma elementy podrzędne, nastąpi automatyczne dodanie również tych elementów podrzędnych. [[BR]]
+
+Publikować filtry można również poprzez metodę '''drag&drop''' danego elementu drzewka definicji filtrów w oknie '''Definicje filtrów''' na drzewko filtrów w kartotece raportu.
 
 == Dynamiczne grupowanie ==
-Aby na panelu filtrów widoczna była opcja dynamicznego grupowania (po kolumnach zdefiniowanych na panelu Wybór kolumn) w definicji SQL raportu należy dodać token {GROUP_BY}. Jest to jednak token sterujący dlatego należy go poprzedzić --. Pozycja tokena {GROUP_BY} nie ma znaczenia ważne aby był zakomentowany.
+Aby na panelu filtrów widoczna była opcja dynamicznego grupowania (po kolumnach zdefiniowanych na zakładce '''Kolumny''' w kartotece raportu), w definicji SQL raportu dodajemy token {GROUP_BY}. Jest to jednak token sterujący dlatego należy go poprzedzić --. Pozycja tokena {GROUP_BY} nie ma znaczenia ważne aby był zakomentowany.
 
 Przykład SQL