Článek: AN0001604Aktualizováno:: 03.12.2018
Každá třída nebo dotaz obsahuje sloupce s daty. Ve sloupcích tříd jsou data reálně uložena. Sloupce dotazů představují pouze zobrazení dat.
Mezi sloupci třídy a dotazu je několik rozdílů - viz. následující tabulka.
| |
Sloupce třídy |
Sloupce dotazu |
| Vytvoření sloupce |
Každá třída má několik systémových sloupců, které se vytvářejí automaticky.
Další sloupce lze libovolně přidávat, měnit či mazat.
|
Sloupce lze definovat jen pomocí definice SQL dotazu. |
| Změna sloupců |
Většinu nastavení sloupce lze po jeho vytvoření měnit. |
Sloupce lze měnit jen omezeně, hlavně vlastnosti pro zobrazení. |
| Typy sloupců |
Lze využít všechny typy sloupců. |
Některé typy sloupců nelze v dotazu použít, např. soubor, odkaz na třídu. |
Systémové sloupce
Po vytvoření každé třídy jsou zároveň vytvořeny systémové sloupce. Ty slouží pro identifikaci dat v odkazech a určení původu dat pro audit. Dotazy systémové sloupce nemají.
Následující tabulka uvádí jejich přehled systémových sloupců.
| Kódy sloupce |
Popis |
| id |
ID záznamu |
| shortdescription |
Krátký popis záznamu |
| creator |
Účet uživatele, který záznam vytvořil |
| created |
Datum vytvoření |
| modifier |
Účet uživatele, který záznam naposledy změnil |
| modified |
Datum poslední změny |
| deleter |
Účet uživatele, který záznam smazal |
| deleted |
Datum smazání |
| createddatasourceid |
Id datového zdroje pro vytvoření záznamu |
| modifieddatasourceid |
Id datového zdroje pro poslední změnu záznamu |
| deleteddatasourceid |
Id datového zdroje pro smazání záznamu |
Hodnoty v systémových sloupcích určuje systém ObjectGears a nelze je měnit ani pomocí skriptu.
Jedinou výjimkou je sloupec ShortDescription, jehož hodnota je určena na základě vlastnosti Formát popisu, který je definovaný uživatelem v detailu třídy. Hodnota v tomto sloupci reprezentuje celý záznam a používá se pro zobrazení v odkazech na jinou třídu.
Zobrazení
Na seznamu záznamů třídy nejsou systémové sloupce ve výchozím stavu zobrazovány. Pokud je chcete zobrazit, musíte jim explicitně nastavit vlastnost Zobrazit v seznamu.
V detailu záznamu třídy jsou auditní sloupce zobrazeny v sekci Auditní informace.
Tato sekce je ve výchozím stavu sbalena a pro zobrazení je nutné kliknout na její název.
V titulku stránky je zobrazena hodnota sloupce ID.
V seznamu sloupců třídy nejsou systémové sloupce standardně zobrazovány, pro jejich zobrazení musíte odškrtnout volbu Zobrazit bez systémových sloupců.
Příklad: Zobrazení bez systémový sloupců.
Příklad: Zobrazení včetně systémový sloupců.
Typy sloupců
Systém ObjectGears podporuje několik základních typů sloupců, které mohou být použity ve třídě či dotazu. Se sloupcem lze pracovat i ve skriptu (čtení/zápis) pomocí metod objektu OG.DataRow. Kompletní přehled metod naleznete v dokumentaci tohoto objektu. Níže uvedená tabulka uvádí pouze hlavní metody pro čtení z/zápis do sloupců.
Stránka pro vložení nového sloupce umožňuje hromadné vytvoření předdefnovaných sloupců. Tyto sloupce jsou založeny na základních sloupcích a jsou již nakonfigurovány pro konkrétní určení. Použití předdefinovaných sloupců může uživateli ušetřit čas vytvoření třídy. Tyto sloupce lze po vložení libovolně měnit. Jedná se např. o sloupce Název, Pořadí, Email... K dispozici je i několik sloupců při použití třídy pro uložení úkolů ve workflow.
Vlastnosti sloupců
Sloupce mají řadu vlastností, které závisejí na typu sloupce. V níže uvedené tabulce naleznete popis obecných vlastnosti platných pro všechny sloupce. Další vlastnosti jsou popsány u konkrétního typu sloupce.
| Název |
Popis |
| Třída/Dotaz |
Definuje do jaké třídy nebo dotazu sloupec patří. |
| Id |
Jedinečný identifikátor sloupce. Generuje se automaticky. |
| Kód |
Kód sloupce. Je jedinečný v rámci dané třídy/dotazu. |
| Název |
Název sloupce. Pod tímto názvem se sloupec zobrazuje na formulářích. Jedná se o lokalizovaný atribut (různé hodnoty pro různé jazyky). |
| Popis |
Popis sloupce. Tento text se zobrazuje v detailu záznamu drobným písmem pod názvem sloupce. Jedná se o lokalizovaný atribut (různé hodnoty pro různé jazyky). |
| Typ sloupce |
Typ sloupce. |
| Povinné |
Příznak, zda je sloupec povinný a musí být zadán v detailním formuláři. |
| Text nápovědy |
Text nápovědy sloupce, který se zobrazí po najetí myši na ikonu otazníku u sloupce v detailním formuláři. Jedná se o lokalizovaný atribut (různé hodnoty pro různé jazyky). |
| Povolit editaci při vytváření |
Příznak, zda je možné sloupec nastavit na detailním formuláři při vytvářené nového záznamu. |
| Povolit editaci při změně |
Příznak zda je možné sloupec nastavit na detailním formuláři při změně záznamu. |
| Sloupec v DB |
Pro sloupce ukládáné přímo do tabulky je zde název sloupce v databázi. |
Vzorce
Vzorce se aplikují na sloupce, i když nemají nastaveno Povolit editaci.... Hodnota vypočtená vzorcem v detailu sloupce nebo pravidlem (skriptem atd.) třídy se vždy uloží bez ohledu na příznaky Povolit editaci....
Zobrazit přes celý řádek
Standardně se sloupce na formuláři zobrazují ve dvou sloupcích. Pro některé sloupce je však vhodné je rozšířit přes celou šírku formuláře. K dispozici jsou tři hodnoty - viz obrázky níže:
Řazení sloupců
Pro řazení sloupců v seznamu sloupců nebo v detailu záznamu slouží stránka Nastavení vzhledu formuláře.
Sumární informace
Pro některé typy sloupců (datum, celé nebo desetinné číslo) je možné na stránce se seznamem záznamů zobrazit sumární informace (min, max, sum, avg). Ty jsou počítány ze všech vyhledaných záznamů bez ohledu na stránkování. Tzn. pokud je nalezeno 100 záznamů, ale máte zobrazenou první sadu 20-ti záznamu, tak sumární informace jsou počítány ze všech 100 záznamů.
V nastavení sloupce lze zadat ve vlastnosti Formát zobrazení V seznamu zobrazit součtové informace. Pokud je tato definice formátu chybná, pak se místo v sumárním řádku pod sloupcem zobrazí otazník ?.