Editační formulář - LiteDataGrid

1. Základní informace

1.1. Popis ovládacího prvku

LiteDataGrid je nahlížecí tabulka, která zobrazuje databázové záznamy načtené dotazem z databáze, bez možnosti personalizace, vyhledávání a filtrování záznamů a bez možnosti importu dat. Export dat nabízí jen statistický LiteDataGrid, a to rovnou do souboru XLSX bez dialogu exportu; pole „Zakázat export dat“ se v nastavení prvku nenabízí. Řádkový LiteDataGrid zobrazuje záznamy v řazení podle databázového dotazu a uživatel je nemůže přeřadit; statistický LiteDataGrid lze seřadit kliknutím na záhlaví sloupce stejně jako statistický DataGrid a tlačítkem „Výchozí třídění“ obnovit výchozí řazení. Řazení se v LiteDataGridu neukládá. Detailní popis řazení statistické nahlížecí tabulky je uveden v samostatné příručce Editační formulář – DataGrid.

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.

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
• Hledání – Nastavení hledání
• Nápověda – Nastavení textu nápovědy
• 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|“. Nahlížecí tabulka se takto skrývá jen v uživatelském režimu.
• 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">“.
• Přípona „++“ na konci názvu sloučí v nahlížecí tabulce buňky po sobě jdoucích řádků téhož záznamu se shodnou hodnotou. Přípona „+++“ sloučí buňky po sobě jdoucích řádků se shodnou hodnotou v prvním sloupci nahlížecí tabulky a v dalších sloupcích v jeho rozsahu a hodnotu prvního sloupce zvýrazní tučně. Přípona se uplatní jen u běžného dotazu, zobrazuje-li nahlížecí tabulka více než jeden záznam na stránce, a jen u běžného dotazu se v názvu nezobrazuje – u agregačního dotazu v názvu zůstane; v režimu „Zobrazovat jako detaily ve dvou sloupcích“ se neuplatní. Je-li název zároveň umístěný mezi pajpami, patří přípona dovnitř pajp – například „|Záznamy v tabulce Kniha++|“; text za pravou pajpou se vždy bere jako alternativní HTML kód.

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

• 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.
    • U nahlížecí tabulky, která čte data z databázového pohledu, se toto pole neuplatní – hodnoty nelze měnit v buňce.
    • 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é“.
    • Má-li ovládací prvek v poli „Poznámky“ zápis „DENYCONTROL()“, zobrazuje se v nahlížecí tabulce jen jeho hodnota bez možnosti změny.
    • Anonymní uživatel může hodnoty v nahlížecí tabulce mě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 ale vystupují pod jedním uživatelským účtem, a jsou proto vlastníky všech záznamů, které některý z nich založil. Smí-li záznam měnit jeho vlastník, může tak každý anonymní návštěvník měnit i záznamy založené jiným návštěvníkem.
• Zobrazit pouze 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 = ID záznamu ve formuláři“.
  • Podmínka nezohledňuje PFORM. Slouží-li zdrojový editační formulář jako úložiště vnořených záznamů pro více rodičovských formulářů, je nutné doplnit do databázového dotazu podmínku na PFORM. U nového, dosud neuloženého záznamu nezobrazí nahlížecí tabulka žádné záznamy.
  • Pro rychlé vyhodnocení této podmínky nastavte index „PID“ nebo „PFORM + PID“ na editačním formuláři, který je datovým zdrojem nahlížecí tabulky. Index se nenastavuje na formuláři, ve kterém je nahlížecí tabulka umístěna.
• 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ů, měny a času a u ovládacích prvků AutoSum, které nemají zaškrtnuté pole „Skrýt součet sloupce v nahlížecí tabulce“ na záložce „Obecné“.
• Zobrazovat jako detaily ve dvou sloupcích
  • Zaškrtnutí tohoto pole určuje, zda mají být hodnoty zobrazeny ve formě dvousloupcové tabulky s názvem sloupce v prvním sloupci a hodnotou ve druhém sloupci, namísto běžného způsobu tabulky.
  • V tomto režimu zobrazí nahlížecí tabulka nejvýše 1000 záznamů. Nevrátí-li databázový dotaz žádný záznam, ovládací prvek se v editačním formuláři nezobrazí.
• Zobrazovat prázdné hodnoty
  • Zaškrtnutí tohoto pole určuje, zda mají být v režimu „Zobrazovat jako detaily ve dvou sloupcích“ zobrazeny i sloupce s prázdnou hodnotou.
• Skrýt zdroj dat
  • Zaškrtnutí tohoto pole určuje, zda má být při otevření editačního formuláře automaticky skrytý obsah nahlížecí tabulky. Databázové záznamy se uživateli zobrazí až po kliknutí na ikonu „Zobrazit“, nebo kliknutím na záložku, ve které se nahlížecí tabulka nachází. Nachází-li se nahlížecí tabulka na záložce, která je aktivní při otevření editačního formuláře, zobrazí se databázové záznamy hned.
• 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.1.7. Agregační dotaz bez seskupování podle datumu

