Nahlížecí stránka

1. Základní informace

• Nahlížecí stránka je grafické rozhraní, které slouží k vizualizaci, prohlížení, filtrování a prohledávání databázových záznamů. Představuje základní pracovní nástroj pro orientaci v datech a jejich hromadné zobrazení.

1.1. Ovládací prvky nahlížecí stránky

• Nahlížecí stránka se skládá z vizuálních ovládacích prvků, které jsou řazeny pod sebou a společně tvoří výsledné rozložení stránky.
• Nahlížecí stránka je zároveň prostředníkem pro vstup do editačního formuláře – buď za účelem založení nového záznamu v databázi, nebo za účelem editace konkrétního již existujícího záznamu.
  • Pro potřeby založení nového záznamu v databázi může uživatel vstoupit do editačního formuláře z nahlížecí stránky následujícími způsoby:
    • Pomocí tlačítka, které přesměruje uživatele do konkrétního editačního formuláře. Tento způsob se definuje přímo ve vlastnostech ovládacího prvku „Button“, nebo v jeho skriptu pomocí funkce „SCHEDULEFORM“.
    • Pomocí nahlížecí tabulky, která přesměruje uživatele do editačního formuláře, jehož data zobrazuje. Tento způsob se definuje ve vlastnostech nahlížecí tabulky povolením zobrazení ikony „Nový záznam...“.
    • Pomocí ostatních vizuálních ovládacích prvků, jako je klasický kalendář, plánovací vícezdrojový kalendář, rozvrh hodin, ganttův diagram nebo stromová struktura. Tento způsob se definuje ve vlastnostech daného vizuálního ovládacího prvku povolením zadávání nových záznamů.
    • Pomocí nahlížecí stránky, která přesměruje uživatele do konkrétního editačního formuláře. Tento způsob se definuje přímo ve vlastnostech nahlížecí stránky.
  • Pro potřeby editace konkrétního již existujícího záznamu v databázi může uživatel vstoupit do editačního formuláře pomocí následujících možností:
    • Pomocí nahlížecí tabulky, která zobrazuje na začátku každého řádku ikonu tužky s funkcí otevření zobrazovaného databázového záznamu.
    • Pomocí ostatních vizuálních ovládacích prvků, jako je klasický kalendář, plánovací vícezdrojový kalendář, rozvrh hodin, ganttův diagram, mapa nebo stromová struktura. Tyto ovládací prvky buď zobrazují ikonu tužky, nebo umožňují otevření databázového záznamu kliknutím na jeho zobrazené detaily.
    • Pomocí tlačítka, které přesměruje uživatele na konkrétní databázový záznam editačního formuláře. Tento způsob se definuje ve skriptu ovládacího prvku „Button“ pomocí funkce „SCHEDULEFORM“.
    • Pomocí nahlížecí stránky, která přesměruje uživatele do prvního záznamu daného editačního formuláře. Tento způsob se definuje přímo ve vlastnostech nahlížecí stránky.

1.2. Oprávnění ke vstupu na nahlížecí stránku

• Na nahlížecí stránku lze vstoupit z navigační oblasti se seznamem dostupných aplikací nebo oblíbených položek, a dále pomocí navigačních prvků umístěných na hlavní stránce, na jiných nahlížecích stránkách nebo v editačních formulářích.
• Každá nahlížecí stránka umožňuje nastavit uživatelské skupiny nebo konkrétní uživatele, kteří mají právo na její zobrazení. Ostatní uživatelé ji v navigační oblasti nevidí. U běžné nahlížecí stránky se právo kontroluje také při přímém otevření adresy.
• U typů „Zobrazit webovou stránku“, „Otevřít editační formulář“ a „Nová e-mailová zpráva“ se přesměrování provede dříve než kontrola práva nahlížecí stránky. Práva takové stránky proto řídí její zobrazení v navigaci, ale nejsou zabezpečením cílové stránky nebo formuláře; cíl musí mít vlastní ochranu.
• Při přímém otevření adresy se kontroluje pouze právo nahlížecí stránky. Práva aplikační skupiny, aplikace ani kategorie, ve kterých stránka leží, se při tom nekontrolují.

