Portlety

1. Základní informace

• Portlety jsou zjednodušené vizuální ovládací prvky zobrazované na hlavní stránce portálu (dashboard). Slouží k rychlému a přehlednému zobrazení vybraných informací na jedné obrazovce.
• Portlety nepředstavují samostatný datový objekt, ale zjednodušenou vizualizaci dat a funkcí, které jsou v aplikaci dostupné prostřednictvím jiných stavebních prvků.
• V portletech se zobrazují zjednodušené varianty vybraných ovládacích prvků používaných na nahlížecích stránkách, například formátovaný text, nahlížecí tabulky nebo grafy.
• Portlety jsou určeny především pro orientační přehled a rychlou informaci. Nenahrazují plnohodnotnou práci s daty na nahlížecích stránkách ani detailní editaci záznamů v editačních formulářích.
• Portlety se zobrazují pouze na hlavní stránce první aplikační skupiny, ke které má přihlášený uživatel oprávnění. Hlavní stránka ostatních aplikačních skupin zobrazuje pouze obrázek na pozadí nastavený ve vlastnostech aplikační skupiny; nemá-li aplikační skupina obrázek nebo má-li uživatel vypnutou volbu „Obrázek na pozadí“, otevře se v uživatelském režimu rovnou první nahlížecí stránka.
• Portlety je možné zobrazovat v jednom, ve dvou nebo ve třech sloupcích. Každý přihlášený uživatel NET Genia má možnost si rozložení portletů přizpůsobit podle svého uvážení.
• Nahlížecí tabulky nebo grafy zobrazované v portletech by měly respektovat omezenou šířku obrazovky, zejména s ohledem na možnost uspořádat portlety až do tří sloupců.
• Výchozí rozložení portletů pro přihlášené uživatele definuje uživatel „Administrator“ s databázovým ID 1 – jeho rozložení se kopíruje uživatelům bez vlastního nastavení, včetně uživatelů s administrátorským oprávněním. Rozložení anonymního uživatele se z něj nekopíruje; je to samostatné rozložení anonymního uživatele.
• Běžný uživatel, který se přihlásí do NET Genia a nemá vlastní nastavení portletů, automaticky přebírá výchozí nastavení portletů od uživatele „Administrator“, případně pouze těch portletů, ke kterým má oprávnění. Portlety si může dále přizpůsobit zcela samostatně.
• Anonymní uživatelé nemají oprávnění k úpravě rozložení portletů. Rozložení portletů anonymního uživatele nastavují uživatelé s administrátorským oprávněním v administrátorském režimu.
• Uživatelé zařazení do skupiny „External Users“ si rozložení portletů přizpůsobují stejně jako běžní uživatelé.

2. Seznam záložek v dialogu nastavení portletů

• Sloupec 1 – Nastavení ovládacích prvků v prvním sloupci
• Sloupec 2 – Nastavení ovládacích prvků ve druhém sloupci
• Sloupec 3 – Nastavení ovládacích prvků ve třetím sloupci
• Možnosti – Nastavení intervalu aktualizace a obrázku na pozadí
• Uložit více uživatelům – Nastavení portletů více uživatelům; záložka se zobrazuje pouze uživatelům s administrátorským oprávněním

2.1. Záložka „Sloupec 1“

• Výběr ovládacích prvků, které budou zobrazeny na hlavní stránce pod sebou v prvním sloupci.
• Seznam nabízí pouze ovládací prvky, na které má uživatel oprávnění spolu s oprávněním k jejich nahlížecí stránce, kategorii a aplikační skupině, a pouze ty typy ovládacích prvků, které lze umístit do portletů. Ovládací prvky se zaškrtnutou volbou „Pouze pro portlety“ a nahlížecí stránky určené pouze pro portlety jsou v seznamu zvýrazněny tučně.
• Při nastavování portletů anonymního uživatele a při použití tlačítka „Uložit více uživatelům“ se seznam řídí oprávněními přihlášeného administrátora. Portlety, ke kterým cílový uživatel oprávnění nemá, se mu po uložení odeberou.
• Tentýž ovládací prvek lze umístit do více sloupců; v rámci jednoho sloupce se zobrazí pouze jednou.
• Tlačítko „Přejmenovat“ změní název portletu zobrazovaný na hlavní stránce. Na mobilním zařízení se tlačítko nezobrazuje.

