Strony typu Zestawienie, obok stron typu Formularz, należą do najczęściej wykorzystywanych rodzajów stron w bs4 core. Umożliwiają prezentowanie obiektów wybranej klasy w postaci tabeli.
Zestawienie może prezentować na przykład:
- kontrahentów,
- transakcje,
- zlecenia serwisowe,
- faktury,
- projekty,
- zadania,
- dowolne inne obiekty zdefiniowane w systemie.
1. Przejście do konfiguracji zestawienia #
Konfigurację strony typu Zestawienie można otworzyć na dwa sposoby.
1.1. Konfiguracja bezpośrednio ze strony #
- Otwórz odpowiednią stronę typu Zestawienie.
- Włącz tryb Konstruktor.
- Kliknij ikonę koła zębatego znajdującą się w prawym górnym rogu.
- Wybierz opcję Konfiguruj stronę.
1.2. Konfiguracja z poziomu edytora kartoteki #
Do edycji zestawienia można również przejść z poziomu edytora kartoteki, w której znajduje się dana strona.
Po otwarciu edytora strony przejdź do zakładki Konfiguruj zestawienie.
2. Wybór obiektów prezentowanych w zestawieniu #
Najważniejszym ustawieniem jest pole Obiekty w zestawieniu.
W polu tym należy wskazać klasę obiektów, które mają być prezentowane na stronie.
Przykładowo, aby utworzyć zestawienie kontrahentów, w polu Obiekty w zestawieniu należy wskazać klasę Kontrahent.
Wybrana klasa określa między innymi:
- jakie obiekty mogą pojawić się w tabeli,
- jakie pola mogą zostać wykorzystane jako kolumny,
- jakie filtry można zastosować,
- jakie strony obiektów mogą być otwierane po kliknięciu wiersza.
3. Domyślne sortowanie wyników #
3.1. Pole „Sortuj według” #
Pole Sortuj według określa kolumnę, według której zestawienie będzie domyślnie sortowane po otwarciu strony przez użytkownika.
Można:
- pozostawić to ustawienie puste,
- wskazać jedną z kolumn dostępnych dla klasy.
Kolumna wykorzystywana do sortowania nie musi być widoczna na stronie. Jeżeli jednak jest wyświetlana, użytkownik zobaczy przy niej oznaczenie aktywnego sortowania.
3.2. Kierunek sortowania #
Obok pola wyboru kolumny znajduje się ustawienie kierunku sortowania.
Dostępne są dwa warianty:
- rosnąco – na przykład od A do Z,
- malejąco – na przykład od Z do A.
W przypadku liczb lub dat sortowanie rosnące oznacza uporządkowanie od wartości najmniejszej lub najwcześniejszej do największej lub najpóźniejszej.
4. Grupowanie wyników #
Pole Grupuj według umożliwia podzielenie wyników zestawienia na sekcje.
Należy w nim wskazać kolumnę, według której mają być grupowane rekordy. Obiekty posiadające w tej kolumnie taką samą wartość zostaną wyświetlone obok siebie, pod wspólnym nagłówkiem grupy.
Grupowanie można zastosować na przykład do:
- kontrahentów według województwa,
- transakcji według opiekuna,
- zleceń według statusu,
- faktur według miesiąca,
- zadań według osoby odpowiedzialnej.
5. Kolumna rozwijana #
Pole Kolumna rozwijana pozwala wskazać dodatkową kolumnę, której zawartość będzie wyświetlana dopiero po rozwinięciu konkretnego wiersza.
Po skonfigurowaniu tego ustawienia przy każdym wierszu pojawi się ikona strzałki. Kliknięcie strzałki spowoduje rozwinięcie dodatkowej zawartości pod wybranym wierszem.
Rozwiązanie jest szczególnie przydatne w przypadku kolumn zawierających dużo informacji, na przykład:
- długi opis,
- uwagi,
- treść wiadomości,
- szczegółowe dane techniczne,
- dodatkowe informacje o obiekcie.
Dzięki zastosowaniu kolumny rozwijanej rozbudowana treść nie zajmuje miejsca w podstawowym widoku tabeli. Użytkownik może ją wyświetlić tylko dla interesującego go rekordu.
6. Kolorowanie wierszy zestawienia #
Pole Kolumna z polem określającym kolor umożliwia automatyczne kolorowanie całych wierszy zestawienia.
6.1. Przygotowanie pola określającego kolor #
Aby zastosować kolorowanie, w klasie obiektów należy utworzyć pole wyboru, którego poszczególne warianty mają przypisane kolory.
Przykładowo dla klasy Transakcja można utworzyć pole jednokrotnego wyboru Status transakcji zawierające warianty:
- Oferowanie,
- Negocjacje,
- Podpisane.
Następnie w edycji każdego wariantu należy przypisać odpowiedni kolor.
Przykładowo wariantowi Negocjacje można przypisać kolor zielony.
6.2. Włączenie kolorowania zestawienia #
Aby program kolorował wiersze:
- Utwórz w zestawieniu kolumnę korzystającą z pola wyboru, którego warianty mają przypisane kolory.
- W polu Kolumna z polem określającym kolor wskaż tę kolumnę.
- Zapisz konfigurację strony.
Program będzie odczytywał wartość pola dla każdego obiektu i kolorował cały wiersz zgodnie z kolorem przypisanym do wybranego wariantu.
W przedstawionym przykładzie transakcje posiadające status Negocjacje będą wyświetlane na zielono.
7. Limit wierszy na jednej stronie #
Pole Limit wierszy na jednej stronie pozwala określić indywidualną liczbę rekordów wyświetlanych na jednej stronie zestawienia.
Ustawienie obowiązuje wyłącznie dla aktualnie konfigurowanej strony. Jeżeli zostanie uzupełnione, zastąpi ogólny limit wierszy stosowany domyślnie w bs4 core.
Funkcja może być przydatna na przykład wtedy, gdy:
- zestawienie zawiera rozbudowane wiersze,
- strona jest wyświetlana na mniejszym ekranie,
- chcemy ograniczyć ilość danych ładowanych jednorazowo,
- konkretne zestawienie powinno prezentować więcej rekordów niż pozostałe strony.
8. Konfiguracja zestawienia jako wyszukiwarki #
Strona typu Zestawienie może zostać wykorzystana w elemencie formularza jako wyszukiwarka obiektów.
Przykładowo w formularzu zlecenia serwisowego można umieścić element pozwalający użytkownikowi wyszukać i wskazać kontrahenta powiązanego ze zleceniem.
Za sposób działania zestawienia w tym trybie odpowiada sekcja Wyszukiwarka.
8.1. Kolumna wyświetlana przy wyszukiwaniu #
W tym polu należy wskazać kolumnę, której wartość ma być prezentowana na liście wyników wyszukiwania.
Powinna to być kolumna umożliwiająca użytkownikowi łatwe rozpoznanie właściwego obiektu, na przykład:
- nazwa kontrahenta,
- numer zlecenia,
- nazwa projektu,
- temat zadania.
8.2. Filtry wykorzystywane przy wyszukiwaniu #
W sekcji wyszukiwarki można wskazać jeden lub kilka filtrów używanych podczas wyszukiwania tekstowego.
Filtry są uruchamiane kolejno dla tekstu wpisanego przez użytkownika.
Przykładowo wyszukiwarka kontrahentów może korzystać z:
- filtra wyszukującego po nazwie kontrahenta,
- filtra wyszukującego po numerze NIP.
Dzięki temu użytkownik może odnaleźć kontrahenta zarówno przez wpisanie jego nazwy, jak i numeru identyfikacji podatkowej.
9. Ustawienia zestawienia #
W sekcji Ustawienia zestawienia dostępne są dodatkowe atrybuty określające sposób działania i prezentacji strony.
9.1. Dostępne w górnej wyszukiwarce #
Włączenie atrybutu Dostępne w górnej wyszukiwarce powoduje udostępnienie zestawienia w górnej wyszukiwarce okna głównego programu.
Pozwala to użytkownikom szybciej odnajdywać obiekty prezentowane przez daną stronę.
9.2. Ukryj stronę w menu, jeśli zestawienie nie zwraca wyników #
Atrybut Ukryj stronę w menu, jeśli zestawienie nie zwraca wyników powoduje ukrycie strony w kartotece, gdy zestawienie nie zawiera żadnych rekordów.
Jeżeli w danym momencie zestawienie zwróci zero wyników, użytkownik nie zobaczy tej strony w menu kartoteki.
Ustawienie może być przydatne w przypadku stron, które mają znaczenie tylko wtedy, gdy istnieją określone dane, na przykład:
- aktywne zadania,
- nieopłacone faktury,
- otwarte zgłoszenia,
- zaległe czynności.
9.3. Dopasuj szerokość kolumn do szerokości ekranu #
Atrybut Dopasuj szerokość kolumn do szerokości ekranu włącza automatyczne dostosowywanie szerokości kolumn do dostępnej przestrzeni.
Pozwala to lepiej wykorzystać szerokość ekranu i ograniczyć konieczność przewijania tabeli w poziomie.
10. Otwieranie strony po kliknięciu wiersza #
Pole Po kliknięciu w wiersz otwórz stronę umożliwia określenie strony obiektu, która zostanie otwarta po kliknięciu dowolnego miejsca w wierszu zestawienia.
Po skonfigurowaniu tego ustawienia:
- użytkownik klika wybrany wiersz,
- program rozpoznaje obiekt prezentowany w tym wierszu,
- otwierana jest kartoteka tego obiektu,
- użytkownik zostaje przeniesiony na wskazaną stronę.
Jest to wygodne rozwiązanie, gdy cały wiersz ma pełnić funkcję odnośnika do szczegółów obiektu.
Alternatywnie można stosować odnośniki tylko w wybranych kolumnach. W takim przypadku kliknięcie całego wiersza nie musi powodować otwarcia strony.
11. Dodawanie obiektu przy pustym zestawieniu #
Pole Strona do dodawania przy pustym zestawieniu pozwala wskazać formularz dodawania nowego obiektu.
Jeżeli użytkownik otworzy zestawienie, które nie zawiera żadnych rekordów, program automatycznie przeniesie go na wskazaną stronę dodawania.
Funkcja przyspiesza tworzenie pierwszego obiektu w danym zestawieniu. Użytkownik nie musi samodzielnie wyszukiwać przycisku lub strony służącej do dodawania rekordu.
12. Komunikat przy braku wyników #
Pole Informacja, gdy brak wyników w zestawieniu umożliwia wprowadzenie własnego komunikatu wyświetlanego wtedy, gdy zestawienie nie zwraca żadnych rekordów.
Komunikat może:
- informować, dlaczego lista jest pusta,
- wyjaśniać, jakie warunki muszą zostać spełnione,
- wskazywać kolejną czynność użytkownika,
- zawierać instrukcję dodania pierwszego obiektu.
Przykładowe komunikaty:
Brak aktywnych zleceń serwisowych.
Nie znaleziono kontrahentów spełniających wybrane kryteria.
Nie dodano jeszcze żadnego projektu.
Wszystkie faktury zostały rozliczone.
Dobrze przygotowany komunikat jest bardziej czytelny niż pozostawienie użytkownikowi pustej tabeli bez dodatkowego wyjaśnienia.
