Aby na stronie typu Zestawienie wyświetlić dane w formie tabeli, należy najpierw zdefiniować odpowiednie kolumny. Każda kolumna określa, jakie informacje będą prezentowane użytkownikowi i w jaki sposób będzie można z nimi pracować.
Kolumny można tworzyć oraz edytować z kilku miejsc w programie bs4 core.
1. Dodawanie nowej kolumny z poziomu strony typu Zestawienie #
Najprostszym sposobem utworzenia kolumny jest przejście do ustawień konkretnej strony typu Zestawienie.
W tym celu:
- Otwórz stronę typu Zestawienie.
- Włącz tryb Konstruktor.
- Kliknij ikonę koła zębatego Konfiguruj stronę w prawym górnym rogu.
- W edytorze strony przejdź do zakładki Kolumny.
- Kliknij przycisk Dodaj nową kolumnę.
- Wybierz typ tworzonej kolumny.
Program otworzy edytor nowej kolumny. Po jej skonfigurowaniu będzie można umieścić ją na edytowanej stronie typu Zestawienie.
2. Dodawanie kolumny z poziomu klasy #
Nową kolumnę można również utworzyć bezpośrednio w kartotece klasy.
W tym celu:
- Otwórz edytor wybranej klasy.
- Przejdź do zakładki Kolumny.
- Kliknij przycisk Dodaj nowe.
- Wybierz odpowiedni typ kolumny.
- Uzupełnij jej ustawienia.
Kolumna utworzona w ten sposób zostanie domyślnie powiązana z klasą, z poziomu której została dodana.
Przykładowo, jeżeli kolumna zostanie utworzona w ustawieniach klasy Kontrahent, program automatycznie przypisze ją do tej klasy.
3. Przechodzenie do edycji istniejącej kolumny #
Do edycji wcześniej zdefiniowanej kolumny można przejść na kilka sposobów.
3.1. Edycja bezpośrednio ze strony zestawienia #
Jeżeli kolumna jest już wykorzystywana na stronie typu Zestawienie:
- Otwórz odpowiednią stronę.
- Włącz tryb Konstruktor.
- Kliknij ikonę znajdującą się w lewym górnym rogu strony, która otwiera listę kolumn użytych w zestawieniu.
- Przy wybranej kolumnie kliknij ikonę koła zębatego.
Program otworzy edytor ustawień wskazanej kolumny.
3.2. Edycja z poziomu ustawień strony #
Kolumnę można również edytować w ustawieniach strony:
- Kliknij Konfiguruj stronę.
- Przejdź do zakładki Kolumny.
- Odszukaj odpowiednią kolumnę.
- Otwórz jej ustawienia.
3.3. Edycja z poziomu klasy #
Kolumna może zostać otwarta do edycji również z kartoteki klasy, w zakładce zawierającej zestawienie kolumn przypisanych do tej klasy.
W przypadku edycji kolumn bezpośrednio z interfejsu strony należy mieć włączony tryb Konstruktor.
4. Typy kolumn #
W bs4 core dostępne są różne typy kolumn. Typ kolumny określa sposób pobierania, wyświetlania i ewentualnej edycji danych.
Do najczęściej wykorzystywanych należą:
- Pole – podgląd,
- Pole – edytowalne,
- Dowolny tekst.
Typ kolumny wybierany jest podczas jej tworzenia.
Niezależnie od wybranego typu każdej kolumnie można nadać:
- nazwę,
- opis kolumny jako podpowiedź dla użykowników.
5. Kolumna typu „Pole – podgląd” #
Kolumna typu Pole – podgląd jest najczęściej wykorzystywanym typem kolumny.
Służy do wyświetlania wartości konkretnego pola obiektu bez możliwości bezpośredniej edycji tej wartości w tabeli.
5.1. Powiązanie kolumny z klasą #
Kolumna typu Pole – podgląd zawsze jest powiązana z określoną klasą.
W ustawieniach kolumny należy wskazać:
- klasę, z której mają pochodzić dane,
- pole tej klasy, którego wartość ma być wyświetlana.
Przykładowo dla kolumny powiązanej z klasą Kontrahent można wskazać takie pola jak:
- Nazwa kontrahenta,
- NIP,
- Rodzaj klienta,
- Ważność.
Każdy wiersz zestawienia będzie wówczas prezentował wartość wskazanego pola dla odpowiedniego obiektu.
5.2. Link do strony obiektu #
Na zawartości kolumny typu Pole – podgląd można włączyć odnośnik do wybranej strony obiektu.
W ustawieniach kolumny należy wskazać stronę opisującą obiekt danej klasy.
Po skonfigurowaniu odnośnika kliknięcie wartości w kolumnie spowoduje otwarcie wskazanej strony obiektu.
Przykładowo kliknięcie nazwy kontrahenta może otwierać jego kartę główną lub formularz szczegółowych danych.
Link przypisany do kolumny działa niezależnie od ustawienia umożliwiającego otwieranie strony po kliknięciu całego wiersza.
5.3. Ustawienia zależne od rodzaju pola #
Zakres dostępnych ustawień kolumny może zależeć od rodzaju pola wyświetlanego w kolumnie.
Inne opcje mogą być dostępne dla:
- pól tekstowych,
- pól liczbowych,
- dat,
- pól wyboru,
- pól powiązania.
Dlatego po wskazaniu pola należy sprawdzić, czy w edytorze kolumny pojawiły się dodatkowe ustawienia charakterystyczne dla danego rodzaju danych.
6. Wyświetlanie danych z powiązanej klasy #
Kolumna może prezentować informacje pochodzące z klasy innej niż klasa obiektów wyświetlanych w zestawieniu.
Przykładowo w zestawieniu kontrahentów można wyświetlić imię i nazwisko opiekuna klienta. Kontrahent jest obiektem jednej klasy, natomiast opiekun może być obiektem klasy Pracownik lub Użytkownik.
W takim przypadku należy skorzystać z sekcji Przejdź do pól z innej klasy.
6.1. Pole powiązania a dane opisujące obiekt #
Jeżeli jako pole wyświetlane w kolumnie zostanie wskazane bezpośrednio pole typu Powiązanie, kolumna może prezentować identyfikator powiązanego obiektu.
Aby zamiast identyfikatora wyświetlić właściwe dane opisujące ten obiekt, na przykład imię i nazwisko opiekuna, należy:
- w sekcji Przejdź do pól z innej klasy wskazać pole typu Powiązanie,
- przejść za jego pośrednictwem do klasy powiązanej,
- wskazać pole z tej klasy, które ma być wyświetlane.
W zestawieniu kontrahentów konfiguracja może wyglądać następująco:
- przejście przez pole Opiekun,
- wybór pola Imię i nazwisko z klasy Użytkownik.
Szczegółowe zasady przechodzenia do pól z innych klas zostały opisane w odrębnej części instrukcji.
7. Podsumowanie kolumn liczbowych #
Dla kolumn zawierających pola liczbowe można włączyć podsumowanie.
Po aktywowaniu tej funkcji program może prezentować pod kolumną zbiorczą wartość wyliczoną na podstawie rekordów widocznych w zestawieniu.
Podsumowanie może być wykorzystywane między innymi dla:
- wartości transakcji,
- kwot faktur,
- liczby godzin,
- kosztów,
- przychodów,
- innych danych liczbowych.
Dostępność i sposób działania podsumowania zależą od konfiguracji kolumny oraz rodzaju wyświetlanego pola.
8. Kolumna typu „Pole – edytowalne” #
Kolumna typu Pole – edytowalne działa podobnie do kolumny typu Pole – podgląd, ale umożliwia zmianę wartości bezpośrednio w komórkach zestawienia.
Użytkownik nie musi otwierać osobnego formularza obiektu. Może wprowadzić zmianę bezpośrednio w tabeli.
8.1. Brak możliwości zastosowania linku #
W kolumnie edytowalnej zawartość komórki służy do zmiany wartości, dlatego nie można jednocześnie umieścić na niej linku do strony obiektu.
Kliknięcie komórki uruchamia edycją wartości zamiast przejścia do innej strony.
8.2. Zapisywanie zmian #
Samo zmodyfikowanie wartości w kolumnie edytowalnej nie powoduje natychmiastowego zapisania danych.
Na stronie zestawienia należy dodatkowo udostępnić opcję Zapisz zmiany.
Po zakończeniu edycji użytkownik powinien:
- zmienić wartości w wybranych komórkach,
- wybrać opcję Zapisz zmiany,
- poczekać na zapisanie danych przez program.
Bez użycia tej opcji wprowadzone zmiany mogą nie zostać utrwalone.
9. Umieszczanie kolumn na stronie zestawienia #
Samo zdefiniowanie kolumny nie powoduje jeszcze jej automatycznego wyświetlenia na stronie.
Kolumny używane na danym zestawieniu wskazuje się w zakładce Kolumny w ustawieniach strony.
W tej zakładce można:
- dodawać wcześniej zdefiniowane kolumny do strony,
- usuwać kolumny z widoku strony,
- zmieniać ich kolejność,
- edytować ustawienia poszczególnych kolumn.
10. Zmiana kolejności kolumn #
Kolejność kolumn na stronie można ustalać metodą przeciągnij i upuść.
W tym celu:
- Otwórz ustawienia strony.
- Przejdź do zakładki Kolumny.
- Chwyć wybraną kolumnę.
- Przeciągnij ją w odpowiednie miejsce na liście.
- Zapisz ustawienia strony.
Kolejność na liście odpowiada kolejności wyświetlania kolumn w zestawieniu, licząc od lewej strony tabeli.
11. Alternatywna lista kolumn dla wersji lite #
Dla strony typu Zestawienie można zdefiniować alternatywną listę kolumn przeznaczoną dla wersji lite.
Alternatywna konfiguracja pozwala wyświetlać na urządzeniach mobilnych mniejszą liczbę najważniejszych kolumn, bez zmiany pełnego widoku dostępnego na komputerze.
W wersji lite warto pozostawić przede wszystkim dane potrzebne do szybkiego rozpoznania obiektu, na przykład:
- nazwę,
- status,
- datę,
- osobę odpowiedzialną,
- najważniejszą wartość liczbową.
Pozwala to zachować czytelność zestawienia na mniejszych ekranach i ograniczyć konieczność przewijania tabeli w poziomie.
