Generic (ogólny filtr) pozwala przygotować wspólną kontrolkę filtrowania i przekazywać jej wartość do innych filtrów. Jest przydatny, gdy użytkownik ma podawać tę samą informację na stronach prezentujących różne klasy danych.
Przykładowo filtr nazwany „Okres” może na jednej stronie sterować datą zlecenia, a na innej datą transakcji. Dla każdej klasy pozostaje osobny filtr właściwego pola, natomiast wspólny Generic przekazuje mu wybrany zakres.
1. Różnica względem filtra „pole” #
filtr pole ma wskazane konkretne pole i zasady wyszukiwania. Generic określa przede wszystkim sposób wprowadzania wartości oraz jej przekazanie przez parametr Kopiuj wartość do kryteriów. Samo nadanie nazwy i wybór kontrolki nie tworzą jeszcze warunku wyszukiwania po wybranym polu.
Podstawowe tworzenie filtrów opisuje artykuł Dodawanie i edycja filtrów.
2. Przygotowanie filtrów docelowych #
- Dla każdej potrzebnej klasy utwórz zwykły filtr właściwego pola.
- Wybierz odpowiedni Sposób szukania, na przykład wybór zakresu dat.
- Sprawdź jego działanie samodzielnie na zestawieniu.
- Zwróć uwagę na parametr Typ. Filtry docelowe muszą mieć taki sam typ kontrolki jak Generic, aby można je było wskazać na liście kopiowania.
3. Tworzenie filtra Generic #
- Otwórz konfigurację filtrów i dodaj nowy filtr.
- W polu Rodzaj wybierz Generic (ogólny filtr).
- Wpisz czytelną Nazwa, na przykład „Okres”.
- W polu Typ wybierz sposób wprowadzania wartości.
- W polu Kopiuj wartość do kryteriów wskaż przygotowane filtry docelowe.
- Uzupełnij Opis i Szerokość filtra, jeżeli są potrzebne.
- Zapisz filtr i dodaj go do konfiguracji właściwych stron.
4. Wybór kontrolki i wariantów #
W parametrze Typ występują między innymi: Linijka tekstu, pole liczbowe, Zakres liczb, Zakres dat, Zakres dat i godzin, Lista select jednokrotnego wyboru, Lista multiple wielokrotnego wyboru oraz Lista checkbox lub włącznik checkbox.
Generic nie udostępnia kontrolek Wyszukiwarka jednokrotnego wyboru z lupą i Wyszukiwarka wielokrotnego wyboru z lupą. Dla list wyboru można korzystać z parametru Słownik wariantów. Wartości wariantów muszą odpowiadać wartościom oczekiwanym przez filtry docelowe — zgodna nazwa na ekranie nie gwarantuje zgodności zapisanych wartości.
5. Przykład: wspólny filtr okresu dla dwóch klas #
- Dla zleceń utwórz filtr pola daty zlecenia ze sposobem wybór zakresu dat.
- Dla transakcji utwórz analogiczny filtr daty transakcji.
- Utwórz Generic o nazwie „Okres” i typie Zakres dat.
- W Kopiuj wartość do kryteriów wskaż oba filtry.
- Dodaj Generic do zestawienia zleceń oraz do zestawienia transakcji.
- Na każdej stronie wybierz ten sam zakres i sprawdź wyniki.
Podczas budowania wyników program wykorzystuje filtry docelowe zgodne z klasą danego zestawienia. W ten sposób jedna definicja kontrolki może przekazywać zakres do różnych pól dat.
6. Gdy filtr nie zmienia wyników #
Sprawdź, czy wybrano filtry w Kopiuj wartość do kryteriów, czy ich klasa odpowiada klasie zestawienia i czy ich Typ jest zgodny z Generic. Następnie sprawdź działanie każdego filtra docelowego osobno. Brak filtra na liście kopiowania może wynikać właśnie z innego typu kontrolki.
Nie traktuj filtra użytkownika jako zastępstwa ograniczeń dostępu. Stałe ograniczanie danych opisują Blokady filtrów i Zarządzanie uprawnieniami.
