1. Základní informace
1.1. Popis ovládacího prvku
File je ovládací prvek určený k vložení souborové přílohy pomocí tlačítka „Procházet...“. Maximální velikost vkládané souborové přílohy může být omezena na předem stanovenou velikost. File používá databázový typ „int“, a do databáze ukládá ID souborové přílohy, která je fyzicky uložena na disku v adresáři „Files“, a popisné údaje s názvem souboru a jeho velikostí má uložené v samostatném záznamu v databázové tabulce „sfiles“.
Prvek File vkládá vždy jen jednu souborovou přílohu. Pro nahrání více souborů najednou, resp. výběr a nahrání více souborových příloh současně v editačním formuláři (hromadný upload přetažením nebo jedním tlačítkem) slouží serverové funkce DROPZONE (oblast pro přetažení souborů) a UPLOADBUTTON (tlačítko pro výběr souborů), které jsou popsány v samostatné příručce Serverové funkce.
Tlačítko „...“ vedle ovládacího prvku nabízí další možnosti. Zobrazuje se jen tehdy, nabízí-li alespoň jednu z nich, a nikdy v editačním formuláři, který nelze upravovat:
- Vložit... – jen na mobilním zařízení; stáhne soubor z adresy URL vložené ze schránky a uloží ho jako souborovou přílohu.
- Procházet Cloud – nabídne soubory z adresáře záznamu ve veřejném adresáři. Zobrazuje se jen tehdy, je-li veřejný adresář nastavený (konfigurační soubor „PublicDirectory.txt“ v adresáři „Config“), nikdy v NET Genium Online a nikdy anonymnímu uživateli.
- Nový ze šablony – vytvoří novou souborovou přílohu z tiskové šablony vybrané na záložce „Šablony“.
- Přejmenovat – přejmenuje vloženou souborovou přílohu. Nezobrazuje se anonymnímu uživateli ani při zaškrtnuté možnosti „Skrýt tlačítko ‚Přejmenovat‘“.
Po nahrání souboru se editační formulář vždy aktualizuje.
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.
- Smazání file má za následek nevratné smazání databázového sloupce spojeného s tímto file v databázi, a tudíž i ke smazání jeho hodnot ve všech záznamech databázové tabulky. Soubory příloh zůstanou na disku v adresáři „Files“ i se záznamy v tabulce „sfiles“, ale žádný záznam na ně už neodkazuje.
2. Seznam záložek v dialogu nastavení ovládacího prvku
- Obecné – Nastavení obecných vlastností
- Šablony – Nastavení šablon
- Tisk do šablony – Nastavení tisku do šablony
- Tlačítko – Nastavení tlačítka, které může být zobrazováno napravo vedle ovládacího prvku
- Nápověda – Nastavení textu nápovědy, který může být zobrazován v pravé části editačního formuláře
- Filtr – Nastavení filtru, který může být zobrazován v nahlížecí tabulce v záhlaví sloupce
- 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 editačním formuláři v samostatném sloupci s barevným pozadím nalevo vedle samotného ovládacího prvku.
2.1.2. Zkrácený název
- Volitelný název ovládacího prvku zobrazovaný v záhlaví nahlížecí tabulky, pokud je ovládací prvek zvolen jako jeden ze sloupců nahlížecí tabulky.
- Je-li zkrácený název uveden, zobrazuje se celý název ovládacího prvku v tooltipu nad zkráceným názvem.
- Není-li zkrácený název uveden, zobrazuje se v záhlaví nahlížecí tabulky celý název ovládacího prvku.
- Pomocí zkráceného názvu „ “ (pevná mezera) lze úplně skrýt název ovládacího prvku zobrazovaný v nahlížecí tabulce.
2.1.3. 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.4. Maximální velikost
- Maximální velikost nahrávaného souboru v MB. Pole přijímá hodnoty 0–1024.
- Soubor větší než nastavená maximální velikost se po výběru tlačítkem „Procházet...“ nenahraje a zobrazí se upozornění.
- Prázdná hodnota nebo 0 znamená limit pro upload nastavený na serveru, ve výchozím stavu 50 MB; navýšit ho lze konfiguračním souborem „MaxRequestLength.txt“, jehož detailní popis je uveden v samostatné příručce Nastavení NET Genia. Pro vložení položkou „Vložit...“ platí v takovém případě limit 10 MB.
2.1.5. Možnosti
- Vyžadované pole
- Zaškrtnutí vyžadovaného pole určuje, zda má být v editačním formuláři vyžadováno vložení souborové přílohy před uložením záznamu do databáze.
- Nastavení vyžadovaného pole nemá vliv na databázový typ sloupce, který je přidružen k aktuálnímu ovládacímu prvku v databázi. Všechny databázové sloupce jsou nastaveny tak, že akceptují i databázovou hodnotu „null“.
- Hodnota může být v databázi uložena jako celé číslo nebo jako databázová hodnota „null“. Při sestavování podmínek databázového dotazu je tedy důležité počítat i s alternativou, že je ve sloupci v databázové tabulce uložena kromě nuly – celého čísla – také databázová hodnota „null“. Taková podmínka může vypadat v řeči NG následovně: file rovná se „0“ nebo file není definováno. A nyní v jazyce SQL: ng_soubor = 0 OR ng_soubor IS NULL.
- Skrýt tlačítko „Odstranit“
- Zaškrtnutí tohoto pole určuje, zda má být skryté tlačítko „Odstranit“, které slouží k vymazání stávající souborové přílohy uložené v ovládacím prvku. I při skrytém tlačítku „Odstranit“ je možné nahrát jinou souborovou přílohu pomocí tlačítka „Procházet...“.
- Skrýt tlačítko „Přejmenovat“
- Zaškrtnutí tohoto pole určuje, zda má být v nabídce tlačítka „...“ skrytá položka „Přejmenovat“, která slouží k přejmenování stávající souborové přílohy uložené v ovládacím prvku.
- Skryté pole
- Nastavení skrytého pole určuje, zda má být ovládací prvek součástí editačního formuláře, avšak v uživatelském režimu nemá být viditelný.
- Skrytý ovládací prvek včetně vyplněné hodnoty je možné dohledat ve zdrojovém kódu webové stránky. Nelze ho tedy používat jako součást bezpečnostních opatření, k tomu se používají práva na ovládací prvek.
2.2. Záložka „Šablony“
2.2.1. Šablony
- Šablony definují seznam tiskových šablon z adresáře „NETGenium\Templates“, ze kterých je možné vytvořit novou souborovou přílohu přímo z ovládacího prvku položkou „Nový ze šablony“ v nabídce tlačítka „...“.
- Položka „Nový ze šablony“ nabízí jen vybrané šablony, které v adresáři „Templates“ skutečně existují. Dokument lze vytvořit jen v editačním formuláři, který lze upravovat.
- Tiskové šablony musí být uloženy v adresáři „NETGenium\Templates“. Do tohoto adresáře je možné soubory nakopírovat napřímo z plochy serveru, nebo prostřednictvím dialogu pro nastavení NET Genia na záložce „Tiskové šablony“.
- V tiskových šablonách dojde k automatickému nahrazení všech proměnných v editačního formuláře stejně jako je tomu u běžného tisku pomocí tlačítka. Detailní popis šablon je uveden v samostatné příručce Tiskové šablony.
2.3. Záložka „Tisk do šablony“
2.3.1. Vnořené záznamy
- Vnořené záznamy definují způsob, jakým budou do excelových tiskových šablon propisovány databázové záznamy z nahlížecích tabulek nebo jiných vizuálních ovládacích prvků.
- Vkládat nové řádky – první záznam nahlížecí tabulky bude vložen na místo, kde byly v tiskové šabloně nalezeny proměnné s identifikátory sloupců tabulky. Ostatní záznamy budou vkládány za první řádku tabulky vždy na nově vytvořenou řádku, takže se bude zbytek dokumentu posouvat směrem dolů.
- Přepisovat řádky – první záznam nahlížecí tabulky bude vložen na místo, kde byly v tiskové šabloně nalezeny proměnné s identifikátory sloupců tabulky. Ostatní záznamy budou přepisovat řádky, které se v dokumentu nacházejí za první řádkou tabulky.
- Nastavení vnořených záznamů se týká pouze tiskových šablon Excel nebo ODS (OpenOffice).
2.3.2. Možnosti
- Spustit skript
- Zaškrtnutí tohoto pole určuje, zda má být před vytvořením dokumentu položkou „Nový ze šablony“ spuštěn skript.
- Spouští se tentýž skript, který se spouští tlačítkem definovaným na záložce „Tlačítko“ (pole „Server“). Spuštění skriptu typicky nastavuje hodnoty skriptových proměnných používaných v tiskové šabloně.
- Odkaz „Upravit skript“ slouží k otevření integrovaného grafického návrháře skriptů, ve kterém se samotný skript definuje.
- Střídat podbarvení řádků
- Zaškrtnutí tohoto pole určuje, zda má být při tisku záznamů uvnitř tabulek používáno střídavé podbarvování řádek bílou a šedou barvou.
- Nastavení tohoto pole se týká pouze tiskových šablon XLSX, XLSM, XLS nebo ODS.
- Dle hodnot prvního sloupce
- Jen ve spojení s možností „Střídat podbarvení řádků“
- Zaškrtnutí tohoto pole určuje, zda má být podbarvování řádek závislé na hodnotě prvního sloupce tištěné tabulky – řádky se stejnou hodnotou prvního sloupce budou mít stejné podbarvení.
- Nastavení tohoto pole se týká pouze tiskových šablon XLSX, XLSM, XLS nebo ODS.
- Zamknout dokument
- Zaškrtnutí tohoto pole určuje, zda má být vytištěný dokument chráněn proti zápisu. Listy excelového souboru se uzamknou heslem, které je možné změnit pomocí externí funkce „NETGenium.ExcelPassword“; dokumenty Word se uzamknou bez hesla. Detailní popis externích funkcí je uveden v samostatné příručce Externí funkce.
- V dokumentech Word (DOCX, DOCM, DOC, ODT) lze po uzamčení provádět jen úpravy se sledováním změn.
- Nastavení tohoto pole se týká pouze tiskových šablon XLS, XLSX, XLSM, ODS, DOC, DOCX, DOCM nebo ODT. U tiskových šablon HTM a HTML se při zaškrtnutí tohoto pole dokument uloží ve formátu PDF, u tiskové šablony PDF nemá zaškrtnutí žádný vliv.
2.4. Záložka „Tlačítko“
2.4.1. Nadpis
- Nadpis určuje název tlačítka, které se volitelně zobrazuje napravo vedle samotného ovládacího prvku v editačním formuláři.
- Nevyplněný název značí, že tlačítko nebude zobrazeno.
2.4.2. Šířka
- Šířka tlačítka uvedená v pixelech.
- Vyplněná šířka „0“ nebo „1“ tlačítko skryje; prázdná šířka nechá rozhodnutí na prohlížeči, který ji odvodí od popisku.
2.4.3. Klient
- Pole „Klient“ určuje seznam javascriptových příkazů, které se vykonají po stisknutí tlačítka. Rozbalovací seznam nabízí následující často používané javascriptové funkce:
- Opravdu chcete ... ? – return jsConfirm(this, 'Opravdu chcete ... ?');
- AJAX... – return bt_Eval(this, 'ngef.aspx?test', 'evalFunction');
- control_SetValue – control_SetValue(#ng_#, 0);
2.4.4. Server
- Je-li pole „Klient“ prázdné, bude po stisknutí tlačítka spuštěn skript na straně serveru. Obsahuje-li pole „Klient“ kód, skript se spustí jen tehdy, vrátí-li kód příkazem „return“ pravdivou hodnotu – kód bez příkazu „return“ skript nespustí. Odkaz „Upravit skript“ slouží k otevření integrovaného grafického návrháře skriptů, ve kterém se definuje skript, resp. serverová část tlačítka.
- Vykonávání javascriptových příkazů lze přerušit příkazem „return false;“, který zamezí i následnému spuštění skriptu na straně serveru.
- Ovládací prvek má jediný skript, který je společný pro tlačítko i pro vytvoření dokumentu položkou „Nový ze šablony“ (možnost „Spustit skript“ na záložce „Tisk do šablony“). Odkazy „Upravit skript“ na obou záložkách proto otevírají tentýž skript a jeho úprava se projeví v obou případech.
2.5. Záložka „Nápověda“
2.5.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.2. Poznámky
- Poznámky slouží pro zadání libovolného textu určeného pro správce aplikace.
- Poznámky mohou obsahovat funkce MAXWIDTH(n), MAXHEIGHT(n) a QUALITY(n), které obrázek nahraný tlačítkem „Procházet...“ zmenší na zadanou maximální šířku a výšku v pixelech, resp. uloží v zadané kvalitě (1–99). Týká se souborů BMP, GIF, JPE, JPEG, JPG a PNG, které se po úpravě uloží ve formátu JPG.
2.6. Záložka „Filtr“
2.6.1. Možnosti
- Zobrazit filtr v nahlížecí tabulce
- Zaškrtnutí tohoto pole určuje, zda má být v nahlížecí tabulce umožněno filtrování záznamů podle hodnot přítomných v databázi ve sloupci spojeném s tímto ovládacím prvkem. Rozbalovací seznam filtru je umístěný v záhlaví nahlížecí tabulky pod názvem ovládacího prvku.
- V rozbalovacím seznamu filtru se nezobrazují konkrétní hodnoty přítomné v databázi ve sloupci spojeném s tímto ovládacím prvkem, pouze možnosti
- Hledat – vyhledávání záznamů v databázi, které mají v názvu souborové přílohy uloženou hledanou hodnotu, nebo v případě zapnutého indexování souborových příloh i v jejím obsahu.
- Prázdný – vyhledání záznamů v databázi, které mají ve sloupci spojeném s tímto ovládacím prvkem uloženou hodnotu 0 nebo databázovou hodnotu „null“
- Neprázdný – vyhledání všech ostatních záznamů v databázi
2.7. Záložka „Práva“
2.7.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, a na zobrazování hodnot tohoto ovládacího prvku všude jinde v aplikaci.
- Uživatelé, kteří nemají práva na ovládací prvek,
- nevidí ovládací prvek ani jeho hodnotu v editačním formuláři a ovládací prvek se nevykreslí ani do zdrojového kódu stránky v internetovém prohlížeči,
- nemohou zobrazit sloupec spojený s tímto ovládacím prvkem v nahlížecí tabulce nebo jiném vizuálním ovládacím prvku určeném pro prohlížení dat,
- mohou vytvořit záznam v editačním formuláři, ve kterém existuje ovládací prvek, na který nemají práva, hodnota těchto ovládacích prvků je pak nastavena na databázovou hodnotu „null“,
- ve výchozím nastavení nemohou smazat záznam v editačním formuláři, ve kterém existuje ovládací prvek, na který nemají práva; výjimkou je zapnutí možnosti „Vždy povolit mazání vlastníkovi nebo spoluvlastníkovi záznamu“ ve vlastnostech ovládacího prvku „ActionButtons“.
- Správce aplikace může způsobit logickou chybu, kdy se pomocí javascriptové funkce odkazuje na ovládací prvek, který pro některé uživatele nemusí být přístupný z pohledu práv. Proměnná „ng_“ se pak nahradí za hodnotu uloženou v databázi v tomto ovládacím prvku namísto odkazu na objekt samotného ovládacího prvku. Tato chyba ve většině případů zastaví načítání editačního formuláře, ten se celý disabluje, a uživateli je zobrazeno hlášení, že má kontaktovat administrátora aplikace. Tento druh chyby je možný z části eliminovat pomocí reportu „Ovládací prvky (JavaScript + nedostatečná práva)“. Nahrazená hodnota je přitom součástí zdrojového kódu stránky – identifikátor ovládacího prvku s citlivou hodnotou proto není vhodné používat v JavaScriptu ani v ovládacím prvku „HTML“.
2.7.2. Zobrazit hodnotu
- Zobrazení hodnoty ovládacího prvku může být omezeno pouze na uživatele, kteří daný databázový záznam vytvořili, anebo jsou nastaveni jako spoluvlastníci všech záznamů v nastavení editačního formuláře.
- Radio button obsahuje následující typy zobrazení hodnoty:
- Všem uživatelům – ovládací prvek včetně jeho hodnoty bude zobrazen všem uživatelům, kteří mají právo na daný ovládací prvek
- Pouze vlastníkovi nebo spoluvlastníkovi záznamu – ovládací prvek včetně jeho hodnoty bude v editačním formuláři zobrazen pouze uživatelům, kteří mají právo na daný ovládací prvek a zároveň smějí záznam upravit – uživateli s administrátorským oprávněním, spoluvlastníkovi a vlastníkovi záznamu, je-li „Práva na editaci“ nastaveno na „Vlastník nebo spoluvlastník záznamu“. Ovládací prvek nelze zobrazit jako sloupec nahlížecí tabulky. Detailní popis zobrazení hodnoty v ostatních ovládacích prvcích je uveden v samostatné příručce Editační formulář.
2.7.3. 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.8. Záložka „Administrace“
- Záložka „Administrace“ se zobrazuje pouze u existujících ovládacích prvků.
2.8.1. Identifikátor
- Identifikátor určuje název databázového sloupce, do kterého se v databázi ukládají hodnoty zadané prostřednictvím ovládacího prvku v editačním formuláři.
- Identifikátor je odvozen od názvu ovládacího prvku. Začíná prefixem „ng_“, a dále obsahuje alfanumerické znaky použité v názvu ovládacího prvku (systémové ovládací prvky prefix „ng_“ neobsahují). Při změně názvu ovládacího prvku je k dispozici tlačítko „Opravit“, které slouží k opravě identifikátoru, a tedy i přejmenování databázového sloupce v databázi. Pro přehlednost a eliminaci případných nedorozumění se doporučuje udržovat identifikátor v souladu s názvem ovládacího prvku. Pokud do databáze přistupují i externí aplikace a například čtou nebo zapisují data do tohoto sloupce, je nutné změnu identifikátoru naplánovat až na vhodnou dobu.
2.8.2. Plný identifikátor
- Plný identifikátor ovládacího prvku obsahuje i identifikátor editačního formuláře, a používá se v tiskových šablonách.
2.8.3. Index
- Zaškrtnutí tohoto pole určuje, zda má být sloupec spojený s tímto ovládacím prvkem v databázi indexovaný. Do textového pole umístěného pod zaškrtávacím tlačítkem je možné definovat i názvy (identifikátory) dalších sloupců, které mají být ve sdruženém indexu s tímto databázovým sloupcem – mají být součástí klíče indexu.
- U databáze MSSQL je možné definovat také sloupce „INCLUDE“, které se připojí k indexu. Nejsou ale součástí klíče indexu, ale hodnoty daného klíče. Databáze Firebird tuto funkcionalitu neumožňuje.
2.8.4. Hledání v nahlížecí tabulce
- Hledání určuje, zda mají být záznamy v nahlížecí tabulce po zadání hledaného výrazu či slovního spojení v databázi ve sloupci spojeném s tímto ovládacím prvkem vyhledávané – podle názvu souborové přílohy, případně i podle obsahu souboru.
- Povolit – hledání v tomto sloupci je povoleno, a v nahlížecí tabulce se objevuje zaškrtávací tlačítko, kterým je možné sloupec tabulky zahrnout do seznamu prohledávaných sloupců.
- Zakázat – hledání v tomto sloupci je zakázáno, a v nahlížecí tabulce se neobjevuje zaškrtávací tlačítko, kterým by bylo možné sloupec tabulky zahrnout do seznamu prohledávaných sloupců.
- Podle obsahu souboru se vyhledává jen tehdy, je-li v nastavení NET Genia zvolen fulltextový katalog „Windows Search“, nebo „Indexing Service“ s vyplněným názvem katalogu, a jen v souborech s příponou .htm, .html, .eml, .xml, .txt, .doc, .docx, .docm, .xls, .xlsx, .xlsm nebo .pdf. Detailní popis fulltextového katalogu je uveden v samostatné příručce Nastavení NET Genia.
2.8.5. Ostatní
- Aktuální hodnota v databázi
- Textové pole zobrazuje aktuální hodnotu právě otevřeného záznamu v editačním formuláři v daném ovládacím prvku, s možností změny této hodnoty.
- Změnit typ na
- Rozbalovací seznam nabízí typy ovládacích prvků, na které je podporována konverze ovládacího prvku včetně automatické konverze dat přítomných v databázové tabulce.
2.8.6. Statistika
- Statistika zobrazuje agregovanou informaci o využívání ovládacího prvku napříč celou aplikací.
- Pomocí tlačítka „Statistika“ se zobrazí detailní report všech míst, kde je ovládací prvek použitý nebo referencovaný, včetně možnosti otevření nastavení takového místa či ovládacího prvku.
- Před každou změnou typu ovládacího prvku nebo datového typu, případně před každým smazáním ovládacího prvku z editačního formuláře, se doporučuje důkladně projít statistku ovládacího prvku, a eliminovat případná nedorozumění.
- Před každým smazáním ovládacího prvku z editačního formuláře se automaticky spustí vyhodnocení statistiky. Pokud je ovládací prvek někde v aplikaci používán nebo referencován, je nutné smazání ovládacího prvku znovu potvrdit.
2.9. Picker
- Pro konfiguraci pickeru na tomto ovládacím prvku slouží ikona lupy, umístěná v levém dolním rohu dialogu.
- Detailní popis pickeru je uveden v samostatné příručce Picker.
2.10. 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.
3. Chování příloh
- Odkaz pro stažení přílohy je vázaný na přihlášeného uživatele a jeho relaci a platí 24 hodin. Jinému uživateli ho předat nelze.
- Přílohy ve formátu HTML (.htm, .html) a SVG se otevírají přímo v prohlížeči v izolovaném režimu (sandbox): skripty se v nich nespouštějí a obsah nemá přístup k NET Geniu. Obrázky se zobrazují, ostatní přílohy se stahují.
- Do ovládacího prvku File lze uložit jen přílohu, kterou server v aktuální relaci vytvořil nebo zpřístupnil – nahranou tlačítkem, vloženou ze schránky, převzatou pickerem nebo přiřazenou skriptem. ID existující přílohy odjinud ovládací prvek nepřevezme.
- Tlačítko „Odstranit“ jen vyprázdní hodnotu ovládacího prvku. Soubor přílohy zůstává na disku v adresáři „Files“ i se záznamem v tabulce „sfiles“, stejně jako po smazání záznamu, ovládacího prvku, editačního formuláře nebo historie změn. Díky tomu lze smazaný záznam obnovit z historie i s přílohou.
- Přílohy, na které už žádný záznam ani historie změn neodkazuje, se čistí programem „SqlBackup.exe“ s parametrem „/unusedfiles“. Ten vytvoří soubor „UnusedFiles.log“ s návrhem ke kontrole a přílohy smaže až příkaz „SqlBackup.exe /run UnusedFiles.log“. Detailní popis je uveden v samostatné příručce Utility.
4. Příklady
4.1. Javascriptové funkce
- var s = control_GetValue(#ng_#);
- var filename = #ng_#.getAttribute('title');
- var size = jsN(#ng_#.getAttribute('size'));
- control_Disable(#ng_#); // Obecná javascriptová funkce pro všechny databázové ovládací prvky
- file_Disable(#ng_#);
- control_Enable(#ng_#); // Obecná javascriptová funkce pro všechny databázové ovládací prvky
- file_Enable(#ng_#);
- picker_Open(#ng_#);
4.2. Serverové funkce
- SCHEDULEDEFAULTVALUE(ng_, #ng_#)
- ATTACHMENT2PDF(#ng_soubor#)
- ATTACHMENT2PDF(#rootpath#Temp\file.doc)
- ATTACHMENT2PDF(#rootpath#Temp\file.xls)
- ATTACHMENTCONTENT(#ng_soubor#)
- ATTACHMENTGALLERY(1;2;3, 120, 120)
- ATTACHMENTGALLERY(1;2;3, 120, 120, 5)
- ATTACHMENTNAME(#ng_soubor#)
- ATTACHMENTURL(#ng_soubor#)
- COPYATTACHMENT(#ng_soubor#)
- COPYATTACHMENT(#ng_soubor#, #rootpath#Temp)
- CREATEATTACHMENT(data:image/png;base64,...)