Nahlížecí stránka - Tree

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). V kořeni stromové struktury jsou záznamy bez rodičovského záznamu.
• 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

Nový tree je možné vytvořit následujícím způsobem z nahlížecí stránky pomocí toolbaru s ovládacími prvky:

• Nejdříve se kliknutím myši na nahlížecí stránce určí pozice, na kterou má být nový tree umístěn. Tím dojde ke zvýraznění vybrané pozice šedou horizontální linií. Následně stačí v toolbaru nahlížecí stránky kliknout na položku „Tree“, v nově otevřeném dialogu vyplnit atributy nového ovládacího prvku, a následně uložit. Tím dojde k vložení nového tree na předem vybrané místo nahlížecí stránky.
• Nedojde-li před vložením nového tree k určení požadované pozice, bude nový tree vložen na konec nahlížecí stránky.

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 nahlížecí stránce 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 na nahlížecí stránce vertikálně přesouvány metodou Drag&Drop. Přesunutí spočívá v chycení ovládacího prvku nejlépe za jeho název, a následném tažení až na požadované místo na nahlížecí stránce.
• 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í
• Práva – Nastavení práv
• Administrace – Nastavení ostatních vlastností

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.

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 až po zadání hledaného výrazu do vyhledávacího pole stromové struktury.

2.4. Záložka „Práva“

2.4.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 na nahlížecí stránce.
• U nového ovládacího prvku se práva předvyplní podle ovládacího prvku na pozici určené před jeho vložením; není-li pozice určena, podle práv nahlížecí stránky.

2.4.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é nahlížecí stránky 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ů na nahlížecí stránce 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é nahlížecí stránky je přehled nastavení práv všech ovládacích prvků, který se zobrazí odkazem „Zobrazit přehled...“ na záložce „Práva“ v nastavení nahlížecí stránky.

2.5. Záložka „Administrace“

• Záložka „Administrace“ se zobrazuje pouze u existujících ovládacích prvků.

2.5.1. Umístění

• Výběr nahlížecí stránky, na které je ovládací prvek umístěn.
• Rozbalovací seznam obsahuje nahlížecí stránky umístěné ve stejné aplikaci a ve stejné kategorii jako nahlížecí stránka, na které ovládací prvek stojí. U nahlížecí stránky bez kategorie nabízí jen nahlížecí stránky bez kategorie. U nového ovládacího prvku obsahuje jen aktuální nahlížecí stránku.

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.