Właściwości listy — karta Ustawienia listy

☛ AdminSPA > INTERFEJS UŻYTKOWNIKA > Listy >Edytuj > Ustawienia listy

Na tej karcie można ustawić następujące właściwości listy:

• Wysokość: określa wysokość listy w oknie przeglądarki; wartość domyślna to 100%; wartość można określić w procentach lub w pikselach, jednostkę wybiera się z listy rozwijanej po prawej stronie.
• Stronicowanie: przełącznik, którym można określić, czy lista ma być dzielona na strony; domyślnie włączony; jeśli lista ma być stronicowana dodatkowo należy określić liczbę wierszy wyświetlanych na stronie.
• Ilość pozycji na stronie: liczba wierszy, które będą wyświetlane na jednej stronie listy po włączeniu stronicowania; wartość domyślna 50.
• Funkcja server-side: po włączeniu powoduje, że operacje filtrowania są wykonywane po stronie serwera, a wynikowe rekordy są przesyłane do przeglądarki; domyślnie wyłączona, włączenie może być konieczne w przypadku list liczących więcej niż kilkaset rekordów.
• Zablokuj kolumnę akcji: po włączeniu blokuje przewijania w poziomie kolumny akcji w oknie, dzięki czemu jest ona zawsze widoczna w oknie listy.
• Wirtualizacja kolumnowa: po włączeniu renderuje na ekranie tylko te kolumny, które mieszczą się w oknie listy w celu zwiększenia wydajności wyświetlania podczas pracy z ograniczonym zestawem kolumn na liście.
• Wyświetlaj rekordy jako strukturę hierarchiczną: po włączeniu i wskazaniu kolumny hierarchii pozwala wyświetlić listę jako hierarchię rozwijaną (strukturę drzewiastą), to jest taką, w której rekordy nadrzędne grupują rekordy podrzędne, przy czym to grupowanie może być wielopoziomowe. Domyślnie wszystkie poziomy hierarchii są zwinięte, wyświetlenie rekordów podrzędnych wymaga kliknięcia symbolu > z lewej strony rekordu nadrzędnego.
• Kolumna hierarchii: nazwa kolumny zawierającej identyfikator rekordu nadrzędnego; wartości w tej kolumnie muszą być wartościami z kolumny klucza głównego wskazanej w definicji listy.
• Rodzaj selekcji: określa sposób zaznaczania rekordów na liście, dostępne wartości:
  • Brak selekcji: nie można zaznaczać rekordów na liście.
  • Pojedyncza selekcja: można zaznaczyć jeden rekord na liście (klikając go lewym przyciskiem myszy).
  • Wybór wielokrotny: można zaznaczyć wiele rekordów na liście (klikając je lewym przyciskiem myszy z wciśniętym klawiszem Ctrl).
  • Pojedyncza selekcja — z użyciem pola checkbox: można zaznaczyć jeden rekord na liście (klikając go lewym przyciskiem myszy lub zaznaczając pole wyboru); wymaga dodania do listy kolumny z polami wyboru przy użyciu polecenia Dodaj kolumnę checkbox z menu kontekstowego pozycji Kolumny listy na panelu elementów z lewej strony.
  • Wybór wielokrotny — z użyciem pola checkbox: można zaznaczyć wiele rekordów na liście (klikając je lewym przyciskiem myszy z wciśniętym klawiszem Ctrl lub zaznaczając pole wyboru); wymaga dodania do listy kolumny z polami wyboru przy użyciu polecenia Dodaj kolumnę checkbox z menu kontekstowego pozycji Kolumny listy na panelu elementów z lewej strony.
• Selekcja tylko przez pole checkbox: po włączeniu blokuje możliwość zaznaczania rekordów na liście przez klikanie myszą; ta opcja jest niedostępna w przypadku włączenia opcji Wyświetlaj rekordy jako strukturę hierarchiczną.
• Wywołaj akcje po interakcji z rekordem listy: Po włączeniu wyświetla komponent do wyboru akcji oraz powoduje wykonanie wybranych akcji, gdy użytkownik kliknie aktywną komórkę wiersza (lub naciśnie klawisz Enter). Funkcjonalność nie wspiera komórek kolumny akcji oraz kolumny selekcji rekordów. Włączenie tej funkcji wymusza wyłączenie edycji inline oraz wymusza możliwość selekcji rekordów tylko z użyciem kolumny checkbox. Głównym przeznaczeniem tej funkcjonalności jest otwieranie formularza z danymi bieżącego rekordu w trybie panelu bocznego.

Nieprawidłowo skonstruowany warunek filtrowania listy hierarchicznej po wartościach kolumny hierarchii może powodować, że na liście nie będą wyświetlane żadne rekordy. Na przykład dla warunku:

WHERE ParentId = {@Section_ParentId}

gdzie ParentId to kolumna hierarchii, a {@Section_ParentId} to referencja do pola sterującego zależnością,
nie zostanie zwrócony rekord nadrzędny hierarchii, który ma inną wartość w tej kolumnie. Prawidłowy warunek musi zwrócić rekord nadrzędny i rekordy podrzędne:

WHERE Id = {@Section_ParentId} OR ParentId = {@Section_ParentId}

gdzie Id to kolumna klucza głównego.

---