1. Základní informace
1.1. Popis ovládacího prvku
JavaScript je ovládací prvek, který umožňuje začlenění libovolného javascriptového kódu do těla nahlížecí stránky. Javascriptový kód bude automaticky spuštěn při načtení nahlížecí stránky, a je možné ho ladit přímo ve webovém prohlížeči v konzoli javascriptu (např. v prohlížeči Google Chrome je konzole pro ladění javascriptu zobrazena pomocí klávesové zkratky „CTRL+Shift+J“).
- Kód se spouští v okamžiku, kdy prohlížeč načte příslušné místo stránky – tedy dřív, než existují ovládací prvky umístěné níže. Po ajaxové aktualizaci nahlížecí stránky se znovu nespouští. V režimu FULLAJAXMODE() se naopak spouští až po načtení celé stránky a znovu po každé ajaxové aktualizaci; hodnoty dosazené serverem přitom zůstávají z prvního načtení.
- Volání externí funkce stránkou „ngef.aspx“ je povolené jen tehdy, je-li text „ngef.aspx?Identifikátor“ zapsaný v kódu doslovně v uvozovkách. Detailní popis je uveden v samostatné příručce Externí funkce.
- Proměnné a funkce použité v kódu vyhodnocuje server a jejich hodnoty se vkládají bez escapování – podrobnosti jsou uvedeny v samostatné příručce JavaScriptové funkce.
1.2. Vytvoření nového ovládacího prvku
Nový javascript 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ý javascript 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 „JavaScript“, 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 javascriptu na předem vybrané místo nahlížecí stránky.
- Nedojde-li před vložením nového javascriptu k určení požadované pozice, bude nový javascript 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í
- Nápověda – Nápověda k editoru javascriptového kódu
- 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.
- Rozbalovací seznam nabízí název „display()“. Je-li kód ovládacího prvku prázdný, vloží jeho výběr do kódu šablonu funkce „display()“.
2.1.2. Proměnné a funkce
- Rozbalovací seznam s výběrem proměnných, javascriptových a serverových funkcí, které je možné používat uvnitř javascriptového kódu.
- Detailní popis proměnných je uveden v samostatné příručce Proměnné.
- Detailní popis javascriptových funkcí je uveden v samostatné příručce JavaScriptové funkce.
- Detailní popis serverových funkcí je uveden v samostatné příručce Serverové funkce.
2.2. Záložka „Nápověda“
- Přehled klávesových zkratek editoru javascriptového kódu. Záložka se zobrazuje jen při zapnutém editoru kódu.
2.3. Záložka „Práva“
2.3.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.3.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.4. Záložka „Administrace“
- Záložka „Administrace“ se zobrazuje pouze u existujících ovládacích prvků.
2.4.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.4.2. Slovník
- Slovník zobrazuje seznam volání javascriptových funkcí „alert“ a „confirm“ a serverové funkce „COLORLEGEND“, použitých napříč celou instalací NET Genia.
- Vyhledávání ve slovníku slouží k navržení správného tvaru uživatelských hlášek a k udržení konzistence názvosloví v celé aplikaci.
2.4.3. Sledování změn
- Sledování změn zobrazuje detailní report se všemi provedenými změnami javascriptového kódu jednotlivými uživateli.
2.4.4. Porovnat
- Tlačítko „Porovnat“ slouží k porovnání javascriptového kódu na záložce „Obecné“ s jinou verzí kódu, kterou administrátor vloží do textového pole na záložce „Administrace“.
- Po stisknutí tlačítka se zobrazí porovnávací tabulka se dvěma sloupci:
- Obecné – hodnoty zobrazené na záložce „Obecné“,
- Administrace – odpovídající hodnoty ze záložky „Administrace“.
- Pokud se hodnoty ve stejné položce liší, systém rozdíl zvýrazní červeným textem.
- Slovní shrnutí neshod (např. „Obecné nerovná se Administrace“) se zobrazí v dialogu.
2.4.5. Reference
- Tlačítko „Reference“ slouží k zobrazení obsahu JavaScriptu ze záložky „Obecné“, ve kterém jsou nahrazeny všechny výskyty „el(BT123)“, „bt_Click(BT123)“, „button_Enable(BT123)“ a „button_Disable(BT123)“ za příslušné odkazy, pomocí kterých je možné rychle otevřít nastavení tlačítka, které je v těchto čtyřech javascriptových funkcích referencováno.
2.5. Tlačítka „Uložit“, „Uložit a pokračovat v editaci“, „Kopírovat“, „Smazat“ a „Zavřít“
- Tlačítko „Uložit“ – Uložení změn v nastavení ovládacího prvku.
- Tlačítko „Uložit a pokračovat v editaci“ – Uložení změn v nastavení ovládacího prvku a ponechání nastavení otevřeného pro další úpravy.
- Tlačítko „Kopírovat“ – Vytvoření nové kopie aktuálního ovládacího prvku se shodným nastavením, avšak s novým jedinečným identifikátorem.
- 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.