• 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ů.
  • Řádek součtů nese u každého sloupce hodnotu podle jeho typu: u počtu a součtu součet hodnot řádků, u průměru průměr hodnot řádků (prázdná hodnota se počítá jako 0), u maxima a minima největší, resp. nejmenší hodnotu, přičemž se řádky bez hodnoty vynechají (nemá-li hodnotu žádný řádek, zůstane buňka prázdná), u kumulativního sloupce součet jeho poslední hodnoty v každé skupině, u kumulace „-1“ a „--1“ první hodnoty (bez seskupovacích sloupců hodnotu posledního, resp. prvního řádku), a u výrazového sloupce výraz vyhodnocený nad hodnotami řádku součtů – výrazový sloupec se syntaxí „Sloupec@+sum“, s funkcí NGEF, SQL nebo SQLTABLE ve výrazu nebo s odkazem na datum, podle kterého je dotaz seskupený, se místo toho sečte. Seskupovací, textové a datumové sloupce zůstávají v řádku součtů prázdné; první sloupec ale nese symbol „Σ“, zůstane-li jinak prázdný. Sloupec se zobrazovanou hodnotou (třetí část názvu sloupce) ukazuje tuto hodnotu i v řádku součtů. Totéž platí pro agregační dotaz se seskupováním podle datumu.
  • 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ů.
• Skrýt zdroj dat
  • Zaškrtnutí tohoto pole určuje, zda má být při otevření editačního formuláře automaticky skrytý obsah nahlížecí tabulky. Databázové záznamy se uživateli zobrazí až po kliknutí na ikonu „Zobrazit“, nebo kliknutím na záložku, ve které se nahlížecí tabulka nachází. Nachází-li se nahlížecí tabulka na záložce, která je aktivní při otevření editačního formuláře, zobrazí se databázové záznamy hned.
• 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.1.8. Agregační dotaz se seskupováním podle datumu

• Vyplnit časové mezery
  • Zaškrtnutí tohoto pole určuje, zda mají být ve výsledné sadě dat doplněna chybějící období ve sloupci, podle kterého jsou data seskupována. Doplní se období mezi prvním a posledním nalezeným obdobím každé seskupovací hodnoty, ne až k hranicím časového úseku. Číselné sloupce doplněných řádků se nastaví na hodnotu „0“, seskupovací hodnota se převezme a textové sloupce zůstanou prázdné.
• 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.
  • Je-li zaškrtnuté také pole „Zobrazit součty sloupců“ a tabulka obsahuje více než jedno období a aspoň jeden nekumulativní sloupec počtu, součtu, průměru, maxima nebo minima bez syntaxe „Sloupec@-sum“ nebo výrazový sloupec, který se v souhrnném sloupci sčítá (viz níže), přibude za sloupci období souhrnný sloupec „Σ“ – u počtu a součtu nese součet všech období, u průměru průměr na jedno období a u maxima a minima největší, resp. nejmenší hodnotu; období, ve kterých skupina nemá žádný záznam, se u maxima a minima vynechají. U sloupců se syntaxí „Sloupec@-sum“ zůstane souhrnný sloupec prázdný; mají-li tuto syntaxi všechny sloupce, souhrnný sloupec se vyplní a skryje se jen řádek součtů. Kumulativní sloupce zůstávají v souhrnném sloupci prázdné. Výrazový sloupec se syntaxí „Sloupec@+sum“, s funkcí NGEF, SQL nebo SQLTABLE ve výrazu nebo s odkazem na datum, podle kterého je dotaz seskupený, se v souhrnném sloupci sečte přes všechna období; ostatní výrazové sloupce se v něm vyhodnotí nad hodnotami souhrnného sloupce.
  • Kliknutím na záhlaví období se zobrazí jen toto období a jeho záhlaví se označí textem „(Aktivní)“. Totéž platí pro záhlaví souhrnného sloupce „Σ“. Opakované kliknutí zobrazí znovu všechna období. Výběrem období i zrušením výběru se řazení tabulky vrátí na výchozí. Výběr období se v LiteDataGridu neukládá.
• 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ů.
• Skrýt zdroj dat
  • Zaškrtnutí tohoto pole určuje, zda má být při otevření editačního formuláře automaticky skrytý obsah nahlížecí tabulky. Databázové záznamy se uživateli zobrazí až po kliknutí na ikonu „Zobrazit“, nebo kliknutím na záložku, ve které se nahlížecí tabulka nachází. Nachází-li se nahlížecí tabulka na záložce, která je aktivní při otevření editačního formuláře, zobrazí se databázové záznamy hned.
• 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. Sloupce

• Definice nastavení sloupců nahlížecí tabulky.

2.2.2. 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 „Hledání“

2.3.1. Možnosti

• 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 vyplnění hodnot ve formuláři, na které se odkazují omezující podmínky databázového dotazu této nahlížecí tabulky.
  • Podmínky odkazující na nevyplněný ovládací prvek formuláře (u ovládacího prvku ForeignKey i na hodnotu 0) se v tomto režimu vynechají, takže k zobrazení dat stačí jediná vyplněná hodnota. Ve skupině podmínek spojených spojkou „nebo“ ale taková podmínka propustí všechny záznamy. U agregačního dotazu pole neplatí – podmínky se nevynechávají, vyhodnotí se stejně jako bez zaškrtnutého pole a data se zobrazí hned.

2.4. Záložka „Nápověda“

2.4.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. 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 v editačním formuláři.

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é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.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. 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“, „Kopírovat“, „Smazat“ a „Zavřít“

• Tlačítko „Uložit“ – Uložení změn v nastavení ovládacího prvku.
• 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. Příklady

3.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));