Nahlížecí stránka - History

1. Základní informace

1.1. Popis ovládacího prvku

History je nahlížecí tabulka, která zobrazuje změny databázových záznamů načtené dotazem z databáze, s možností vyhledávání a filtrování záznamů, a s možností exportu dat.

• Kromě sloupců zdroje dat nabízí tabulka systémové sloupce historie: „Datum“ (datum změny), „Uživatel“ (přihlašovací jméno uživatele, který změnu provedl), „Skript“ (zdroj změny), „Vytvořeno“ (příznak vytvoření záznamu), „Smazáno“ (příznak smazání záznamu), „(ID)“ (ID změněného záznamu) a „(PID)“ (ID rodičovského záznamu).
• Ve sloupci „Skript“ se změna provedená skriptem události editačního formuláře zobrazuje jako ID formuláře a zkratka události, například „125/OBS“ („OAO“ = OnAfterOpen, „OBO“ = OnBeforeOpen, „OBS“ = OnBeforeSave, „OAS“ = OnAfterSave, „OBD“ = OnBeforeDelete, „OAD“ = OnAfterDelete), s tooltipem umístění formuláře v aplikaci a názvu události. Záznam o otevření záznamu se zobrazuje zkratkou „OPEN“ s tooltipem „OnOpen“ a změna provedená skriptem tlačítka číselnou identifikací tlačítka (u tlačítka editačního formuláře spolu s ID formuláře) s tooltipem jeho umístění v aplikaci. Ostatní hodnoty se zobrazují tak, jak jsou uložené. Detailní popis tabulky historie a uložených hodnot je uveden v samostatné příručce Editační formulář.
• Zobrazené záznamy historie jsou omezené časovým úsekem, který se volí nad tabulkou. Výchozí časový úsek začíná hodnotou pole „Od“ a končí hodnotou pole „Do“ zdroje dat; není-li pole „Od“ vyplněno, začíná měsíc před dnešním dnem, a není-li vyplněno pole „Do“, končí posledním dnem aktuálního roku.
• Časový úsek se vztahuje k datu změny. Je-li ve zdroji dat vyplněno pole „Časový úsek podle“, vztahuje se místo toho k hodnotě vybraného sloupce v řádku historie, takže se nezobrazí řádky historie, ve kterých hodnota tohoto sloupce uložená není – typicky úpravy, které ji neměnily.
• Smazaný záznam lze z historie obnovit kliknutím na hodnotu ve sloupci „Smazáno“ v řádku se smazáním záznamu (tooltip „Obnovit záznam z historie“) a potvrzením dotazu; odkaz se zobrazuje každému uživateli, který tabulku vidí. Existuje-li v databázové tabulce záznam se stejným ID, obnovení se neprovede.
• Uživatelům s administrátorským oprávněním se v záhlaví tabulky zobrazuje ikona „Smazat historii“, která trvale smaže všechny záznamy historie odpovídající podmínkám zdroje dat, aktuálnímu filtru, hledání a časovému úseku, tedy nejen záznamy zobrazené na aktuální stránce.

1.2. Vytvoření nového ovládacího prvku

Novou history 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á history umístěna. 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 „History“, 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é history na předem vybrané místo nahlížecí stránky.
• Nedojde-li před vložením nové history k určení požadované pozice, bude nová history vložena 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. Název

• Název ovládacího prvku zobrazovaný v záhlaví nahlížecí tabulky.

2.1.2. 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.3. Šíř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.4. 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.5. Možnosti

• 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.
• 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.
• 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é“.

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.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.
  • Na mobilním zařízení se tooltip nezobrazuje.

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“.

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. 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.7. Tlačítka „Uložit“, „Uložit všem uživatelům“, „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 „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í této history u aktuálního uživatele; ostatní jeho individuální nastavení, například řazení, počet záznamů na stránce, mřížka, hledání a složený filtr, zůstane zachováno; hodnoty vybrané ve filtrech sloupců se smažou.
  • Individuální nastavení history 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é history.
  • Individuální nastavení history zahrnuje tyto možnosti:
    • Možnosti na záložce „Obecné“ individuálního nastavení history
      • „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í history
    • Nastavení sloupců na záložce „Detaily“ individuálního nastavení history
  • 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í této history všem ostatním uživatelům, aby při prvním novém zobrazení této history bylo použito výchozí nastavení definované v tomto dialogu. Individuální nastavení aktuálního uživatele se upraví stejně jako tlačítkem „Uložit“.
• 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.