Widok listy
Podsumowanie:Widok listy to, oprócz formularza, podstawowy sposób prezentacji danych w aplikacjach biznesowych budowanych na platformie nAxiom. Widok listy może być wyświetlany poleceniem menu, może być także osadzony jako sekcja na formularzu.
W tym temacie
Elementy widoku listy
Poniższa ilustracja przedstawia przykładowy widok listy w aplikacji FrontSPA.

Na górze listy znajduje się panel górny, który zawiera następujące elementy:
- przyciski akcji; przycisk
Nowy dokument
jest standardowo dodawany na listach tworzonych w procesie automatycznego generowania elementów aplikacji; konsultant może konfigurować przyciski wyświetlane na panelu górnym. - lista rozwijana z predefiniowanymi filtrami: służy do wyboru zdefiniowanych filtrów, które ograniczają dane wyświetlane na liście; oprócz filtrów zawiera pozycję:
-
Ustawienia
: otwiera listę filtrów, na której można zarządzać filtrami, pod warunkiem posiadania uprawnienia PBATworzenie i edycja filtrów SQL
.
Filtrowanie zaawansowane -
-
Zapisz konfigurację listy
: wyświetla okno dialogowe w celu podania nazwy, pod jaką zostanie zapisana bieżąca konfiguracja listy; konfiguracja obejmuje ustawienia szerokości kolumn, filtrowania, sortowania i grupowania; umożliwia zapisanie konfiguracji jako nowej lub nadpisanie bieżącej konfiguracji.Konfiguracja listy - przycisk
Zapisane ustawienia wyświetlania...
: wyświetla okno dialogowe, w którym można zarządzać zapisanymi konfiguracjami listy.Konfiguracja listy - przycisk
Zresetuj konfigurację listy
: przywraca ustawienia wyświetlania listy zgodne z aktualnie wybraną konfiguracją. - przycisk
Eksportuj listę do pliku MS Excel
: powoduje zapisanie w folderze pobierania przeglądarki pliku w formacie xlsx z rekordami wyświetlanymi na liście. - przycisk
Odśwież
: ponownie ładuje zestaw rekordów listy z bazy danych.
Poniżej panelu górnego może być wyświetlany obszar z tekstem Przeciągnij nagłówek kolumny i upuść go tutaj, aby pogrupować według tej kolumny
. Jest on wyświetlany wtedy, gdy dla niektórych kolumn włączono opcję grupowania według wartości tej kolumny. Aby pogrupować wiersze na liście według wartości wybranej kolumny, należy przeciągnąć nagłówek tej kolumny do tego obszaru. Możliwe jest grupowanie wierszy według wartości wielu kolumn. Należy wówczas przeciągnąć do tego obszaru nagłówki wszystkich tych kolumn (wynik grupowania zależy od kolejności, w jakiej kolumny będą przeciągane do tego obszaru).
Następny obszar widoku listy to nagłówki kolumn, w których są wyświetlane nazwy kolumn. Domyślnie nazwy kolumn widoku listy są takie same jak nazwy kolumn zwracane zapytaniem, które jest źródłem danych dla tej listy, jednak można to zmienić w trybie projektowania listy. Jeśli dla listy włączono obsługę sortowania i/lub filtrowania, kliknięcie nagłówka kolumny powoduje wyświetlenie panelu sortowania/filtrowania.

Ustawienia filtrowania zależą od typu danych i konfiguracji filtrowania określonej przez konsultanta w definicji widoku listy. Po określeniu kryteriów filtrowania należy kliknąć przycisk Zapisz
u dołu panelu, aby zastosować filtr. Przycisk Wyczyść
służy do usunięcia filtru.
Pod nagłówkami kolumn znajduje się tzw. grid, czyli sama lista z danymi. Oprócz danych lista może także zawierać tzw. kolumnę akcji, to jest kolumnę zawierającą przyciski akcji, w tym na przykład przycisk edycji, który wyświetla bieżący rekord danych w formularzu. Kolumna akcji można także zawierać przycisk usuwania rekordu oraz przyciski do edycji danych inline, to jest bezpośrednio w widoku listy.
Na samym dole znajduje się stopka listy. W stopce znajdują się przyciski przechodzenia do: pierwszej strony listy, poprzedniej strony listy, następnej strony listy i ostatniej strony listy, dodatkowo wyświetlany jest numer bieżącej strony. Z prawej strony wyświetlane są numery rekordów na bieżącej stronie listy. Ponadto w stopce mogą być wyświetlane wartości funkcji agregujących.
Filtry zaawansowane
Po wyraniu z listy predefiniowanych filtrów pozycji Ustawienia
i kliknięciu w wyświetlonym oknie przycisku dodaj nowy filtr
zostaje wyświetlone okno dialogowe Filtr zaawansowany
, w którym można skonfigurować nowy filtr.

Po wpisaniu nazwy i opisu należy kliknąć przycisk Dodaj filtr
i skonstruować warunek filtrowania. Konstrukcja polega na wybraniu nazwy kolumny, operatora i wpisaniu wartości.

Dostępne operatory zależą od typu danych wybranej kolumny. Dla danych tekstowych dostępny jest operator Jest taki jak
. Pozwala on filtrować wartości tekstowe, które zawierają podany ciąg znaków. w takim przypadku jako symbolu zastępczego pozostałej części tekstu należy użyć symbolu %.

Filtry zaawansowane mogą się składać z kilku warunków połączonych operatorem logicznym LUB albo ORAZ, a także tworzyć grupy warunków również połączonych jednym z dostępnych operatorów.