1.3. Oprávnění k zobrazení obsahu nahlížecí stránky

• Nahlížecí stránka zobrazí pouze ty ovládací prvky, na které má aktuálně přihlášený uživatel právo.
• Nemá-li anonymní uživatel právo na žádný ovládací prvek stránky, zobrazí se mu místo obsahu přihlašovací okno, stejně jako na hlavní stránce aplikace. Přihlášenému uživateli bez práva na stránku nebo na všechny její ovládací prvky se zobrazí prázdná stránka.
• Každý ovládací prvek nahlížecí stránky umožňuje samostatné nastavení uživatelských skupin nebo konkrétních uživatelů, kteří mají právo jej zobrazit. Ostatní uživatelé daný ovládací prvek na nahlížecí stránce nevidí.

2. Seznam záložek v dialogu nastavení nahlížecí stránky

• Obecné – Nastavení obecných vlastností
• Ostatní – Nastavení pro potřeby portletů nebo mobilních zařízení
• Nápověda – Nastavení textu nápovědy v reportech
• Práva – Nastavení práv
• Administrace – Nastavení ostatních vlastností

2.1. Záložka „Obecné“

2.1.1. Název

• Název nahlížecí stránky zobrazovaný v navigační oblasti NET Genia nebo v menu na mobilních zařízeních.
• Název nahlížecí stránky se zobrazuje v titulku záložky webového prohlížeče.

2.1.2. Slovník

• Slovník zobrazuje seznam názvů aplikačních skupin, aplikací, kategorií, nahlížecích stránek, editačních formulářů a ovládacích prvků použitých napříč celou aplikací.
• Vyhledávání ve slovníku slouží k navržení správného názvu nahlížecí stránky a k udržení konzistence názvosloví v celé aplikaci.

2.1.3. Typ

Běžná nahlížecí stránka

• Běžný typ nahlížecí stránky, která se skládá z ovládacích prvků.

Zobrazit webovou stránku

• Nahlížecí stránka bude při otevření přesměrována na konkrétní webovou stránku.

2.1.3.1. URL

• Adresa webové stránky, na kterou bude nahlížecí stránka přesměrována v uživatelském režimu.
• V adrese se před přesměrováním nahradí proměnné a vyhodnotí serverové funkce. Je-li výsledná adresa prázdná, nahlížecí stránka se nepřesměruje a zobrazí své vlastní ovládací prvky.
• V administrátorském režimu se místo přesměrování zobrazí odkaz na cílovou webovou stránku. Administrátor, který nahlížecí stránku nesmí upravovat, je přesměrován stejně jako v uživatelském režimu.

Otevřít editační formulář

• Nahlížecí stránka bude při otevření přesměrována na nový editační formulář za účelem vytvoření nového záznamu v databázi.
• Po zvolení tohoto typu doplní dialog před název nahlížecí stránky předponu „+ “; je-li název prázdný, vyplní název „+ Nový záznam“. Při změně na jiný typ se předpona odebere. Do titulku záložky webového prohlížeče se předpona nepřenáší.

2.1.3.2. Editační formulář

• Editační formulář, na který bude nahlížecí stránka přesměrována.
• Přesměrování se provede v uživatelském i v administrátorském režimu.
• Rozbalovací seznam zobrazuje seznam všech editačních formulářů umístěných ve stejné aplikaci.

2.1.3.3. Návrat na nahlížecí stránku

• Nahlížecí stránka, na kterou bude uživatel přesměrován po uložení záznamu v editačním formuláři.
• Rozbalovací seznam zobrazuje seznam všech nahlížecích stránek umístěných ve stejné aplikaci.
• Není-li nahlížecí stránka vybrána, nastaví se při uložení na tuto nahlížecí stránku samotnou. Po uložení záznamu se tak uživateli otevře znovu prázdný editační formulář pro další nový záznam.

