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

01-zalozka-obecne.png

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. 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ů.
  • Zobrazení nahlížecí tabulky ovlivňují také některé zápisy v poznámkách databázového dotazu. Detailní popis 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 – archiv obsahující soubor některého z výše uvedených formátů; zpracuje se první soubor v archivu
    • U nahlížecí tabulky, která čte data z databázového pohledu, se ikona nezobrazuje. Uživatelům s administrátorským oprávněním se zobrazuje u každé jiné řádkové nahlížecí tabulky, i bez zaškrtnutí tohoto pole.
    • 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í“.
    • Import probíhá v dialogu ve třech krocích: výběr souboru, výběr tabulky (u souboru MS Excel listu a řádku s hlavičkou) a přiřazení sloupců souboru ovládacím prvkům. Dokud uživatel žádný sloupec nepřiřadí ručně, přiřadí se sloupce souboru automaticky podle shody s názvem nebo identifikátorem ovládacího prvku.
    • Volba „Jsem vlastníkem importovaných dat“ nastaví nově zakládaným záznamům jako vlastníka importujícího uživatele; bez ní zůstanou nové záznamy bez vlastníka. Při importu podle sloupce ID se vlastník nenastavuje.
    • Volba „Hodnoty ForeignKey jsou ID - zakázat hledání ID podle importované hodnoty“ uloží hodnoty cizích klíčů jako číselné identifikátory. Bez ní se ke každé hodnotě hledá záznam, jehož hodnota v dotazu hodnot cizího klíče se s ní shoduje, a na číslo se převede jen hodnota, která se nenajde.
    • Bez importu sloupce ID se vazba na rodičovský záznam (PID, PForm) zapíše jen ze sloupců souboru, které jsou k ní přiřazené; jinak zůstanou nové záznamy bez rodičovského záznamu.
    • Každý řádek se ukládá samostatně. Chyba na některém řádku import ukončí a řádky uložené před ní zůstanou v databázi.
  • 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 nebo XLSX. 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.
    • Import pouze aktualizuje existující záznamy; záznam se hledá podle skrytého sloupce s ID záznamu. Řádky bez ID nebo s ID neexistujícího záznamu a záznamy, které uživatel nesmí měnit, se přeskočí. Zpracuje se jen první list souboru, data se čtou od třetího řádku a jen ze sloupců, jejichž identifikátor je uvedený ve skrytém prvním řádku.
    • Hodnoty prvků RichTextBox, MultiListBox, File a Image, prvků „Jen ke čtení“ a prvků, jejichž hodnotu vidí jen vlastník nebo spoluvlastník záznamu, se neimportují.
    • Na rozdíl od „Povolit import dat“ spouští import ukládací skripty editačního formuláře a záznamy zařazuje do synchronizace; historie změn se zapíše, pokud ji editační formulář nemá zakázanou. Každý řádek se ukládá samostatně: chyba na některém řádku import ukončí a v hlášení uvede číslo řádku, řádky uložené před ní zůstanou v databázi. Skončí-li chybou až skript „OnAfterSave“, zůstane v databázi uložený i řádek, u kterého chyba nastala.
    • Tato funkce je k dispozici pouze u nahlížecích tabulek, které nepoužívají joinování a nečtou data z databázového pohledu.
  • 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.
      • U nahlížecí tabulky, která čte data z databázového pohledu, se toto pole neuplatní – hodnoty nelze měnit v buňce ani pomocí položky „Přiřadit hodnotu...“.
      • 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 hodnotu přímo v buňce nahlížecí tabulky 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 „Filtr“.
      • Filtry sloupců, a tedy i položku „Přiřadit hodnotu...“, má k dispozici také anonymní uživatel. Všichni anonymní návštěvníci přitom sdílejí jeden uživatelský účet.
      • 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ů.
      • Patří-li sloupec připojenému editačnímu formuláři, přiřadí se hodnota záznamům připojeného formuláře ze všech řádků nahlížecí tabulky, jejichž záznam je označený, resp. ze všech vyfiltrovaných řádků – u spojení, kde jednomu záznamu odpovídá více připojených záznamů, tedy všem připojeným záznamům označeného záznamu; právo na změnu záznamu se vyhodnocuje podle připojeného formuláře.
      • 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í.
      • Má-li ovládací prvek zaškrtnuté pole „Vyžadované pole“, prázdnou hodnotu mu přiřadit nelze.
      • Skripty „OnBeforeSave“ a „OnAfterSave“ editačního formuláře se při přiřazení hodnoty spustí pro každý záznam zvlášť jen u ovládacího prvku se zaškrtnutým polem „Spustit OnBeforeSave/OnAfterSave před uložením záznamu do databáze“; u ostatních ovládacích prvků se hodnota přiřadí bez spuštění skriptů.
      • 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ů! Najednou lze smazat nejvýše 1000 záznamů; bez tohoto omezení maže jen vestavěný účet „Administrator“.
      • 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ů.
      • Záznamy, které uživatel smazat nesmí, a záznamy, jejichž smazání zamítne skript „OnBeforeDelete“ chybou, se přeskočí a jejich počet se po smazání zobrazí v hlášení. Mezi chyby se započte i chyba skriptu „OnAfterDelete“, přestože je záznam už smazaný. Záznam, jehož smazání skript přeskočí funkcí SKIPDELETE(), se nesmaže a v hlášení se nezapočte.
      • 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, s výjimkou nahlížecí tabulky v portletu na hlavní stránce a ve výběrovém dialogu.
      • Uživateli s administrátorským oprávněním se před smazáním zobrazí dotaz, zda se mají u mazaných záznamů spustit skripty „OnBeforeDelete“ a „OnAfterDelete“. Uživateli bez administrátorského oprávnění se záznamy mažou vždy jednotlivě a se spuštěním těchto skriptů. Systémové záznamy se nesmažou nikdy.
      • 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.
  • 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.
  • 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é“.
  • 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“. Skryjí se proto i záznamy, které mají PID nevyplněné (databázová hodnota „null“).

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 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í. Vybrané období zůstane uživateli vybrané v individuálním nastavení i při dalším zobrazení nahlížecí tabulky, dokud ho opakovaným kliknutím nezruší. Chybí-li vybrané období v datech, zobrazí se všechna období a nejbližší akcí v nahlížecí tabulce se výběr zruší. V portletu se vybrané období 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ů.

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ů.
    • Filtr se nabízí jen u sloupců, jejichž ovládací prvek má zaškrtnuté pole „Zobrazit filtr v nahlížecí tabulce“; nemá-li ho žádný sloupec nahlížecí tabulky, filtry se nezobrazí.
    • Je-li nastavený složený filtr, zruší ikona „Zrušit filtry...“ nejdřív jen jej; filtry sloupců zruší až další kliknutí.