2.1.1. Statistika

• Pomocí tlačítka „Statistika“ se zobrazí detailní report se všemi vybranými ovládacími prvky, které jsou zvoleny v portletech ve všech třech sloupcích, včetně možnosti otevření nastavení takového ovládacího prvku.
• Tlačítko se zobrazuje pouze uživatelům s administrátorským oprávněním.

2.2. Záložka „Sloupec 2“

• Výběr ovládacích prvků, které budou zobrazeny na hlavní stránce pod sebou ve druhém sloupci.
• Na mobilním zařízení s malým displejem se ovládací prvky na hlavní stránce zobrazují pouze v jednom sloupci – nejprve ovládací prvky prvního sloupce, pod nimi druhého a nakonec třetího sloupce.

2.2.1. Statistika

• Pomocí tlačítka „Statistika“ se zobrazí detailní report se všemi vybranými ovládacími prvky, které jsou zvoleny v portletech ve všech třech sloupcích, včetně možnosti otevření nastavení takového ovládacího prvku.

2.3. Záložka „Sloupec 3“

• Výběr ovládacích prvků, které budou zobrazeny na hlavní stránce pod sebou ve třetím sloupci.
• Na mobilním zařízení s malým displejem se ovládací prvky na hlavní stránce zobrazují pouze v jednom sloupci – nejprve ovládací prvky prvního sloupce, pod nimi druhého a nakonec třetího sloupce.

2.3.1. Statistika

• Pomocí tlačítka „Statistika“ se zobrazí detailní report se všemi vybranými ovládacími prvky, které jsou zvoleny v portletech ve všech třech sloupcích, včetně možnosti otevření nastavení takového ovládacího prvku.

2.4. Záložka „Možnosti“

2.4.1. Interval aktualizace

• Interval, po jehož uplynutí dojde k automatické aktualizaci celé hlavní stránky. Dostupné hodnoty: bez aktualizace, 60 vteřin, 2 minuty, 5 minut, 10 minut.
• Interval platí na osobním počítači i na mobilním zařízení.
• Uživatelům s administrátorským oprávněním se automaticky neaktualizuje hlavní stránka první aplikační skupiny, protože obsahuje karty pro vytváření aplikací a přepínání režimů, a v administrátorském režimu ani hlavní stránka ostatních aplikačních skupin.
• Interval aktualizace nastavený u nahlížecí stránky se na portlety nevztahuje.

2.4.2. Možnosti

• Obrázek na pozadí
  • Zaškrtnutí toho pole určuje, zda má být na hlavní stránce zobrazený obrázek nastavený ve vlastnostech aplikační skupiny. Volba platí pro hlavní stránku všech aplikačních skupin, nejen první.

2.5. Záložka „Uložit více uživatelům“

2.5.1. Uložit více uživatelům

• Výběr uživatelských skupin a uživatelů, kterým tlačítko „Uložit více uživatelům“ přepíše, doplní nebo odebere portlety podle volby níže. Zdrojem je nastavení zobrazené v dialogu – portlety vybrané ve všech třech sloupcích včetně dosud neuložených změn. V dialogu otevřeném pro anonymního uživatele je zdrojem rozložení anonymního uživatele.
• Vybraným uživatelům se ve všech třech režimech přepíše také interval aktualizace a volba obrázku na pozadí.

2.5.2. Možnosti

• Přepsat portlety všem zvoleným uživatelům – Vybrané portlety budou přepsány všem zvoleným uživatelům
• Přidat portlety všem zvoleným uživatelům – Vybrané portlety budou přidány na konec všem zvoleným uživatelům
• Odebrat portlety všem zvoleným uživatelům – Vybrané portlety budou odebrány všem zvoleným uživatelům; odebere se pouze portlet umístěný u uživatele ve stejném sloupci