Nová e-mailová zpráva

• Nahlížecí stránka bude při otevření přesměrována na formulář pro zadání nové e-mailové zprávy za účelem jejího následného odeslání.
• Přesměrování se provede v uživatelském i v administrátorském režimu.

2.1.3.4. Návrat na nahlížecí stránku

• Nahlížecí stránka, na kterou bude uživatel přesměrován po odeslání e-mailu.
• Rozbalovací seznam zobrazuje seznam všech nahlížecích stránek umístěných ve stejné aplikaci.
• Není-li nahlížecí stránka vybrána, nastaví se při uložení na tuto nahlížecí stránku samotnou.

2.2. Záložka „Ostatní“

2.2.1. Interval aktualizace

• Pouze pro typ nahlížecí stránky „Běžná nahlížecí stránka“
• Interval, po jehož uplynutí dojde k automatickému obnovení nahlížecí stránky.
• Dostupné hodnoty: bez aktualizace, 10 minut, 5 minut, 2 minuty, 60 vteřin.
• Obnoví se celá stránka se zachovanou pozicí posunutí a vybranou záložkou. Obnovení proběhne i tehdy, má-li uživatel otevřený dialog nebo rozepsané hodnoty v textových polích stránky.
• Interval se uplatní i v administrátorském režimu. Na portlety hlavní stránky se nevztahuje.

2.2.2. Rozlišení

• Velký displej + Malý displej
  • Nahlížecí stránka se zobrazuje na osobním počítači i na mobilním zařízení bez ohledu na to, jakou velikost displeje uživatel zvolil při přihlášení.
• Velký displej
  • Nahlížecí stránka se zobrazuje na osobním počítači a na mobilním zařízení uživatelům, kteří při přihlášení do aplikace zvolili velký displej.
• Malý displej
  • Nahlížecí stránka se zobrazuje pouze na mobilním zařízení uživatelům, kteří při přihlášení do aplikace zvolili malý displej. Na osobním počítači se nezobrazuje.
