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

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

Pobieranie danych

• Tryb pracy listy: dostępne wartości:
  • Baza danych - klasyczny: Zapytanie wykonywane w całości przez bazę danych. Każda operacja (pobranie rekordów, policzenie rekordów, wyliczenie funkcji w stopce) generuje oddzielne zapytanie z kontrolą dostępu realizowaną przez JOIN do tabeli ACL i weryfikację ACLId. Filtrowanie i sortowanie po stronie bazy danych. Zapytanie opakowane funkcjami systemowymi. Jest to tryb domyślny.
  • Baza danych - CTE: Wariant trybu klasycznego. Jedyna różnica jest taka, że w tym trybie system opakowuje źródłowe zapytanie SQL listy w wyrażenie Common Table Expression (CTE), aby nie powielać go w kodzie. Zapytanie wykonywane w całości przez bazę danych.
  • Baza danych - hybrydowy: Wariant trybu klasycznego ze zmienionym sposobem kontroli dostępu ACL. Zapytanie wykonywane w całości przez bazę danych. Każda operacja generuje oddzielne zapytanie z kontrolą dostępu, ale realizowaną przez JOIN do danych JSON z tablicą kluczy głównych instancji dokumentów. W tym trybie załadowanie pierwszej strony rekordów oraz oraz przełączanie między stronami zajmuje mniej więcej tyle samo czasu.
  • Tylko przeglądarka WWW: Cały zestaw danych pobierany jednorazowo z bazy danych i przekazywany do przeglądarki. Kontrola ACL przez JOIN do tabeli ACL (jedno zapytanie). Filtrowanie i sortowanie realizowane po stronie przeglądarki. Zapytanie opakowane funkcjami systemowymi. Tryb odpowiedni do list z niedużą liczbą rekordów oraz przypadków, gdy akceptowalny jest dłuższy czas ładowania pierwszej strony, a następnie szybkie przełączanie między stronami.
• 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.
• Liczba pozycji na stronie: liczba wierszy, które będą wyświetlane na jednej stronie listy po włączeniu stronicowania; wartość domyślna 50.
• 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.

• Tryb pracy listy: dostępne wartości:
  • Server-side: (domyślnie włączone) operacje filtrowania są wykonywane po stronie serwera nAxiom, a wynikowe rekordy są przesyłane do przeglądarki; tryb zapewniający większą wydajność dla duzych zestawów danych.
  • Client-side: pobiera większy zestaw danych do przeglądarki i lokalnie wykonuje operacje filtrowania, sortowania i stronicowania; tryb odpowiedni dla mniejszych zestawów danych.
• 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.
• Liczba pozycji na stronie: liczba wierszy, które będą wyświetlane na jednej stronie listy po włączeniu stronicowania; wartość domyślna 50.

• Sposób budowy zapytania SQL: (widoczne tylko w trybie Server-side) dostępne wartości:
  • Podstawowy: (dotychczasowy) Zapytanie użytkownika jest wbudowywane osobno w każde podzapytanie (pobieranie danych, liczenie rekordów, obliczanie stopki). Najprostszy tryb w konfiguracji, jednak przy rozbudowanych zapytaniach może generować większe obciążenie bazy danych, ponieważ to samo zapytanie jest wykonywane wielokrotnie.
  • CTE: Zapytanie użytkownika jest definiowane raz jako wspólne wyrażenie tabelaryczne (CTE) i współdzielone przez wszystkie podzapytania (dane, liczba rekordów, stopka). Zalecany dla złożonych zapytań –– eliminuje powtarzanie kodu SQL i pozwala silnikowi bazy danych lepiej zoptymalizować plan wykonania.

  • Hybrydowy: Uprawnienia i dane są pobierane w dwóch oddzielnych zapytaniach. W pierwszym kroku system pobiera wyłącznie kolekcję identyfikatorów rekordów dostępnych dla użytkownika zgodnie z jego uprawnieniami (ACL). W drugim kroku pobierane są właściwe dane – z filtrowaniem, sortowaniem i paginacją –– ograniczone wyłącznie do dozwolonych rekordów. Zalecany w przypadku zwracania do 50 tys. rekordów, do których użytkownik posiada uprawnienia ACL.

    Ważne

    Dla ustawienia Hybrydowy sprawdzanie ACL odbywa się bezpośrednio na tabeli domyślnej dla definicji dokumentu wskazanej w definicji listy. W przypadku użycia w zapytaniu źródłowym listy innej tabeli lub funkcji tabelarycznej zbudowanej na innej tabeli lista nie będzie działać.

• 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świetlanie danych

• Filtrowanie: kliknięcie nagłówka kolumny z włączonym filtrowaniem powoduje wyświetlenie panelu, w którym można filtrować wartości wyświetlane w kolumnie. Sposoby filtrowania konfiguruje się we właściwościch poszczególnych kolumn.
• Sortowanie: włącza możliwość sortowania wierszy na liście według wartości wybranej kolumny; wymaga kliknięcia nagłówka kolumny; pierwsze kliknięcie powoduje sortowanie w kolejności rosnącej, drugie — malejącej, a trzecie wyłącza sortowanie.
• Grupowanie: włącza możliwość grupowania rekordów na liście według wartości wybranej kolumny; wymaga przeciągnięcia nagłówka kolumny do obszaru bezpośrednio pod panelem przycisków u góry.
• Domyślnie zwijaj grupy rekordów: po włączeniu powoduje, że w przypadku korzystania z funkcji grupowania grupy rekordów są domyślnie zwinięte.
• Struktura danych listy: dostępne wartości:
  • płaska: rekordy są wyświetlane jako lista bez struktury.
  • hierarchiczna: rekordy listy są wyświetlane jako hierarchia rozwijana (struktura drzewiasta) — 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; wymaga określenia wartości w polu Kolumna hierarchii.