2.6. Tlačítko „Uložit“

• Tlačítko „Uložit“ – Uložení změn a nastavení portletu.

3. Ovládací prvky, které lze umístit do portletů

• Do portletů lze umístit tyto ovládací prvky nahlížecích stránek:
  • Nahlížecí tabulka – řádkový výpis i agregační (statistický) dotaz
  • Graf
  • E-mail – doručená pošta
  • Novinky
  • Formátovaný text – pouze se zaškrtnutou volbou „Pouze pro portlety“
  • HTML – pouze se zaškrtnutou volbou „Pouze pro portlety“
• Ostatní ovládací prvky (kalendář, plánovač, strom, mapa, tlačítko a další) do portletů umístit nelze.
• Formátovaný text a HTML se zaškrtnutou volbou „Pouze pro portlety“ se na nahlížecí stránce v uživatelském režimu nezobrazují; v administrátorském režimu se na nahlížecí stránce zobrazují s označením „Portlety“ za názvem ovládacího prvku.
• Nahlížecí stránka se zaškrtnutou volbou „Pouze pro portlety“ slouží jako zdroj ovládacích prvků pro portlety a nezobrazuje se v navigační oblasti ani v oblíbených položkách. Detailní popis je uveden v samostatné příručce Nahlížecí stránka.

4. Nahlížecí tabulka v portletu

• Nahlížecí tabulka v portletu je zjednodušená varianta nahlížecí tabulky z nahlížecí stránky:
  • Nezobrazuje hledání, filtry sloupců, mřížku ani panel detailů.
  • Nepoužije časový úsek nastavený v databázovém dotazu („Časový úsek podle“) ani filtry agregačního dotazu – zobrazí všechny záznamy, které vyhovují podmínkám dotazu.
  • Výchozí počet záznamů na stránce je 10.
  • Z nastavení ovládacího prvku přebírá povolení nových záznamů, zákaz otevírání záznamů a hromadné změny; u agregačního dotazu kontingenční tabulku, součty sloupců a vyplnění časových mezer.
  • V titulku zobrazuje pouze ikony pro nový záznam, aktualizaci, nastavení portletu, výchozí třídění a skrytí portletu. Export, import ani tisk v portletu dostupné nejsou.
• Kliknutím na záhlaví sloupce se záznamy setřídí.
• Záznam se otevře dvojklikem na řádek nebo ikonou v prvním sloupci; na mobilním zařízení kliknutím na řádek. Tlačítko „Zpět“ v editačním formuláři vrací uživatele na hlavní stránku.
• Portlet načte z databáze všechny záznamy až do počtu nastaveného v databázovém dotazu („Načíst pouze prvních“) a stránkuje je až poté. U velkých tabulek je proto vhodné počet načítaných záznamů v dotazu omezit.
• Bublinová nápověda řádků se v portletu vypočítává při zobrazení pro každý řádek stránky; na mobilním zařízení se nezobrazuje.
• Obsahuje-li dotaz chybu, zobrazí se chybové hlášení pouze v daném portletu a ostatní portlety se zobrazí normálně.

4.1. Nastavení nahlížecí tabulky v portletu

• Ikona nastavení v titulku portletu otevře dialog, ve kterém si uživatel nastaví třídění, počet záznamů na stránce, zobrazované sloupce a sloupce bublinové nápovědy. U agregačního dotazu lze nastavit pouze počet záznamů na stránce.
• Nastavení sloupců portletu je samostatné – nezávisí na nastavení sloupců téže nahlížecí tabulky na nahlížecí stránce.
• Při prvním zobrazení portletu se uživateli uloží výchozí sloupce databázového dotazu. Pozdější změna výchozích sloupců dotazu se proto u uživatele, který portlet již zobrazil, neprojeví, dokud se jeho nastavení neobnoví na výchozí.
• Nastavení se ukládá k databázovému dotazu. Zobrazuje-li uživatel stejnou nahlížecí tabulku ve více portletech, sdílejí tyto portlety stránkování, třídění i skrytí.
• Nabídku sloupců omezují serverové funkce GRIDCOLUMNS() a DETAILCOLUMNS() v poznámkách databázového dotazu. Je-li u nahlížecí tabulky zakázáno uživatelské přizpůsobení, sloupce mohou měnit pouze uživatelé s administrátorským oprávněním.
• Uživatelům s administrátorským oprávněním nabízí dialog navíc 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 nastavení portletu podle dialogu – třídění, počet záznamů na stránce, zobrazované sloupce a volbu „Zobrazit tooltip“. U agregačního dotazu se přepíše pouze počet záznamů na stránce.