2.2.2. Sloupce

  • Definice výchozího nastavení sloupců nahlížecí tabulky.
  • U existujícího ovládacího prvku nabízí odkaz „...“ pod popiskem „Sloupce“ položku „Importovat sloupce uživatele“ s přihlašovacím jménem přihlášeného uživatele, která vybere sloupce podle jeho individuálního nastavení nahlížecí tabulky. Výchozí nastavení se změní až uložením ovládacího prvku.

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.
    • Je-li pole zaškrtnuté, hledá se v nahlížecí tabulce i ve sloupcích detailů, které v nahlížecí tabulce nejsou zobrazené; při optimalizovaném hledání dostanou vlastní pole pro vyhledávání i tyto sloupce. Netýká se to sloupců, jejichž hodnota je zobrazena pouze vlastníkovi nebo spoluvlastníkovi záznamu.
  • 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.
    • Na mobilním zařízení se tooltip nezobrazuje.

2.3.2. Sloupce

  • Definice výchozího nastavení sloupců detailů.
  • U existujícího ovládacího prvku nabízí odkaz „...“ pod popiskem „Sloupce“ položku „Importovat sloupce uživatele“ s přihlašovacím jménem přihlášeného uživatele, která vybere sloupce podle jeho individuálního nastavení detailů. Výchozí nastavení se změní až uložením ovládacího prvku.
  • Mezi sloupci detailů lze vybrat i nahlížecí tabulky (DataGrid a LiteDataGrid) zdrojového editačního formuláře. V panelu detailů se vykreslí jako vnořená nahlížecí tabulka vyhodnocená pro zobrazený záznam.

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“.
    • Na mobilním zařízení s malým displejem se řádek automaticky nezobrazuje. Bez ohledu na toto pole se řádek zobrazí, je-li zadaný hledaný výraz nebo existují-li pro nahlížecí tabulku uložené šablony složeného filtru.
    • Detailní popis zápisu hledaného výrazu (mezery, uvozovky, spojky, svislítko „|“) je uveden v samostatné příručce Základy práce s aplikacemi. Způsob hledání v jednotlivém sloupci určuje pole „Hledání v nahlížecí tabulce“ jeho ovládacího prvku. Sloupec s volbou „CONTAINS (MSSQL Full-Text)“ se na databázi MS SQL Server prohledává fulltextovým indexem po celých slovech – svislítko na začátku slova vyhledá slova, která jím začínají, svislítko na konci slova se nebere v úvahu; na jiné databázi se takový sloupec prohledává stejně jako s volbou „LIKE (obsahuje)“. Zaškrtnutím takového sloupce pro hledání se na kterékoli databázi zruší zaškrtnutí ostatních sloupců.
  • Optimalizované hledání
    • Zaškrtnutí tohoto pole určuje, zda má mít každý sloupec nahlížecí tabulky vlastní pole pro vyhledávání.
    • Výraz zadaný do pole sloupce se hledá jen v tomto sloupci a záznam musí vyhovět všem vyplněným polím. Zda se hledaný výraz vyhodnocuje v databázi, nebo až nad načtenými daty, určuje pole „Zobrazit pouze výsledky hledání“.
  • 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. Výjimkou jsou ovládací prvky s fulltextovým indexem na databázi MS SQL Server, ve kterých se hledaný výraz vyhledá dotazem do databáze i v tomto případě. U příloh (File a Image) se z databáze načtou názvy souborů a hledaný výraz se v nich vyhodnotí vždy až nad načtenými daty, tedy bez ohledu na nastavení tohoto pole i databáze; dotazem do fulltextového katalogu se vyhledává jen obsah souborů (viz Editační formulář – File). Nad načtenými daty se v tomto případě vyhodnocují také filtry sloupců a složený filtr; složený filtr s hodnotou #weekend# se ale vyhodnotí v databázi.
    • Nad načtenými daty se vyhodnocuje i řazení nahlížecí tabulky, které proto na nastavení databáze rovněž nezávisí. Je-li ale omezen počet načtených záznamů, rozhoduje o tom, které záznamy se vůbec načtou, řazení v databázi a u textových hodnot porovnávací pravidla databáze. Při zaškrtnutém „Zobrazit pouze výsledky hledání“ se řazení do databázového dotazu promítne jen tehdy, má-li dotaz nastavené řazení podle jiného sloupce než ID; jinak se načte libovolná část vyhovujících záznamů, a proto je vhodné řazení v dotazu nastavit.
    • 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.
    • Sloupce na záložkách „Nahlížecí tabulka“ a „Detaily“ a možnosti „Počet záznamů na stránce“, „Zobrazit horní navigační lištu“, „Zobrazit filtry“, „Zobrazit součty sloupců“, „Zobrazit detaily“ a „Zobrazit tooltip“ z tohoto dialogu se převezmou do individuálního nastavení tohoto datagridu u aktuálního uživatele; ostatní jeho individuální nastavení, například řazení, mřížka, hledání a složený filtr, zůstane zachováno; hodnoty vybrané ve filtrech sloupců se smažou. Smaže se také jeho nastavení portletu s tímto datagridem.
    • 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
    • U všech ostatních uživatelů zůstane jejich individuální nastavení zachováno. Je-li zaškrtnuté pole „Zakázat uživatelské přizpůsobení“, smaže se jejich individuální nastavení stejně jako tlačítkem „Uložit všem uživatelům“.
  • Tlačítko „Uložit všem uživatelům“ – Uložení změn v nastavení ovládacího prvku a smazání individuálního nastavení tohoto datagridu všem ostatním uživatelům, aby při prvním novém zobrazení tohoto datagridu bylo použito výchozí nastavení definované v tomto dialogu. Všem uživatelům se smaže také nastavení portletů s tímto datagridem, a má-li účet Administrator k tomuto datagridu uloženou šablonu složeného filtru, smažou se i šablony složeného filtru ostatních uživatelů kromě účtu Administrator. Individuální nastavení aktuálního uživatele se upraví stejně jako tlačítkem „Uložit“.
  • 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“.
  • Je-li statistická nahlížecí tabulka (mimo kontingenční tabulku) seskupená podle data i podle dalších sloupců a řazená podle prvního seskupovacího sloupce, v řádcích se stejnými hodnotami všech seskupovacích sloupců jako v předchozím řádku se hodnoty seskupovacích sloupců nevypisují a řádky zůstávají v pořadí, ve kterém je vrátil databázový dotaz.
  • 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. V NET Genium Online se licence nevynucují, takže se tam záznamy neomezují ani bez licenčního klíče.
  • Statistická nahlížecí tabulka zobrazuje 20 řádků na stránce; počet záznamů na stránce si uživatel může změnit v liště stránkování, která se zobrazí, má-li tabulka více řádků, než se vejde na jednu stránku, a změna se mu uloží do individuálního nastavení. Na nahlížecí stránce ani v editačním formuláři nemá statistická nahlížecí tabulka dialog individuálního nastavení, hledání ani filtry v záhlaví sloupců.
  • U běžného dotazu lze nahlížecí tabulku kliknutím na záhlaví sloupce seřadit podle sloupců ovládacích prvků TextBox, ComboBox, ListBox, Radio, CheckBox, ForeignKey, DatePicker a AutoSum. Sloupec ForeignKey se řadí podle hodnoty uložené v databázi, tedy zpravidla podle ID odkazovaného záznamu, ne podle zobrazeného textu. Kliknutí na záhlaví seřadí tabulku vzestupně podle tohoto sloupce a zruší druhé řazení, opakované kliknutí obrátí směr řazení. Tlačítko „Výchozí třídění“ vrátí řazení podle databázového dotazu.
  • Statistickou nahlížecí tabulku lze seřadit kliknutím na záhlaví sloupce, vždy jen podle jednoho sloupce; opakované kliknutí obrátí směr řazení a zvolené řazení se uloží do individuálního nastavení. Výchozí řazení určuje první sloupec, jehož čtvrtá část názvu (podmínka) končí textem „ASC“ nebo „DESC“, například „Počet@@@DESC“; nemá-li to žádný sloupec, řadí se podle prvního sloupce ve směru řazení nastaveném v návrháři databázových dotazů. Tlačítko „Výchozí třídění“ výchozí řazení obnoví. Detailní popis syntaxe názvů sloupců je uveden v samostatné příručce Návrhář databázových dotazů.

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.
  • U agregačního dotazu nese řádek součtů 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ů. Detailní popis typů sloupců je uveden v samostatné příručce Návrhář databázových dotazů.
  • Při 1000 a více záznamech počítá součty kvůli rychlosti databáze, ale jen nemá-li dotaz externí funkci a nenarazil-li na omezení „Načíst pouze prvních“; výsledek je proto stejný jako při výpočtu z načtených dat. Je-li v dotazu nastavené „Odstranit záznamy s duplicitním“, počítají se součty vždy z načtených dat.

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í a v instalaci se souborem „SimpleClick.txt“ v adresáři „Config“ stačí na řádek kliknout. Je-li zaškrtnuté „Zobrazit detaily“, kliknutí na řádek zobrazí detaily záznamu a záznam se otevírá odkazem, dvojklikem nebo z nabídky popsané v kapitole Panel detailů.
  • 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.
  • Je-li prvním seskupovacím sloupcem agregačního dotazu ID, nese každý řádek statistické nahlížecí tabulky odkaz na otevření záznamu; sloupec ID se do exportu nezahrne.

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.
  • Dialog individuálního nastavení (ikona ozubeného kolečka) nabízí mimo mobilní zařízení také záložku „Export/Import“. Tlačítko „Exportovat nastavení tabulky“ vypíše do pole „Moje nastavení“ nastavení zobrazené v dialogu – řazení, počet záznamů na stránce, možnosti ze záložky „Obecné“ a sloupce nahlížecí tabulky a detailů – a tlačítko „Exportovat hledání a filtry“ uložený hledaný výraz, filtry sloupců a složený filtr. Tlačítko „Importovat“ načte text vložený do pole: nastavení tabulky převezme do dialogu, kde je nutné ho uložit tlačítkem „Uložit“; hledání a filtry uloží rovnou do individuálního nastavení spolu s nastavením zobrazeným v dialogu.
  • Uživatelům s administrátorským oprávněním nabízí dialog také záložku „Uložit více uživatelům“. Tlačítko „Uložit více uživatelům“ přepíše vybraným uživatelským skupinám a uživatelům individuální nastavení nahlížecí tabulky podle dialogu – řazení, počet záznamů na stránce, možnosti ze záložky „Obecné“ a sloupce; sloupce jen tehdy, není-li zaškrtnuté pole „Zakázat uživatelské přizpůsobení“.
  • Ikona „Skrýt“ v záhlaví nahlížecí tabulky skryje data nahlížecí tabulky a ikona „Zobrazit“ je zobrazí znovu. Stav se uloží do individuálního nastavení a platí i při dalším zobrazení nahlížecí tabulky. Dokud jsou data skrytá, nelze přiřadit hodnotu ani mazat záznamy.
  • Anonymnímu uživateli se individuální nastavení neukládá a nemá k dispozici přizpůsobení nahlížecí tabulky ani složený filtr. Výjimkou je výběr sloupců nahlížecí tabulky: ten se anonymnímu účtu uloží při prvním zobrazení nahlížecí tabulky a sdílejí ho všichni anonymní návštěvníci. Po změně výchozích sloupců ovládacího prvku je proto nutné použít tlačítko „Uložit všem uživatelům“.
  • Sloupce, ke kterým uživatel nemá oprávnění, se z jeho individuálního nastavení při uložení odstraní.
  • V NET Genium Online uloží uživatel s administrátorským oprávněním uložením individuálního nastavení (i tlačítkem „Uložit více uživatelům“) zároveň výchozí nastavení ovládacího prvku, smí-li ovládací prvek měnit: převezmou se možnosti „Počet záznamů na stránce“, „Zobrazit horní navigační lištu“, „Zobrazit filtry“, „Zobrazit součty sloupců“, „Zobrazit detaily“ a „Zobrazit tooltip“ a sloupce nahlížecí tabulky a detailů. Řazení a mřížka se do výchozího nastavení nepřevezmou a individuální nastavení ostatních uživatelů zůstane zachováno.
  • Pole „Zobrazit mřížku“ je jen součástí individuálního nastavení; výchozí nastavení ovládacího prvku ho neurčuje. Statistická nahlížecí tabulka zobrazuje mřížku vždy, s výjimkou portletu.

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#) a speciální hodnoty #random# a #weekend#; hodnota #dayrandom# v nich dá vždy 0. Hodnota #weekend# funguje jen ve složeném filtru celé nahlížecí tabulky; ve složené podmínce filtru sloupce (položka „Vlastní...“) vybere záznamy s prázdným datem.
  • Podmínky složeného filtru nad sloupci, ke kterým uživatel bez administrátorského oprávnění nemá oprávnění, se vynechají. Složený filtr s více než 100 podmínkami se neuplatní vůbec.
  • Na záložce „Šablony“ dialogu „Složená podmínka“ (jen u složeného filtru celé nahlížecí tabulky) lze podmínku zaškrtnutím pole „Uložit jako šablonu...“ uložit jako šablonu pod názvem z pole „Název šablony“. Pole „Uspořádat šablony“ nabízí šablony, které má uživatel uložené k databázovému dotazu této nahlížecí tabulky (sdílí je i další nahlížecí tabulky nad týmž dotazem); jejich pořadí a odebrání se uloží spolu s dialogem. Dialog lze uložit jen s alespoň jednou podmínkou, která se zároveň použije jako složený filtr – samotné uspořádání nebo odebrání šablon bez podmínky uložit nelze.
    • Při zaškrtnutém poli „Uložit jako šablonu...“ může administrátor zaškrtnout pole „Uložit více uživatelům...“ a vybrat uživatelské skupiny a uživatele. Každému z nich se šablona přidá a podmínka se mu zároveň uloží jako složený filtr databázového dotazu této nahlížecí tabulky – jeho dosavadní složený filtr se nahradí.
  • 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í“.

