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

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,...)