4.2. Skrytí prázdného portletu

• Volba „Skrýt portlety jsou-li prázdné“ u nahlížecí stránky skryje v uživatelském režimu nahlížecí tabulku, která neobsahuje žádné záznamy, a stejně tak prázdnou doručenou poštu (ovládací prvek E-mail). Graf, formátovaný text, HTML ani novinky se neskrývají.

5. Formátovaný text a HTML v portletu

• Formátovaný text a HTML se v portletu vyhodnocují stejně jako na nahlížecí stránce – nahradí se proměnné a vyhodnotí serverové funkce. Proměnná „#viewpage#“ vrací ID nahlížecí stránky, na které ovládací prvek leží.
• Formátovaný text s definicí textu „Z dotazu“ zobrazí hodnotu prvního sloupce prvního záznamu databázového dotazu.
• Formátovaný text s vyplněnou vlastností „Jazyk“ se v uživatelském režimu zobrazí pouze uživatelům s tímto jazykem; v administrátorském režimu se zobrazí bez ohledu na jazyk.
• Obsah začínající řetězcem „OK“ a zalomením řádku (například návratová hodnota externí funkce ve tvaru OK\r\nhtml) se vypíše bez rámečku portletu, bez titulku a bez ikon. Je-li zbytek obsahu prázdný, portlet se nezobrazí vůbec.
• Obsah tvořený pouze proměnnou „#usersonline#“ zobrazí seznam právě přihlášených uživatelů.
• Hlavní stránka s portlety přihlášeného uživatele neobsahuje formulář, takže stisk klávesy Enter v textovém poli uvnitř portletu nic neodešle. Textová pole vložená do HTML portletu musí případné odeslání obsloužit vlastním JavaScriptem. Hlavní stránka anonymního uživatele s přihlašovacím oknem formulář obsahuje, takže Enter v textovém poli HTML portletu ho odeslat může.

6. Graf, e-mail a novinky v portletu

• Graf – titulek portletu se vyhodnocuje jako výraz se serverovými funkcemi; prázdný titulek se nahradí textem „Graf“.
• E-mail – portlet má vždy titulek „Doručená pošta“ bez ohledu na název portletu a umožňuje napsat novou zprávu i otevřít přijatou zprávu. Ikona nastavení v titulku portletu otevře dialog, ve kterém si uživatel nastaví třídění (podle odesílatele, předmětu, data nebo velikosti), počet záznamů na stránce a volbu „Zobrazit tooltip“. Uživatelům s administrátorským oprávněním nabízí dialog i záložku „Uložit více uživatelům“, jejímž tlačítkem se toto nastavení přepíše vybraným uživatelským skupinám a uživatelům.
• Novinky – portlet zobrazuje posouvající se text z RSS zdroje zadaného adresou nebo cestou k souboru na serveru. Zdroj se načítá s časovým limitem 1 vteřina a uchovává se v mezipaměti jednu hodinu; při chybě se zobrazí text „Stránku nelze zobrazit“ a zdroj se znovu načte nejdříve za pět minut.

7. Rozvržení sloupců