3.6. Panel detailů

  • Je-li zaškrtnuté pole „Zobrazit detaily“, zobrazí se pod nahlížecí tabulkou panel s detaily záznamu, na jehož řádek uživatel klikne.
  • Při načtení nahlížecí tabulky zobrazí panel naposledy zobrazený záznam. Není-li tento záznam na aktuální stránce nahlížecí tabulky, zobrazí se záznam, který byl v tabulce na řádku nad ním, a není-li ani ten, záznam z prvního řádku.
  • Naposledy zobrazený záznam se ukládá každému uživateli zvlášť; anonymnímu uživateli se neukládá.
  • Panel vynechává sloupce s prázdnou hodnotou; zaškrtávací pole zobrazuje vždy. Nezbude-li po vynechání prázdných hodnot nic k zobrazení, panel se skryje.
  • Je-li vyplněný konfigurační soubor „Config\GoogleTranslationApiKey.txt“, nabízí panel přihlášenému uživateli ikonu „Přeložit...“ pro překlad zobrazeného textu službou Google Translation API. Detailní popis konfiguračního souboru je uveden v samostatné příručce Nastavení NET Genia.
  • Dvojklik na panel otevře zobrazený záznam stejně jako dvojklik na jeho řádek, tedy jen v uživatelském režimu.
  • Klikne-li uživatel znovu na řádek, jehož detaily panel zobrazuje, zobrazí se u řádku nabídka s položkami „Zobrazit detaily“ (posune stránku k panelu), „Upravit záznam...“ a „Otevřít záznam na nové záložce (v novém okně)...“. Na mobilním zařízení se nabídka zobrazí po každém kliknutí na řádek.
  • Kliknutí do panelu nabídne „Zpět“ (návrat k řádku záznamu), „Upravit záznam...“, „Otevřít záznam na nové záložce (v novém okně)...“, „Zobrazit odkaz“ (zkopíruje odkaz na záznam do schránky), „Předchozí záznam“ a „Další záznam“. Ikona „Zobrazit odkaz“ se nabízí za stejných podmínek jako ikona odkazu v pravém horním rohu nahlížecí stránky, popsaná v samostatné příručce Nahlížecí stránka, a na mobilním zařízení se nenabízí.
  • Obě nabídky se zobrazují jen u záznamu, který lze z nahlížecí tabulky otevřít, a ne tehdy, je-li na stránce označený text; ve výběrovém dialogu ani v portletu se nezobrazují.
  • Klávesové zkratky Ctrl+šipka nahoru a Ctrl+šipka dolů zobrazí v panelu předchozí, resp. následující záznam. Totéž dělají ikony šipek nahoru a dolů v panelu. Na prvním a posledním řádku stránky přejdou zkratky i ikony na předchozí, resp. následující stránku nahlížecí tabulky.
  • Klávesová zkratka Ctrl+Enter otevře vybraný záznam stejně jako dvojklik na jeho řádek; v editačním formuláři s tlačítkem „Uložit“ místo toho uloží editační formulář.

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#