Lista

Podsumowanie:
W tej sekcji można osadzić na formularzu widok listy.

Oprócz właściwości współdzielonych ta sekcja wymaga określenia następujących właściwości:

Wyświetlana lista: wybierz widok listy, który będzie wyświetlany w sekcji.
Ustawienia: wyświetla okno dialogowe z ustawieniami listy osadzonej w formularzu dotyczącymi jej wyświetlania w aplikacji FrontSPA:
- Wyświetlaj zdefiniowane filtry listy: pozwala korzystać z rozwijanej listy zdefiniowanych filtrów.
- Wyświetlaj konfiguracje listy w nagłówku: wyświetla listę zapisanych konfiguracji.
- Wyświetlaj przycisk eksportu listy do Excela: wyświetla ikonę eksportu danych listy do Excela.
- Wyświetlaj przycisk odświeżania listy: wyświetla ikonę odświeżania danych w sekcji typu lista.
- Zapamiętuj tymczasową konfigurację listy: pozwala zapamiętywać konfigurację listy ustawioną przez użytkownika w aplikacji FrontSPA (grupowanie, sortowanie, szerokość i kolejność kolumn) na czas przełączenia do innej karty.
- Wymuś wyświetlanie listy w trybie mobilnym: stosuje ustawienia trybu mobilnego do wyświetlania listy.
- Wyświetlaj nazwę kolumn listy w tej sekcji: pozwala wyłączyć wyświetlanie nazw kolumn w sekcji.
- Wymuś wyświetlanie przycisków kolumny akcji jeden nad drugim: wymusza „pionowe” rozmieszczenie przycisków w kolumnie akcji.
- Pokazuj w paginatorach liczbę kart i nawigację między kartami (jeżeli włączono paginację): pozwala ograniczyć informacje wyświetlane na pasku paginacji pod listą. -Edytuj: wyświetla okno Kreator listy, w którym można dokonać edycji listy osadzonej w sekcji formularza.

Zależność od sekcji: pozwala określić sekcję zawierającą pole, którego wartości będą mogły zostać użyte do filtrowania listy; możliwe jest także filtrowanie bieżącej listy zależnie od rekordów zaznaczonych we wskazanej sekcji typu lista; ponadto zależność powoduje, że sekcja zależna będzie odświeżana każdorazowo po zmianie danych w sekcji nadrzędnej.

Warunek dla zależności: wyrażenie SQL filtrujące rekordy sekcji typu lista, zależnie od wartości pola na innej sekcji; możliwe są dwa rodzaje warunków:
- KolumnaListy operator {@_Section_PoleFormularza}: KolumnaListy to nazwa kolumny listy wyświetlanej w sekcji, @_Section_ to przedrostek, a PoleFormularza to właściwość Pole formularza pola w sekcji wskazanej jako nadrzędna. Wartość w tym polu jest używana do filtrowania rekordów listy.
- KolumnaListy IN (SELECT [value] FROM OPENJSON({@_Section_kodSekcji_Selected})): w tym przypadku zmienna {@_Section_kodSekcji_Selected} zwraca tablicę JSON ([Id1, Id2…]) z identyfikatorami rekordów zaznaczonych w sekcji nadrzędnej.

W edytorze SQL obsługiwany jest mechanizm smart numbers. Po kliknięciu przycisku Podgląd zapytania SQL wyświetlane jest okno dialogowe edytora, w którym można sprawdzić poprawność składni. Aby to było możliwe, w obszarze u góry okna wyświetlana jest w trybie tylko do odczytu część zapytania dla zależności w formie:

SELECT * FROM (SELECT * FROM List_View) WHERE...

Poniżej jest wyświetlany sam warunek.

Aby sprawdzić poprawność składni, należy w polach z prawej strony podać wartości parametrów ({@Nazwa}) występujących w zapytaniu. Dodatkowo, po kliknięciu przycisku Wykonaj zapytanie zostanie wyświetlone okno edytora SQL z całym zapytaniem warunku zależności. Po podstawieniu za parametry przykładowych wartości i ponownym kliknięciu przycisku Wykonaj zapytanie w dolnej części okna zostaną wyświetlone wyniki zwrócone przez zapytanie.

Dostępność: kliknięcie przycisku Ustaw wyświetla okno dialogowe z dwiema kartami:
- Ustawienia sekcji: ustawienia dostępności całej sekcji.
- Ustawienia dla przycisków listy:
  - Ustawienia dla przycisku Nowy dokument: ustawienia dostępności przycisku Nowy dokument wyświetlanego standardowo w nagłówku listy.
  - Ustawienia dla przycisku Edytuj: ustawienia dostępności przycisku Edytuj wyświetlanego standardowo w każdym rekordzie listy (w kolumnie akcji).
Ustawienia dostępności dla całej sekcji typu lista oraz dla wymienionych powyżej przycisków określa się tak samo, jak dla innych sekcji i kontrolek formularza.
Obliczanie dostępności przycisków nagłówka i kolumny akcji listy: dostępne wartości to:
- z ustawień sekcji: dla przycisków listy osadzonej na formularzu obowiązują ustawienia dostępności określone we właściwościach sekcji typu lista.
- z definicji listy: dla przycisków listy osadzonej na formularzu obowiązują ustawienia dostępności określone w definicji listy.

Przykład

Poniższy warunek zależności spowoduje wyświetlenie na liście zależnej tylko tych rekordów, które zostały zaznaczone na liście nadrzędnej. KodSekcji to kod sekcji nadrzędnej (wybranej z listy Zależność od sekcji).

W odwołaniu @_Section_KodSekcji_Selected kod sekcji musi się zaczynać od wielkiej litery, niezależnie od tego, od jakiej litery zaczyna się kod sekcji nadrzędnej.

[Id] IN
(SELECT [value]
FROM
OPENJSON({@_Section_KodSekcji_Selected}))

|← Komentarze |↑ Do góry |→ Prosta lista |