• Poměr šířek sloupců se nastavuje ve vlastnostech aplikační skupiny na záložce „Portlety“; záložka se nabízí pouze u aplikační skupiny s databázovým ID 1. Detailní popis je uveden v samostatné příručce Aplikační skupina.
• Neobsahuje-li třetí sloupec žádný zobrazený portlet, třetí sloupec se nevykreslí a první dva sloupce zaberou celou šířku hlavní stránky.
• Anonymnímu uživateli se ve třetím sloupci zobrazuje přihlašovací okno. Existuje-li v adresáři „Config“ soubor „DenyLogin.txt“, přihlašovací okno se zobrazí jen při přístupu z IP adresy „127.0.0.1“. Detailní popis je uveden v samostatné příručce Nastavení NET Genia.
• Ikona „Skrýt“ v titulku portletu sbalí portlet do odkazu „Zobrazit...“ a jeho obsah se přestane načítat, dokud ho uživatel znovu nezobrazí. Anonymní uživatel tuto ikonu nemá.
• Nemá-li uživatel na první aplikační skupině žádný portlet a aplikační skupina nemá obrázek na pozadí nebo má uživatel vypnutou volbu „Obrázek na pozadí“, otevře se v uživatelském režimu místo hlavní stránky první nahlížecí stránka; nahlížecí stránky určené pouze pro portlety se přeskočí. Anonymního uživatele se toto přesměrování netýká.

8. Mobilní zařízení

• Na malém displeji se portlety zobrazují v jednom sloupci pod sebou – nejprve portlety prvního sloupce, pod nimi druhého a nakonec třetího sloupce. Ovládací prvek umístěný ve více sloupcích se zobrazí pouze jednou.
• Na malém displeji se nezobrazují portlety z nahlížecích stránek, jejichž rozlišení je nastaveno na „Velký displej“. Anonymní uživatel velikost displeje nevolí, protože ji volí až přihlášení; 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 rozlišení nahlížecí stránky u portletů nepoužívá – zobrazí se i portlety ze stránek určených pouze pro malý displej.
• Nahlížecí tabulka na malém displeji spojí hodnoty sloupců do jednoho sloupce oddělené čárkou.
• Ikona aktualizace v titulku portletu na mobilním zařízení znovu načte celou hlavní stránku.
• Na velkém displeji se portlety zobrazují identicky jako na osobním počítači.
• Na mobilním zařízení v uživatelském režimu není možné měnit nastavení portletů.

9. Oprávnění

• O zobrazení portletu rozhoduje pouze oprávnění k ovládacímu prvku, který portlet zobrazuje. Oprávnění k nahlížecí stránce, aplikaci ani aplikační skupině se u portletu nekontroluje – jejich odebráním se portlet neskryje.
• Uživatelům s administrátorským oprávněním se zobrazují všechny portlety jejich rozložení bez kontroly oprávnění.
• Při změně oprávnění ovládacího prvku se portlet automaticky odebere všem uživatelům, kteří k ovládacímu prvku oprávnění ztratili. Stejně se odeberou sloupce nahlížecí tabulky v portletu, ke kterým uživatel ztratil oprávnění.

10. Výchozí nastavení a jeho obnovení

• Výchozí rozložení portletů se uživateli zkopíruje od uživatele „Administrator“ při přihlášení, pokud uživatel nemá žádný portlet. Interval aktualizace ani volba obrázku na pozadí se nekopírují.
• Odebere-li uživatel všechny své portlety, při příštím přihlášení dostane znovu výchozí rozložení.
• Smazáním ovládacího prvku nahlížecí stránky se odpovídající portlet odebere všem uživatelům.
• Přejmenováním ovládacího prvku v jeho nastavení se přepíše název portletu všem uživatelům, kteří tento ovládací prvek mají v portletech.

11. Automatické akce při otevření hlavní stránky

• Při každém načtení nebo aktualizaci hlavní stránky první aplikační skupiny se spustí externí funkce NETGenium.OpenPortlets. Detailní popis je uveden v samostatné příručce Externí funkce.
• Serverová funkce SCHEDULEPORTLETS() přesměruje uživatele po dokončení skriptu na hlavní stránku. Detailní popis je uveden v samostatné příručce Serverové funkce.