1. Základní informace
1.1. Popis ovládacího prvku
Tree je stromová struktura.
- Uzly stromové struktury se skládají podle systémového sloupce „pid“, který odkazuje na rodičovský záznam téhož formuláře (vnořené záznamy). Je-li stromová struktura nad formulářem otevřeného záznamu a její databázový dotaz nemá podmínky, je v kořeni aktuálně otevřený záznam. Jinak jsou v kořeni vnořené záznamy aktuálně otevřeného záznamu (má-li dotaz nad týmž formulářem podmínku na sloupec „id“), záznamy bez rodičovského záznamu, a nejsou-li žádné, záznamy vnořené pod záznamem jiného formuláře.
- Přetažením uzlu metodou Drag&Drop se změní rodičovský záznam přetaženého záznamu. Změna se uloží do databáze ihned, zapíše se do historie změn a nespouští ukládací skripty editačního formuláře. Přesunout lze jen záznam, který smí uživatel upravit.
- Obsahuje-li text uzlu svislítko „|“, zobrazí se části textu oddělené svislítkem jako sloupce vedle sebe. Při zaškrtnutém poli „Zobrazit detaily ve stromu“ se text uzlu nerozděluje.
1.2. Vytvoření nového ovládacího prvku
- Detailní popis vytváření nových ovládacích prvků v editačním formuláři je uveden v samostatné příručce Vytváření ovládacích prvků editačního formuláře.
1.3. Editace nebo smazání ovládacího prvku
- U každého existujícího ovládacího prvku se po jeho levé straně v editačním formuláři zobrazuje ikona tužky, která slouží pro změnu nastavení ovládacího prvku nebo jeho smazání.
- Jednotlivé ovládací prvky mohou být v editačním formuláři vertikálně přesouvány metodou Drag&Drop. Přesunutí spočívá v chycení ovládacího prvku nejlépe za jeho název umístěný v levém sloupci editačního formuláře, a následném tažení až na požadované místo v editačním formuláři.
- Ovládací prvky je možné přesouvat jen se zaškrtnutým polem „Drag&Drop“ umístěným nad toolbarem s ovládacími prvky. Z bezpečnostních důvodů je toto pole po každém přihlášení do aplikace nezaškrtnuté, aby nedošlo k nechtěnému přesunutí ovládacího prvku.
2. Seznam záložek v dialogu nastavení ovládacího prvku
- Obecné – Nastavení obecných vlastností
- Detaily – Nastavení sloupců zobrazovaných v detailech
- Hledání – Nastavení hledání
- Nápověda – Nastavení textu nápovědy
- Práva – Nastavení práv
2.1. Záložka „Obecné“
2.1.1. Název
- Název ovládacího prvku zobrazovaný v záhlaví stromové struktury.
2.1.2. Slovník
- Slovník zobrazuje seznam názvů ostatních ovládacích prvků, formulářů, nahlížecích stránek, kategorií, aplikací a aplikačních skupin, použitých napříč celou aplikací.
- Vyhledávání ve slovníku slouží k navržení správného názvu ovládacího prvku a k udržení konzistence názvosloví v celé aplikaci tak, aby se ovládací prvky se stejným významem umístěné na různých místech v aplikaci nazývaly stejným způsobem.
2.1.3. Šířka
- Šířka ovládacího prvku uvedená v pixelech.
- Při nevyplnění tohoto zadávacího pole se stromová struktura roztáhne na celou dostupnou šířku.
2.1.4. Zdroj dat
- Zdroj dat definuje zdrojové databázové záznamy zobrazované ve stromové struktuře.
- Nastavení zdroje dat se provádí v grafickém návrháři databázových dotazů. Detailní popis návrháře databázových dotazů je uveden v samostatné příručce Návrhář databázových dotazů.
2.1.5. Uspořádání
- Uspořádání určuje způsob zobrazování stromové struktury buď zleva doprava nebo odshora dolů.
- Rozbalovací seznam obsahuje následující hodnoty:
- Vodorovné – zobrazování stromové struktury zleva doprava
- Svislé – zobrazování stromové struktury odshora dolů
2.1.6. Typ
- Typ stromové struktury určuje rozsah zobrazení stromové struktury.
- Celý strom obsahuje všechny uzly, a následné zobrazování nebo skrývání jednotlivých poduzlů je řešeno pomocí javascriptu.
- Úsporný režim zobrazuje pouze aktivní uzly, a následné zobrazování nebo skrývání jednotlivých poduzlů je řešeno pomocí aktualizace webové stránky.
- Volba nabízí následující hodnoty:
- Celý strom – vnitřní a koncové uzly dohromady
- Celý strom – nejdříve vnitřní, potom koncové uzly
- Úsporný strom – vnitřní a koncové uzly dohromady
- Úsporný strom – nejdříve vnitřní, potom koncové uzly
- Je-li stromová struktura řazena podle ovládacího prvku s celočíselným datovým typem, řídí se pořadí uzlů jen tímto řazením a volba mezi variantami „vnitřní a koncové uzly dohromady“ a „nejdříve vnitřní, potom koncové uzly“ nemá vliv.
2.1.7. Možnosti
- Zobrazit ikonu „Nový záznam...“
- Zaškrtnutí tohoto pole určuje, zda má být v záhlaví stromové struktury a u jednotlivých uzlů zobrazena ikona, která přesměruje uživatele do konkrétního editačního formuláře za účelem založení nového záznamu v databázi.
- Ikona se zobrazí jen tehdy, patří-li sloupec, jehož hodnoty stromová struktura zobrazuje v uzlech, zdrojovému formuláři databázového dotazu, a ne formuláři připojenému spojením.
- Zakázat otevírání záznamů
- Zaškrtnutí tohoto pole určuje, zda má být všem uživatelům zakázána možnost vstupu do editačního formuláře za účelem otevření zobrazovaného databázového záznamu pomocí ikony tužky, která se zobrazuje na začátku každého uzlu stromové struktury.
- Zakázat Drag&Drop
- Zaškrtnutí tohoto pole určuje, zda má být zakázáno přesouvání jednotlivých uzlů stromové struktury metodou Drag&Drop.
- Při povoleném Drag&Drop se v záhlaví stromové struktury zobrazuje ikona „Pořadí...“, která otevírá dialog pro změnu pořadí uzlů. Ikona se zobrazí jen tehdy, má-li zdrojový formulář databázového dotazu textové pole se zaškrtnutou volbou „Zobrazit ikonu „Pořadí...“ v nahlížecí tabulce“.
- Je-li povolen Drag&Drop a stromová struktura je řazena podle celočíselného sloupce zdrojového formuláře, zobrazují se v navigační liště pod stromovou strukturou, a při zobrazené horní navigační liště i v ní, ikony „Přesunout nahoru“ a „Přesunout dolů“. Posunou vybraný uzel o jedno místo mezi uzly téže úrovně a hodnoty sloupce řazení u těchto uzlů přečíslují od 1. Při zaškrtnutém poli „Rozbalit vše“ se navigační lišty, a s nimi ani tyto ikony, nezobrazují.
- Rozbalit vše
- Zaškrtnutí tohoto pole určuje, zda má být stromová struktura při jejím zobrazení celá rozbalená včetně všech jejích uzlů a poduzlů.
- Ikona pro rozbalení celé stromové struktury je k dispozici také v zápatí každé stromové struktury.
- Skrýt zdroj dat
- Zaškrtnutí tohoto pole určuje, zda má být při otevření editačního formuláře automaticky skrytý obsah stromové struktury. Databázové záznamy se uživateli zobrazí až po kliknutí na ikonu „Zobrazit“, nebo kliknutím na záložku, ve které se stromová struktura nachází.
2.2. Záložka „Detaily“
2.2.1. Možnosti
- Zobrazit detaily
- Zaškrtnutí tohoto pole určuje, zda má stromová struktura zobrazovat detaily jednotlivých záznamů. Při svislém uspořádání se detaily zobrazují napravo vedle stromové struktury, při vodorovném uspořádání a na mobilním zařízení pod stromovou strukturou.
- Zobrazit detaily ve stromu
- Zaškrtnutí tohoto pole určuje, zda má stromová struktura zobrazovat detaily jednotlivých záznamů jako součást jednotlivých uzlů nebo poduzlů.
- Zobrazit tooltip
- Zaškrtnutí tohoto pole určuje, zda má stromová struktura zobrazovat detaily jednotlivých záznamů v tooltipu při najetí myší nad jednotlivými záznamy.
- Na mobilním zařízení se tooltip nezobrazuje.
2.2.2. Sloupce
- Definice sloupců detailů zobrazovaných v detailech vedle stromové struktury nebo pod ní, v uzlech stromové struktury, nebo při najetí myší nad jednotlivými záznamy stromové struktury.
2.3. Záložka „Hledání“
2.3.1. Možnosti
- Aktivovat hledání
- Zaškrtnutí tohoto pole určuje, zda má být v záhlaví stromové struktury automaticky zobrazen řádek s vyhledávacím polem a tlačítkem „Hledat“.
- Na mobilním zařízení s malým displejem se řádek automaticky nezobrazuje.
- Zobrazit pouze výsledky hledání
- Zaškrtnutí tohoto pole určuje, zda mají být data ve stromové struktuře zobrazena pouze při vyplnění hodnot ve formuláři, na které se odkazují omezující podmínky databázového dotazu této stromové struktury.
2.4. Záložka „Nápověda“
2.4.1. Nápověda
- Nápověda je text zobrazovaný napravo od ovládacího prvku v editačním formuláři.
- Nápovědy všech ovládacích prvků začínají na stejné svislé linii v rámci celého editačního formuláře.
- Text – text nápovědy je definován ručně zadaným textovým řetězcem ve víceřádkovém textovém poli pod radio buttonem
- Z dotazu – text nápovědy je definován výsledkem databázového dotazu, který je vyhodnocen při otevření editačního formuláře
- Detailní popis nápovědy je uveden v samostatné příručce Nastavení vzhledu.
2.5. Záložka „Práva“
2.5.1. Práva
- Práva definují seznam uživatelských skupin a uživatelů, kteří mají oprávnění na zobrazení ovládacího prvku v editačním formuláři.
2.5.2. Nahradit práva ostatním ovládacím prvkům
- Funkce „Nahradit práva ostatním ovládacím prvkům“ slouží pro sjednocení práv v rámci celého editačního formuláře u ovládacích prvků, které spolu z pohledu práv souvisí.
- Díky odkazu „Zobrazit...“ je možné zobrazit seznam všech ovládacích prvků v editačním formuláři včetně nastavení práv těchto ovládacích prvků. U každého ovládacího prvku je zobrazeno zaškrtávací tlačítko, kterým je možné ovládací prvek vybrat. Při uložení ovládacího prvku se následně nastaví stejná práva i těmto vybraným ovládacím prvkům.
- Alternativou pro sjednocení práv v rámci celého editačního formuláře je zobrazení reportu dostupného ze záložky „Práva podřízených objektů“ v nastavení editačního formuláře.
2.6. Tlačítka „Uložit“, „Uložit všem uživatelům“, „Smazat“ a „Zavřít“
- Tlačítko „Uložit“ – Uložení změn v nastavení ovládacího prvku spolu s individuálním nastavením aktuálně přihlášeného uživatele.
- Sloupce na záložce „Detaily“ z tohoto dialogu se převezmou do individuálního nastavení tohoto tree u aktuálního uživatele.
- Individuální nastavení tree je možné otevřít pomocí ikony ozubeného kolečka v liště s ikonami v záhlaví tree. Ikona se zobrazuje, je-li zaškrtnuté některé z polí „Zobrazit detaily“, „Zobrazit detaily ve stromu“ nebo – mimo mobilní zařízení – „Zobrazit tooltip“.
- Individuální nastavení tree zahrnuje tyto možnosti:
- Nastavení sloupců na záložce „Detaily“ individuálního nastavení tree
- U všech ostatních uživatelů zůstane jejich individuální nastavení zachováno.
- Uživatelům s administrátorským oprávněním nabízí dialog individuálního nastavení také záložku „Uložit více uživatelům“. Tlačítko „Uložit více uživatelům“ přepíše vybraným uživatelským skupinám a uživatelům sloupce detailů v individuálním nastavení tree podle dialogu.
- Tlačítko „Uložit všem uživatelům“ – Uložení změn v nastavení ovládacího prvku a smazání individuálního nastavení tohoto tree všem ostatním uživatelům, aby při prvním novém zobrazení tohoto tree bylo použito výchozí nastavení definované v tomto dialogu. Individuální nastavení aktuálního uživatele se upraví stejně jako tlačítkem „Uložit“.
- Tlačítko „Smazat“ – Trvalé odstranění ovládacího prvku.
- Tlačítko „Zavřít“ – Zavření dialogu s nastavením ovládacího prvku bez uložení změn.