1. Základní informace
1.1. Popis ovládacího prvku
DataGrid je nahlížecí tabulka, která zobrazuje databázové záznamy načtené dotazem z databáze, s možností vyhledávání a filtrování záznamů, a s možností exportů a importů dat.
Nahlížecí tabulku lze umístit také do portletů na hlavní stránce, kde se zobrazuje ve zjednodušené podobě – bez hledání, filtrů a panelu detailů a bez časového úseku nastaveného v databázovém dotazu. Detailní popis je uveden v samostatné příručce Portlety.
1.2. Vytvoření nového ovládacího prvku
Nový datagrid 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ý datagrid 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 „DataGrid“, 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 datagridu na předem vybrané místo nahlížecí stránky.
- Nedojde-li před vložením nového datagridu k určení požadované pozice, bude nový datagrid 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í
- Nahlížecí tabulka – Nastavení sloupců nahlížecí tabulky
- Detaily – Nastavení sloupců zobrazovaných v detailech
- Hledání – Nastavení hledání
- Práva – Nastavení práv
- Administrace – Nastavení ostatních vlastností
2.1. Záložka „Obecné“
2.1.1. Běžný dotaz

2.1.2. Název
- Název ovládacího prvku zobrazovaný v záhlaví nahlížecí tabulky.
- Umístění názvu ovládacího prvku mezi dvě pajpy zajistí, že bude nahlížecí tabulka zcela skrytá, pokud nebude výsledkem dotazu žádný záznam – například „|Záznamy v tabulce Kniha|“.
- Za pravou pajpou může následovat alternativní HTML kód, který se zobrazí místo nahlížecí tabulky, pokud nebude výsledkem dotazu žádný záznam – například „|Záznamy v tabulce Kniha|<img src="Images/Help.gif">“.
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. Šířka
- Šířka ovládacího prvku uvedená v pixelech.
- Při nevyplnění tohoto zadávacího pole bude šířka nahlížecí tabulky určena automaticky webovým prohlížečem.
2.1.5. Zdroj dat
- Zdroj dat definuje zdrojové databázové záznamy zobrazované v nahlížecí tabulce.
- Nastavení zdroje dat se provádí v grafickém návrháři databázových dotazů. Detailní popis návrháře databázových dotazů je uveden v samostatné příručce Návrhář databázových dotazů.
2.1.6. Možnosti
- Zobrazit ikonu „Nový záznam...“
- Zaškrtnutí tohoto pole určuje, zda má být v záhlaví nahlížecí tabulky zobrazena ikona, která přesměruje uživatele do konkrétního editačního formuláře za účelem založení nového záznamu v databázi.
- Zakázat uživatelské přizpůsobení
- Zaškrtnutí tohoto pole určuje, zda má být jednotlivým uživatelům zakázána změna nastavení sloupců této nahlížecí tabulky.
- Povolit import dat
- Zaškrtnutí tohoto pole určuje, zda má být v záhlaví nahlížecí tabulky zobrazena ikona, která umožní import dat do zobrazované databázové tabulky ze souborů formátu
- XML
- XLS(X) (Excel)
- CSV (Excel)
- MDB (Access)
- ZIP – zazipovaná varianta výše uvedených formátů
- Přílohy se importují jen s obsahem (například formát XML exportovaný i s přílohami). Import přílohy podle cesty k souboru na serveru nebo podle ID existující přílohy je vyhrazen uživatelům s administrátorským oprávněním; cesta přitom musí vést do adresáře instalace NET Genia, pokud se neimportuje z místního počítače.
- Import nespouští ukládací skripty editačního formuláře a záznamy nezařazuje do synchronizace; historie změn se zapíše, pokud ji editační formulář nemá zakázanou. Povolení importu dává uživateli stejné možnosti jako administrátorovi: import podle sloupce ID aktualizuje existující záznamy nebo je založí s daným ID a lze importovat i vazbu na rodičovský záznam (PID, PForm) a ovládací prvky „Jen ke čtení“.
- Zaškrtnutí tohoto pole určuje, zda má být v záhlaví nahlížecí tabulky zobrazena ikona, která umožní import dat do zobrazované databázové tabulky ze souborů formátu
- Povolit MS Excel Import
- Zaškrtnutí tohoto pole určuje, zda má být v záhlaví nahlížecí tabulky zobrazena ikona „MS Excel Import/Export“. Po stisknutí ikony se zobrazí možnosti „Exportovat data“ a „Importovat data“, které umožňují export dat do souboru MS Excel, nebo import do databázové tabulky pomocí souboru formátu XLS. Exportovaný soubor XLSX je připravený pro zpětný import – obsahuje skrytý řádek s identifikátory sloupců a skrytý sloupec s ID záznamu a nezahrnuje sloupce s ID, s heslem, s přílohami ani šifrované sloupce. Je-li zaškrtnuté „Zakázat export dat“, nabízí se jen import.
- Tato funkce je k dispozici pouze u nahlížecích tabulek, které nepoužívají joinování.
- Zakázat export dat
- Zaškrtnutí tohoto pole skryje ikonu v záhlaví nahlížecí tabulky, která umožňuje export zobrazovaných dat do souborů. Zákaz se kontroluje i na serveru; uživatelům s administrátorským oprávněním zůstává export povolený. Detailní popis exportu dat z DataGridu je uveden v samostatné příručce Export dat z DataGridu.
- Zakázat otevírání záznamů
- Zaškrtnutí tohoto pole určuje, zda má být všem uživatelům zakázána možnost vstupu do editačního formuláře za účelem otevření zobrazovaného databázového záznamu pomocí ikony tužky, která se zobrazuje na začátku každé řádky nahlížecí tabulky.
- Povolit hromadné změny
- Zaškrtnutí tohoto pole určuje, zda má být v nahlížecí tabulce namísto samotné hodnoty ovládacího prvku zobrazeno textové pole nebo rozbalovací seznam s vybranou hodnotou, s možností změny hodnoty bez nutnosti otevření a editace záznamu v editačním formuláři.
- Tato funkce je aplikována pouze u ovládacích prvků, které mají zaškrtnuté pole „Povolit hromadné změny“ na záložce „Obecné“.
- Anonymnímu uživateli se nezobrazují filtry sloupců, a tedy ani položka „Přiřadit hodnotu...“. Hodnotu přímo v buňce nahlížecí tabulky může změnit za stejných podmínek jako přihlášený uživatel – zaškrtávací pole vždy, ostatní ovládací prvky podle práv na editaci záznamu. Všichni anonymní návštěvníci přitom sdílejí jeden uživatelský účet, takže záznam vytvořený jedním z nich je pro ostatní jejich vlastním záznamem.
- Zaškrtnutí tohoto pole určuje, zda má být v rozbalovacím seznamu filtrů jednotlivých sloupců k dispozici položka „Přiřadit hodnotu...“, která slouží k přiřazení hodnoty všem označeným nebo vyfiltrovaným záznamům v nahlížecí tabulce.
- Tato funkce je aplikována pouze u ovládacích prvků, které mají zaškrtnuté pole „Povolit hromadné změny“ na záložce „Filtry“.
- Hromadné změny je možné provádět pouze přihlášeným uživatelem.
- Pokud jsou v nahlížecí tabulce označené konkrétní záznamy, k přiřazení hodnoty dojde pouze u označených záznamů. Pokud nejsou označené žádné záznamy, k přiřazení hodnoty dojde u všech vyfiltrovaných záznamů.
- Přiřazení hodnoty i mazání pracují nad celou podmínkou nahlížecí tabulky, tedy i nad záznamy, které se kvůli nastavení „Načíst pouze prvních“ v tabulce nezobrazují.
- Je-li zaškrtnuté „Zobrazit pouze výsledky hledání“, nelze bez zadaného hledaného výrazu ani složeného filtru přiřadit hodnotu ani mazat.
- Zaškrtnutí tohoto pole určuje, zda má být v hlavičce nahlížecí tabulky k dispozici ikona „Smazat záznamy v nahlížecí tabulce“, která slouží ke smazání označených nebo vyfiltrovaných záznamů v nahlížecí tabulce.
- Uživatelé s administrátorským oprávněním – pokud jsou v nahlížecí tabulce označené konkrétní záznamy, dojde ke smazání pouze označených záznamů. Pokud nejsou označené žádné záznamy, dojde ke smazání všech vyfiltrovaných záznamů!
- Uživatelé bez administrátorského oprávnění mohou mazat pouze označené konkrétní záznamy, nemají oprávnění ke smazání všech vyfiltrovaných záznamů.
- Uživatelům s administrátorským oprávněním se ikona zobrazuje u každé nahlížecí tabulky, která nečte data z databázového pohledu.
- Běžnému uživateli se ikona zobrazí i tehdy, když je zaškrtnuté jen pole „Aktivovat označování záznamů“, a nezobrazí se, má-li editační formulář skryté tlačítko „Smazat“. Běžný uživatel smí najednou smazat nejvýše 1000 záznamů a jen ty, které smí měnit.
- Zaškrtnutí tohoto pole určuje, zda má být v hlavičce nahlížecí tabulky k dispozici ikona „Označit záznamy...“, která slouží k označování jednotlivých záznamů nahlížecí tabulky za účelem jejich smazání nebo přiřazení hodnoty pomocí filtru.
- K seznamu označených záznamů – hodnoty primárních klíčů (sloupec „id“) oddělené středníkem – je možné přistupovat pomocí proměnných „#datagrid1#“, „#datagrid2#“, „#datagrid3#“ atd. ve skriptu. Index značí pořadí nahlížecí tabulky na nahlížecí stránce.
- Zaškrtnutí tohoto pole určuje, zda má být v nahlížecí tabulce namísto samotné hodnoty ovládacího prvku zobrazeno textové pole nebo rozbalovací seznam s vybranou hodnotou, s možností změny hodnoty bez nutnosti otevření a editace záznamu v editačním formuláři.
- Aktivovat označování záznamů
- Zaškrtnutí tohoto pole určuje, zda má být na začátku každé řádky nahlížecí tabulky automaticky zobrazeno zaškrtávací pole určené pro označení záznamu za účelem jeho smazání nebo přiřazení hodnoty pomocí filtru, bez nutnosti používat ikonu „Označit záznamy...“ umístěnou v hlavičce nahlížecí tabulky.
- K seznamu označených záznamů – hodnoty primárních klíčů (sloupec „id“) oddělené středníkem – je možné přistupovat pomocí proměnných „#datagrid1#“, „#datagrid2#“, „#datagrid3#“ atd. ve skriptu. Index značí pořadí nahlížecí tabulky na nahlížecí stránce.
- Zaškrtnutí tohoto pole určuje, zda má být na začátku každé řádky nahlížecí tabulky automaticky zobrazeno zaškrtávací pole určené pro označení záznamu za účelem jeho smazání nebo přiřazení hodnoty pomocí filtru, bez nutnosti používat ikonu „Označit záznamy...“ umístěnou v hlavičce nahlížecí tabulky.
- Zobrazit součty sloupců
- Zaškrtnutí tohoto pole určuje, zda má být v zápatí nahlížecí tabulky zobrazen řádek se součtem hodnot jednotlivých sloupců.
- Tato funkce je aplikována pouze u ovládacích prvků TextBox číselných datových typů, které nemají zaškrtnuté pole „Skrýt součet sloupce v nahlížecí tabulce“ na záložce „Obecné“.
- Skrýt vnořené záznamy
- Zaškrtnutí tohoto pole určuje, zda má být do definice databázového dotazu automaticky připojena omezující podmínka „PID = 0 nebo PID není definováno“.
2.1.7. Agregační dotaz bez seskupování podle datumu
- Zakázat export dat
- Zaškrtnutí tohoto pole skryje ikonu v záhlaví nahlížecí tabulky, která umožňuje export zobrazovaných dat do souboru formátu XLSX; export proběhne bez dialogu exportu. Uživatelům s administrátorským oprávněním zůstává export povolený.
- Zobrazit součty sloupců
- Zaškrtnutí tohoto pole určuje, zda má být v zápatí nahlížecí tabulky zobrazen řádek se součtem hodnot jednotlivých sloupců.
- Tato funkce je aplikována pouze u sloupců, které nepoužívají příkaz pro skrytí součtu sloupce pomocí syntaxe
„Sloupec@-sum“. Detailní popis syntaxe názvů sloupců je uveden v samostatné příručce Návrhář databázových dotazů.
2.1.8. Agregační dotaz se seskupováním podle datumu
- Zakázat export dat
- Zaškrtnutí tohoto pole skryje ikonu v záhlaví nahlížecí tabulky, která umožňuje export zobrazovaných dat do souboru formátu XLSX; export proběhne bez dialogu exportu. Uživatelům s administrátorským oprávněním zůstává export povolený.
- Vyplnit časové mezery
- Zaškrtnutí tohoto pole určuje, zda má být ve výsledné sadě dat zajištěna časová kontinuita ve sloupci, podle kterého jsou data seskupována. Tam kde chybí agregované řádky, budou automaticky doplněny se všemi ostatními sloupci nastavenými na hodnotu „0“.
- Kontingenční tabulka
- Zaškrtnutí tohoto pole určuje, zda má nahlížecí tabulka vypsat data jako kontingenční tabulku – seskupovací hodnoty v řádcích a jednotlivá období ve sloupcích.
- Pole se uplatní pouze u agregačního dotazu se seskupováním podle datumu, který má zároveň vyplněné seskupovací sloupce a nemá vlastní víceřádkové záhlaví; jinak zůstane bez účinku.
- Zobrazit součty sloupců
- Zaškrtnutí tohoto pole určuje, zda má být v zápatí nahlížecí tabulky zobrazen řádek se součtem hodnot jednotlivých sloupců.
- Tato funkce je aplikována pouze u sloupců, které nepoužívají příkaz pro skrytí součtu sloupce pomocí syntaxe
„Sloupec@-sum“. Detailní popis syntaxe názvů sloupců je uveden v samostatné příručce Návrhář databázových dotazů.
- Přichytit k předchozímu ovládacímu prvku
- Zaškrtnutí tohoto pole určuje, zda má být samotný ovládací prvek v editačním formuláři zobrazen napravo vedle předchozího, nebo bude zobrazen běžným způsobem pod předchozím ovládacím prvkem.
2.2. Záložka „Nahlížecí tabulka“
2.2.1. Možnosti
- Zobrazit horní navigační lištu
- Zaškrtnutí tohoto pole určuje, zda má být v záhlaví nahlížecí tabulky zobrazena nástrojová lišta s ikonami pro přechod mezi jednotlivými stránkami.
- Tato nástrojová lišta je standardně zobrazena v zápatí každé nahlížecí tabulky, pokud je počet zobrazovaných dat větší než počet záznamů na stránce.
- Zobrazit filtry
- Zaškrtnutí tohoto pole určuje, zda má nahlížecí tabulka umožňovat filtrování databázových záznamů.
2.2.2. Sloupce
- Definice výchozího nastavení sloupců nahlížecí tabulky.
2.2.3. Počet záznamů na stránce
- Pro přehlednost používá nahlížecí tabulka stránkování zobrazovaných záznamů. To je užitečné v situacích, kdy nahlížecí tabulka načítá velké množství dat.
- Počet záznamů na stránce určuje maximální počet záznamů, které se zobrazí na jedné stránce. Mezi jednotlivými stránkami lze snadno přecházet pomocí nástrojové lišty, kterou obsahuje každá nahlížecí tabulka ve svém zápatí, případně ještě volitelně v záhlaví.
2.3. Záložka „Detaily“
2.3.1. Možnosti
- Zobrazit detaily
- Zaškrtnutí tohoto pole určuje, zda má nahlížecí tabulka zobrazovat detaily jednotlivých záznamů dole pod nahlížecí tabulkou.
- Zobrazit tooltip
- Zaškrtnutí tohoto pole určuje, zda má nahlížecí tabulka zobrazovat detaily jednotlivých záznamů v tooltipu při najetí myší nad jednotlivými záznamy.
2.3.2. Sloupce
- Definice výchozího nastavení sloupců detailů.
2.4. Záložka „Hledání“
2.4.1. Možnosti
- Aktivovat hledání
- Zaškrtnutí tohoto pole určuje, zda má být v záhlaví nahlížecí tabulky automaticky zobrazen řádek s vyhledávacím polem a tlačítkem „Hledat“.
- Optimalizované hledání
- Zaškrtnutí tohoto pole určuje, zda má být mít každý sloupec nahlížecí tabulky vlastní pole pro vyhledávání.
- Toto pole ovlivňuje pouze způsob zadávání hledaného výrazu, nikoli způsob jeho vyhodnocení.
- Zobrazit pouze výsledky hledání
- Zaškrtnutí tohoto pole určuje, zda mají být data v nahlížecí tabulce zobrazena pouze při zadání hledaného výrazu.
- Toto pole zároveň určuje, kde se hledaný výraz vyhodnocuje. Je-li zaškrtnuté, stane se hledaný výraz součástí databázového dotazu a o výsledku hledání rozhodují porovnávací pravidla (collation) databáze. Není-li zaškrtnuté, načtou se záznamy z databáze bez hledaného výrazu a ten se vyhodnotí až nad načtenými daty – takové hledání nerozlišuje velká a malá písmena, ale rozlišuje diakritiku, a to bez ohledu na nastavení databáze.
- Nad načtenými daty se vyhodnocuje i řazení nahlížecí tabulky, které proto na nastavení databáze nezávisí rovněž. Je-li ale omezen počet zobrazených řádků, rozhodují porovnávací pravidla databáze o tom, které záznamy se vůbec načtou.
- Hledání bez ohledu na diakritiku se nenastavuje zde, ale u jednotlivých ovládacích prvků polem „Hledat bez diakritiky“.
2.5. Záložka „Práva“
2.5.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.5.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.6. Záložka „Administrace“
- Záložka „Administrace“ se zobrazuje pouze u existujících ovládacích prvků.
2.6.1. Název šablony
- Název šablony slouží pro pojmenování nahlížecí tabulky s možností jejího zkopírování při vytváření dalších nahlížecích tabulek se stejnou zdrojovou databázovou tabulkou.
- Při vytváření nové nahlížecí tabulky je nejdříve nutné definovat zdroj dat pomocí databázového dotazu, a následně jsou všechny dostupné šablony k dispozici v rozbalovacím seznamu „Šablony“ na záložce „Obecné“. Po vybrání šablony dojde k automatickému předvyplnění všech parametrů nahlížecí tabulky údaji ze zvolené šablony.
- Seznam všech nahlížecích tabulek, které jsou označené jako šablony, je možné zobrazit pomocí reportu. Detailní popis reportů je uveden v samostatné příručce Reporty.
2.6.2. 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.6.3. Ostatní
- Změnit typ na
- Rozbalovací seznam nabízí typy ovládacích prvků, na které je podporována konverze ovládacího prvku.
2.7. Tlačítka „Uložit“, „Uložit všem uživatelům“, „Kopírovat“, „Smazat“ a „Zavřít“
- Tlačítko „Uložit“ – Uložení změn v nastavení ovládacího prvku spolu s individuálním nastavením aktuálně přihlášeného uživatele.
- Individuální nastavení tohoto datagridu u aktuálního uživatele bude smazáno, aby při prvním novém zobrazení datagridu bylo použito výchozí nastavení definované v tomto dialogu.
- Individuální nastavení datagridu je možné otevřít pomocí ikony ozubeného kolečka, která je k dispozici v liště s ikonami v záhlaví každého datagridu.
- Individuální nastavení datagridu zahrnuje tyto možnosti:
- Možnosti na záložce „Obecné“ individuálního nastavení datagridu
- „Setřídit podle“
- „Počet záznamů na stránce
- „Zobrazit horní navigační lištu“
- „Zobrazit filtry“
- „Zobrazit mřížku“
- „Zobrazit součty sloupců“
- „Zobrazit detaily“
- „Zobrazit tooltip“
- Nastavení sloupců na záložce „Nahlížecí tabulka“ individuálního nastavení datagridu
- Nastavení sloupců na záložce „Detaily“ individuálního nastavení datagridu
- Možnosti na záložce „Obecné“ individuálního nastavení datagridu
- U všech ostatních uživatelů zůstane jejich individuální nastavení zachováno.
- Tlačítko „Uložit všem uživatelům“ – Smazání individuálního nastavení tohoto datagridu všem uživatelům, aby při prvním novém zobrazení tohoto datagridu bylo použito výchozí nastavení definované v tomto dialogu.
- 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í nahlížecí tabulky
3.1. Načtení dat, stránkování a řazení
- Nahlížecí tabulka načítá celý výsledek databázového dotazu a stránkování probíhá až nad načtenými daty. Rozsah načítaných dat omezuje nastavení „Načíst pouze prvních“ v návrháři databázových dotazů.
- Je-li zaškrtnuté „Zobrazit pouze výsledky hledání“ a v dotazu není nastavené „Načíst pouze prvních“, načte se nejvýše tolik záznamů, kolik určuje „Počet záznamů na stránce“. Nahlížecí tabulka pak zobrazí i vyexportuje nejvýše jednu stránku výsledků.
- Záznamy s duplicitní hodnotou („Odstranit záznamy s duplicitním“) se odstraňují až po načtení dat, takže tabulka může zobrazit méně záznamů, než kolik povoluje „Načíst pouze prvních“.
- Bez platného licenčního klíče se řádkový dotaz nahlížecí tabulky omezí na 100 záznamů; statistická nahlížecí tabulka se neomezuje.
- Kliknutí na záhlaví sloupce seřadí tabulku podle tohoto sloupce, opakované kliknutí obrátí směr řazení. Tlačítko „Výchozí třídění“ vrátí řazení podle databázového dotazu.
3.2. Součty sloupců
- Součty v zápatí se počítají ze všech vyfiltrovaných záznamů, ne jen z aktuální stránky.
- Při 1000 a více záznamech počítá součty databáze. Takový součet nezohledňuje hodnoty upravené externí funkcí ani omezení „Načíst pouze prvních“.
3.3. Otevírání záznamů
- Záznam se otevírá odkazem na začátku řádku a v uživatelském režimu také dvojklikem na řádek; na mobilním zařízení stačí na řádek kliknout.
- Pole „Zakázat otevírání záznamů“ jen skryje odkazy v nahlížecí tabulce. Otevření záznamu přímou adresou editačního formuláře se řídí oprávněními editačního formuláře.
3.4. Individuální nastavení
- Individuální nastavení (řazení, aktuální stránka, počet záznamů na stránce, hledaný výraz, filtry a sloupce) se ukládá každému uživateli zvlášť, a to k databázovému dotazu nahlížecí tabulky.
- Anonymnímu uživateli se individuální nastavení neukládá a nemá k dispozici přizpůsobení nahlížecí tabulky ani složený filtr.
- Sloupce, ke kterým uživatel nemá oprávnění, se z jeho individuálního nastavení při uložení odstraní.
- Pole „Zobrazit mřížku“ je jen součástí individuálního nastavení; výchozí nastavení ovládacího prvku ho neurčuje.
3.5. Složený filtr a hodnoty v tabulce
- Hodnoty zadané do složeného filtru se do podmínky dosazují doslova. Serverové funkce se v nich nevyhodnocují a z proměnných se nahrazují jen datumové proměnné (např. #today#, #now#).
- Zaškrtávací pole zobrazené v nahlížecí tabulce lze přepnout vždy – i u ovládacího prvku „Jen ke čtení“ a u záznamu jiného uživatele. Ostatní ovládací prvky lze v nahlížecí tabulce měnit jen tehdy, když uživatel smí záznam měnit a ovládací prvek není „Jen ke čtení“.
4. Příklady
4.1. Javascriptové funkce
- dg_Disable();
- dg_Enable();
- dg_HideColumn(DG123, 456);
- dg_HideColumn(el(DG123), 456);
- dg_HideHeader(DG123);
- dg_SearchColumns(DG123, [1, 2, 3]);
- dg_SearchColumns(el(DG123), [1, 2, 3]);
- dg_ShowColumn(DG123, 456);
- dg_ShowColumn(el(DG123), 456);
- dg_VisibleColumns(DG123, [1, 2, 3]);
- dg_VisibleColumns(el(DG123), [1, 2, 3]);
- var array = dg_Controls(el(DG123));
4.2. Proměnné
- #datagrid1#
- #datagrid2#
- #datagrid3#