• Nastavení rozlišení filtruje zobrazení stránky v navigační oblasti, v mobilním menu, v oblíbených položkách a v nápovědě aplikace („#help#“). Nezablokuje její přímou adresu a nelze je používat jako oprávnění.
• V administrátorském režimu se nastavení rozlišení nepoužije – v navigační oblasti se zobrazují všechny nahlížecí stránky.
• U portletů se rozlišení uplatní pouze na malém displeji, kde se nezobrazí portlety ze stránek s rozlišením „Velký displej“. Anonymní uživatel velikost displeje nevolí; na mobilním zařízení se mu hlavní stránka zobrazuje jako na velkém displeji, portlety ze stránek s rozlišením „Velký displej“ se mu ale nezobrazují. Na osobním počítači se zobrazují portlety ze stránek s libovolným rozlišením.

2.2.3. Možnosti

• Pouze pro portlety
• Pouze pro typ nahlížecí stránky „Běžná nahlížecí stránka“
  • Zaškrtnutí tohoto pole určuje, zda má být nahlížecí stránka používána jako zdroj ovládacích prvků určených pro portlety na hlavní stránce, a nemá se zobrazovat v navigační oblasti NET Genia. Přímou adresu nahlížecí stránky tato volba nezablokuje.

• Skrýt portlety jsou-li prázdné
• Pouze pro typ nahlížecí stránky „Běžná nahlížecí stránka“ při zaškrtnuté volbě „Pouze pro portlety“
  • Zaškrtnutí tohoto pole určuje, zda má být portlet na hlavní stránce skryt v případě, že neobsahuje žádné záznamy k zobrazení.
  • Volba se uplatní pouze u nahlížecích tabulek a u ovládacího prvku E-mail (doručená pošta), a to v uživatelském režimu. Detailní popis portletů je uveden v samostatné příručce Portlety.

• Otevřít první záznam v databázové tabulce
• Pouze pro typ nahlížecí stránky „Otevřít editační formulář“
  • Zaškrtnutí tohoto pole určuje, zda má být otevřen záznam s nejnižší hodnotou primárního klíče „id“ v databázové tabulce zvoleného editačního formuláře. Nastavené řazení nahlížecích tabulek se nepoužije. Je-li tabulka prázdná, otevře se prázdný formulář pro nový záznam.
  • Výběr prvního záznamu nezohledňuje oprávnění ani vlastnictví záznamů. Zda smí uživatel otevřený záznam zobrazit nebo upravit, rozhodují až oprávnění editačního formuláře.

2.3. Záložka „Nápověda“

2.3.1. Nápověda

• Nápověda je text zobrazovaný v reportu „Nahlížecí stránky (Export)“. Detailní popis reportů je uveden v samostatné příručce Reporty.
• Nápověda je text zobrazovaný uvnitř celkové nápovědy aplikace v rámci serverové proměnné „#help#“. Detailní popis serverových proměnných je uveden v samostatné příručce Proměnné.

2.3.2. Poznámky

• Poznámky slouží pro zadání libovolného textu určeného pro správce aplikace.
• Do poznámek se umísťuje volání serverových funkcí, které řídí chování nahlížecí stránky:
  • DISABLEPAGETOOLS() – skryje ikony „Aktualizovat“ a „Odkaz“ v pravém horním rohu stránky
  • FULLAJAXMODE() – místo odeslání formuláře používá stránka ajaxové požadavky
  • LABELSINSIDE() – textová pole na stránce zobrazují popisek uvnitř pole
  • LAYOUT(id) – použije pro nahlížecí stránku jiný vzhled
  • MARGINS(top, right, bottom, left) – nastaví okraje nahlížecí stránky
• Z poznámek se při načtení stránky vyhodnocují pouze uvedené funkce; ostatní text poznámek včetně jiných serverových funkcí se nevyhodnocuje. Detailní popis serverových funkcí je uveden v samostatné příručce Serverové funkce.

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í běžné nahlížecí stránky a její položky v navigaci.
• U nové nahlížecí stránky se práva předvyplní podle kategorie, ve které se stránka zakládá; zakládá-li se stránka mimo kategorii, podle aplikace.
• U přesměrovacích typů nahlížecích stránek nejsou tato práva ochranou cíle, protože přesměrování proběhne před jejich kontrolou. Cílový formulář nebo webová stránka musí být zabezpečeny samostatně.

2.4.2. Zobrazit přehled

• Zobrazení přehledu nastavení práv všech podřízených ovládacích prvků.
• Odkaz „Zobrazit přehled...“ je dostupný až po prvním uložení nahlížecí stránky.

2.4.3. Možnosti

• Nahradit práva ve všech podřízených objektech – Zaškrtnutí tohoto pole určuje, zda má být při uložení nahlížecí stránky přepsáno nastavení práv ve všech podřízených ovládacích prvcích na stejná oprávnění, jako jsou nastavena v samotné nahlížecí stránce.
• Přidat zvolená práva všem podřízeným objektům – Zaškrtnutí tohoto pole určuje, zda mají být při uložení nahlížecí stránky přidány všechny zvolené uživatelské skupiny a uživatelé všem podřízeným ovládacím prvkům.
• Odebrat zvolená práva všem podřízeným objektům – Zaškrtnutí tohoto pole určuje, zda mají být při uložení nahlížecí stránky odebrány všechny zvolené uživatelské skupiny a uživatelé všem podřízeným ovládacím prvkům.
• Volby jsou dostupné až po prvním uložení nahlížecí stránky.

2.5. Záložka „Administrace“

• Záložka „Administrace“ se zobrazuje pouze u existujících nahlížecích stránek.

2.5.1. Umístění

• Výběr aplikační skupiny, aplikace a kategorie, ve kterých je nahlížecí stránka umístěna.
• Rozbalovací seznam aplikací nabízí aplikace zvolené aplikační skupiny a rozbalovací seznam kategorií kategorie zvolené aplikace. Volba „(Root)“ umístí nahlížecí stránku mimo kategorii.
• Při přesunu do jiné aplikace se nekontroluje, zda cílový editační formulář a návratová nahlížecí stránka leží v nové aplikaci. Po přesunu je proto vhodné tato nastavení zkontrolovat.

2.6. Logování

• Pomocí tlačítka „Logování“ se zobrazí detailní report se záznamy o zobrazení nahlížecí stránky. Report obsahuje informace o:
  • datu a času zobrazení nahlížecí stránky,
  • uživateli, který nahlížecí stránku zobrazil,
  • době zpracování nahlížecí stránky,
  • datu a času zahájení zpracování,
  • datu a času dokončení zpracování,
  • velikosti výsledného HTML kódu vygenerované nahlížecí stránky,
  • informaci, zda se jedná o první načtení stránky, nebo o její aktualizaci (postback).

• Pro správné fungování logování je nutné mít v nastavení NET Genia na záložce „Ostatní“ aktivováno logování buď „Do databáze“, nebo „Do databáze a na disk“. Detailní popis je uveden v samostatné příručce Nastavení NET Genia.
• Minimální zobrazovaný čas zpracování nahlížecí stránky je ve výchozím nastavení stanoven na 0 milisekund, zobrazují se tedy všechny záznamy zobrazení nahlížecích stránek včetně těch, jejichž zpracování trvalo 0 milisekund. Tento minimální čas je možné zvýšit nebo snížit změnou parametru „mintime“ v URL reportu.
• Počet záznamů je ve výchozím nastavení omezen na 100 záznamů. Tento počet je možné ručně zvýšit nebo snížit změnou parametru „maxrows“ v URL reportu.
• Záznam se nezapíše u požadavků, které nahlížecí stránka ukončí dříve než vykreslením celé stránky – typicky u přesměrování a u aktualizace jednotlivého ovládacího prvku.

2.7. Tlačítka „Uložit“, „Smazat“ a „Zavřít“

• Tlačítko „Uložit“ – Uložení změn v nastavení nahlížecí stránky.
• Tlačítko „Smazat“ – Trvalé odstranění nahlížecí stránky. Smaže se nahlížecí stránka se všemi svými ovládacími prvky, jejich databázovými dotazy a skripty, práva, oblíbené položky a portlety, které na stránku odkazují, a uživatelská nastavení stránky a jejích ovládacích prvků. Soubory tiskových šablon se nemažou. Odkazy na smazanou stránku v jiných ovládacích prvcích, v nastavení „Návrat na nahlížecí stránku“ ani ve skriptech (SCHEDULEVIEWPAGE) se neodstraní. Systémovou nahlížecí stránku smazat nelze.
• Tlačítko „Zavřít“ – Zavření dialogu s nastavením nahlížecí stránky bez uložení změn.

3. Chování nahlížecí stránky

3.1. Rozvržení ovládacích prvků

• Ovládací prvky se zobrazují pod sebou v pořadí, ve kterém jsou na nahlížecí stránce umístěny. Vedle sebe se v uživatelském režimu řadí pouze tlačítka, která následují bezprostředně za sebou.
• Ovládací prvek „Záložka“ rozděluje stránku do záložek. Obsah nevybrané záložky se načte až po jejím výběru u nahlížecích tabulek, grafů, stromových struktur, historie změn, e-mailu a ovládacího prvku DataSet. Kalendář, plánovač, rozvrh hodin, kanban a mapa se načítají vždy, i když leží na nevybrané záložce.
• Pozice posunutí stránky a vybraná záložka se ukládají pro každého přihlášeného uživatele zvlášť a obnoví se při dalším otevření stránky. Anonymnímu uživateli se neukládají.
• Titulek záložky webového prohlížeče se skládá z názvu aplikace, názvu kategorie a názvu nahlížecí stránky.

3.2. Ikony v pravém horním rohu

• V pravém horním rohu nahlížecí stránky jsou ikony „Aktualizovat“ a „Zkopírovat do schránky odkaz pro sdílení této stránky“. Na mobilním zařízení a anonymnímu uživateli se nezobrazují.
• Ikona odkazu se navíc nezobrazuje externím uživatelům (členům skupiny „External Users“) v uživatelském režimu mimo NET Genium Online. V instalaci, která má současně konfigurační soubor „DenyLogin.txt“ a v souboru „XFrameOptions.txt“ hodnotu „*“, se ikona odkazu nezobrazuje nikomu.
• Ikony skryje serverová funkce DISABLEPAGETOOLS() v poznámkách nahlížecí stránky.
• Obsahuje-li ovládací prvek HTML nebo JavaScript proměnnou „#help#“, zobrazí se na stránce navíc plovoucí ikony pro návrat na začátek stránky a pro tisk. Na mobilním zařízení se nezobrazují.

3.3. Navigace

• V navigační oblasti se nahlížecí stránky řadí podle pořadí a názvu; nejprve se zobrazují kategorie, potom nahlížecí stránky bez kategorie. Kliknutím na kategorii se otevře její první nahlížecí stránka.
• Po výběru aplikační skupiny, která nemá obrázek na pozadí (nebo má uživatel vypnutou volbu „Obrázek na pozadí“) ani portlety, se v uživatelském režimu otevře první nahlížecí stránka první aplikace; přednost mají nahlížecí stránky bez kategorie.
• V mobilním menu se aplikace nebo kategorie s jedinou nahlížecí stránkou zobrazí jako jediný odkaz s názvem aplikace, respektive kategorie.
• Přejmenováním nahlížecí stránky se přepíše název oblíbené položky všem uživatelům, kteří mají stránku v oblíbených položkách.
• Nahlížecí stránku lze přidat do oblíbených položek pouze tehdy, má-li k ní uživatel oprávnění.

3.4. Chyby a externí funkce

• Chyba databázového dotazu se zobrazí pouze v ovládacím prvku, který dotaz používá; ostatní ovládací prvky se zobrazí normálně.
• Chyba serverové nebo externí funkce vyhodnocované v ovládacím prvku HTML nebo JavaScript ukončí načítání celé stránky.
• Začíná-li vyhodnocený obsah ovládacího prvku HTML řetězcem „<!DOCTYPE“, „<html“ nebo „<HTML“, nahradí v uživatelském režimu celou nahlížecí stránku. Porovnání rozlišuje velká a malá písmena a úvodní mezery se neořezávají – zápis „<!doctype html>“ ani obsah začínající mezerou nebo prázdným řádkem se nerozpozná.
• Při každém požadavku na nahlížecí stránku se spustí externí funkce NETGenium.OpenViewPage, a to ještě před přesměrováním a před kontrolou oprávnění. Detailní popis je uveden v samostatné příručce Externí funkce.

3.5. Kopírování nahlížecí stránky

• Kopii nahlížecí stránky vytvoří ikona „Kopírovat nahlížecí stránku“ v navigační oblasti administrátorského režimu. Kopie vznikne ve stejné aplikaci a kategorii s názvem doplněným o „ - Kopie“ a zařadí se na konec.
• Zkopírují se všechny ovládací prvky včetně databázových dotazů, skriptů a práv. Soubor tiskové šablony se nekopíruje – kopie a originál používají tentýž soubor.
• Systémovou nahlížecí stránku zkopírovat nelze.