Przejdź do treści

Filtry na listach

Panel filtrów obok listy pozwala jednym kliknięciem zawęzić listę, np. do faktur czekających na akceptację albo dokumentów z wybranym statusem. Filtry panelu przygotowuje administrator i są one dostępne dla każdego, kto korzysta z listy. Z tego artykułu dowiesz się, jak je tworzyć.

Zanim zaczniesz

  • Filtry ustawiasz w edycji listy, na zakładce Filtry (patrz Tworzenie list).
  • Moduł musi pokazywać panel filtrowania. Opcja Ukryj panel filtrowania w module nie może być zaznaczona (patrz Moduły i menu aplikacji).

Dodanie kategorii filtrów

Każda kategoria filtrów to jedna sekcja w panelu, np. Status albo Termin.

  1. Na zakładce Filtry kliknij Dodaj nową kategorię filtrów.
  2. Wpisz Nazwę, która pokaże się jako nagłówek sekcji w panelu.
  3. Wybierz Typ filtra (patrz niżej).
  4. Wybierz Kolumnę listy, której dotyczy filtr, i Operator.
  5. Zaznacz Multi wybór, jeśli użytkownik ma móc wybrać kilka wartości naraz.
  6. Ustaw sposób sortowania wartości i kliknij Zapisz.

Kolejność kategorii w panelu zmienisz przyciskami Przesuń do góry i Przesuń w dół.

Rodzaje filtrów

Typ Kiedy użyć
Filtr na podstawie danych z kolumny Najprostszy. Navigator zbiera różne wartości wybranej kolumny i pokazuje je jako pozycje filtra. Kolumna nie musi być widoczna na liście.
Filtr na podstawie zestawu danych pola formularza Pozycje filtra pochodzą z zestawu danych pola formularza, np. ze słownika rodzajów umów.
Kreator filtrów Każdą pozycję filtra definiujesz osobno, jako warunek na kolumnach listy, np. „ubezpieczenie wygasa w tym miesiącu”.
Polecenie SQL Pozycje filtra zwraca zapytanie SQL. Najwięcej możliwości, ale wymaga znajomości bazy Navigatora.

Kreator filtrów

Pozycję filtra opisujesz nazwą i warunkami, tak jak prosty warunek na formularzu (patrz Warunki na formularzu). Warunki łączysz spójnikami oraz i lub. Każdy warunek dotyczy jednej kolumny.

Dla dat możesz użyć bieżącego dnia, tygodnia, miesiąca, kwartału albo roku z przesunięciem, np. Bieżący dzień +1 to jutro. Przykład: lista pojazdów z pozycjami filtra Przegląd w tym miesiącu i Przegląd w przyszłym miesiącu.

Polecenie SQL

Zapytanie zwraca dwie kolumny:

  • ID: wartość, której Navigator szuka w kolumnie filtra,
  • Value: tekst pozycji w panelu.

Przykład: filtr statusów dokumentu, z ikonami statusów:

SELECT DoPa.Name AS ID, [dbo].fn_Get_Ic_ById(Ic.Icon, DoPa.Name) + ' ' + DoPa.Name AS Value
FROM DoPa
JOIN DoPa DoPaP ON DoPa.Parent = DoPaP.ID
LEFT JOIN Ic ON DoPa.IcID = Ic.ID
WHERE DoPaP.GUID = '2D1CE941-7D04-403F-AD9B-A70E31E61D2A'
AND DoPa.Deleted = 0
ORDER BY DoPa.[Order]

Tabela DoPa przechowuje typy dokumentów i ich statusy, a status wiąże się z typem przez kolumnę Parent. Zapytanie zawęża statusy do jednego typu po jego GUID, który znajdziesz w edycji typu dokumentu. Kolumna filtra zawiera nazwę statusu, dlatego ID to DoPa.Name. Zawsze sprawdź, jakie dane ma kolumna filtra, i dopasuj do nich ID.

Co dalej