• 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.

  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.

• Wyświetlanie treści rekordów: określa zachowanie w przypadku, kiedy wartość w kolumnie nie może zostać wyświetlona w całości; dostępne opcje:
  • Skracaj i dopisuj wielokropek
  • Zawijaj treść
• Zablokuj kolumnę akcji: po włączeniu blokuje przewijania w poziomie kolumny akcji w oknie, dzięki czemu jest ona zawsze widoczna w oknie listy.

Selekcja rekordów

• 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.

W przypadku listy osadzonej na formularzu (w sekcji typu lista) w kontekście formularza zapisywane są identyfikatory tych rekordów. Wartości te znajdują się w tabeli Selected i są dostepne poprzez zmienną {@KodSekcji_Selected}. Tej zmiennej można używać np. w akcjach SQL przypisanych do przycisku na formularzu.

Innym zastosowaniem tablicy Selected jest filtrowanie listy osadzonej na formularzu na podstawie rekordów zaznaczonych na innej liście osadzonej w tym samym formularzu. Służy do tego funkcja zależności od sekcji wraz z warunkiem zależności .

Interakcje z wierszem listy

• 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.

Odświeżanie listy

Umożliwia włączenie odświeżania widoku listy wyświetlanego przez użytkowników zalogowanych do FrontSPA. Dostępne tryby odświeżania to:

• Sterowane przez akcję: widok listy wyświetlany u wszystkich użytkowników zostanie odświeżony w wyniku uruchomienia akcji Odśwież listę u wszystkich użytkowników , o ile w akcji wybrano tryb wymuszonego odświeżenia, w przeciwnym razie po uruchomieniu akcji w widoku listy będzie pulsował przycisk odświeżania w prawym górnym rogu, informując o konieczności ręcznego odświeżenia listy przez użytkownika.
• Cykliczne: powoduje automatyczne odświeżanie widoku listy z podanym interwałem.
  • Interwał odświeżania (sek.): czas w sekundach pomiędzy kolejnymi odświeżeniami widoku listy.
• Wyłączone; (ustawienie domyślne) odświeżanie listy jest wyłączone.

Uwagi

• Jeśli użytkownik edytuje inline dane w widoku listy, cykliczne odświeżanie listy zostanie wstrzymane, a odświeżanie automatyczne będzie tylko sygnalizować konieczność odświeżenia pulsowaniem przycisku, bez względu na tryb odświeżania wybrany w akcji.
• W przypadku wywołania akcji w odniesieniu do listy, dla której nie włączono automatycznego odświeżania, to jedynym skutkiem zalogowanie informacji o tym przycisku do logu; nie zostanie zwrócony błąd ani wyjątek.

Opcje listy dla użytkownika końcowego

• Wyświetlaj pole wyszukiwania: włącza/wyłącza wyświetlanie pola wyszukiwania.
• Wyświetlaj zdefiniowane filtry listy: włącza/wyłącza wyświetlanie pola filtrowania z listą wyboru zdefiniowanych filtrów.
• Wyświetlaj przycisk odświeżania listy: włącza/wyłącza wyświetlanie przycisku do odświeżania listy.
• Wyświetlaj przycisk eksportu listy do Excela: włącza/wyłącza wyświetlanie polecenia Eksport do MS Excel w menu przycisku Odśwież.
• Wyświetlaj konfiguracje listy w nagłówku: włącza/wyłącza wyświetlanie polecenia Konfiguracje listy w menu przycisku Odśwież.
• Widoczność kolumn: steruje dostępem do opcji Widoczność kolumn w menu rozwijanym po kliknięciu strzałki obok przycisku odświeżania w widoku listy na Front SPA.
• Pomoc dla użytkownika
  • Pokaż pomoc, jeśli istnieje: (ustawienie domyślne) przyciski pomocy są wyświetlane, jeśli zdefiniowano akcje wywoływane przyciskiem pomocy.
  • Zawsze pokazuj pomoc; przycisk pomocy jest wyświetlany na formularzu/liście niezależnie od tego, czy skonfigurowano jego obsługę.
  • Nigdy nie pokazuj pomocy: ukrywa przycisk pomocy na liście/formularzu; ustawienie przydatne np. w przypadku formularza do wyświetlania pomocy.

Eksport listy

• Nazwa eksportowanego pliku: pozwala określić nazwę pliku generowanego po kliknięciu przycisku eksportu danych listy do formatu MS Excel; dostępne wartości:
  • Taka jak kod listy: (domyślnie) nazwa wyeksportowanego pliku ma postać kodListy.xlsx.
  • Taka jak nazwa listy: nazwa wyeksportowanego pliku ma postać nazwaListy.xlsx.
  • Zapytanie SQL: nazwa wyeksportowanego pliku jest zwracana przez zapytanie SQL, które należy wpisać w wyświetlonym oknie edytora; do wyniku zapytania jest dodawane rozszerzenie .xlsx.