Strona typu Drzewko przedstawia obiekty w strukturze nadrzędnych i podrzędnych elementów. Może służyć do prezentowania kategorii, struktury organizacyjnej, podziału zadań lub innych danych hierarchicznych.
1. Zastosowanie drzewka #
Drzewko jest przydatne, gdy obiekt należy do innego obiektu tej samej klasy, na przykład podkategoria do kategorii nadrzędnej. Poszczególne gałęzie można rozwijać, aby przeglądać kolejne poziomy.
Widok może również umożliwiać zmianę hierarchii i kolejności przez przeciąganie. Do samego przeglądania danych nie trzeba udostępniać tej operacji.
2. Klasa i pole obiektu nadrzędnego #
Wybierz klasę obiektów. Hierarchię określa pole powiązania z obiektem nadrzędnym oznaczone atrybutem przeznaczonym do budowania drzewka.
Dla klasy Kategoria może to być pole „Kategoria nadrzędna”, wskazujące inną kategorię. Obiekty bez nadrzędnego elementu tworzą najwyższy poziom struktury. Jeśli klasa nie ma skonfigurowanego pola hierarchii, widok przedstawia płaską listę.
Wartości powiązań powinny tworzyć spójną strukturę. Unikaj cykli, w których obiekt pośrednio lub bezpośrednio wskazuje sam siebie. Zasady powiązań opisano w artykule Przechodzenie między klasami.
3. Treść elementu #
Wskaż kolumnę dostarczającą etykietę elementu. Może to być nazwa albo kolumnę typu „Dowolny tekst”, zawierająca również kod czy status.
Można także wskazać kolumnę dodatkowej treści. W drzewku dodatkowa treść może być pokazywana pod elementem, który nie ma własnych obiektów podrzędnych. Warto sprawdzić wygląd zarówno elementów z dziećmi, jak i liści.
Kolumna określająca kolor pozwala dodatkowo wyróżniać elementy według wartości pola.
4. Sortowanie i ręczna kolejność #
Ustal kolumnę sortującą. Jeśli użytkownicy mają ręcznie układać elementy, przygotuj pole liczbowe przechowujące kolejność oraz kolumnę opartą na tym polu.
Wskaż tę kolumnę w sortowaniu i zastosuj kierunek rosnący. Podczas zapisu przeciągnięcia program może zapisać kolejne numery w polu liczbowym. Sortowanie alfabetyczne nie służy do utrwalania ręcznej kolejności.
5. Przeciąganie elementów #
Aby udostępnić zmianę układu, włącz atrybut Pozwól przeciągać wiersze. Przeniesienie elementu może zmienić jego obiekt nadrzędny, a przy poprawnie przygotowanej kolumnie liczbowej — również kolejność.
Jest to zmiana zapisanych danych. Po przeciągnięciu sprawdź powiązanie i numer porządkowy w formularzu obiektu, a następnie odśwież stronę. Dostępność operacji powinna odpowiadać uprawnieniom użytkowników.
6. Filtry i zachowanie hierarchii #
Drzewko korzysta z filtrów i ograniczeń danych. Przy wyszukiwaniu program może dołączyć elementy nadrzędne potrzebne do pokazania położenia znalezionego obiektu.
Nie należy traktować każdego widocznego rodzica jako osobnego trafienia filtra. Jego obecność może służyć zachowaniu kontekstu. Przy blokadach filtrów trzeba zadbać o to, aby potrzebne elementy struktury mieściły się w dozwolonym zakresie danych.
7. Przykład konfiguracji #
Dla kategorii produktów przygotuj pole powiązania „Kategoria nadrzędna” z atrybutem hierarchii oraz pole liczbowe „Kolejność”. Wybierz nazwę jako etykietę, a kolumnę pola Kolejność jako sortowanie. Jeśli potrzebna jest edycja struktury, włącz przeciąganie.
Sprawdź kilka poziomów, elementy bez rodzica, filtrowanie głębokiej gałęzi i zapis po przeniesieniu. Przy dużej strukturze ogranicz zakres widoku; mechanizm budowania drzewka ma limit 10 000 pobieranych rekordów.
Zobacz także: Dodawanie i edycja kolumn, Dodawanie i edycja filtrów oraz Blokady filtrów.
