Editor sloupců (Editor definic sloupců)

Položka typu skrytý seznam, ve které zvolíte, jakého typu budou zobrazovaná data, resp. odkud se budou příslušné údaje čerpat. Předvyplňuje se naposledy použitý typ.

Možnosti:

Tabulka (dataset)

V tomto případě následující položka, která je k dispozici pod přepínačem, je položka typu skrytý seznam, ze kterého vyberete odpovídající položku. Nabízejí se zde položky, které jsou v daném místě programu k dispozici. Jedná se o položky tzv. datasetu a jsou dané programově, uživatelsky je nelze nijak ovlivňovat (ale bohužel ani prohlížet, jak jsou definovány).

V nabídce se zobrazuje z datasetu popisek (DisplayLabel) a v závorce výraz (FieldName) - pro jednoznačnou identifikaci.

Nezaměňujte s tabulkami z databáze a položkami těchto tabulek, k nimž existuje automaticky generovaná a dodávaná dokumentace GenDoc.chm. Zde se nejedná o položky z tabulek databáze!

Jedná se o jakýsi seznam položek, prostřednictvím kterých se v daném místě programu přistupuje k některým položkám dostupných Business objektů (BO), a jejich prostřednictvím k záznamům databáze. Typicky obsahuje všechny položky editovatelné v záložce Detail a případně některé jen zobrazovatelné. Položky jsou buď datové a ty vedou přímo na některou položku dostupného BO, nebo jsou kalkulované a ty jsou potom dle svého výrazu nějak programově napočítávány. Tedy některé položky zde dostupné naleznete i přes volbu Objekt. Na rozdíl od volby Objekt zde však můžete najít i nějaké položky počítané, které ve volbě Objekt samozřejmě nemohou být k dispozici.

Jelikož položky datasetu v daném místě programu jsou vyhodnocené a načtené do paměti, pak se dá obecně říci, že pro položku, která je k dispozici jak přes dataset, tak přes BO, bude použití definice přes tabulku (dataset) výhodnější, jelikož její zobrazení pak bude rychlejší.

Objekt

V tomto případě v následující položce musíte uvést odkaz přímo na datovou položku objektu (BO), resp. nějaký výraz. Výraz můžete zapsat ručně nebo jej můžete sestavit komfortněji pomocí Editoru výrazů, který si můžete vyvolat po stisku funkčního tlačítka (může se lišit dle verze a nastaveného vzhledu). Rozdíl od předchozí volby viz výše. Výraz může obsahovat kromě matematických a jiných funkcí také QuickReports funkce a reference na vlastnosti business objektu, k němuž se agenda váže.

Pokud tedy chcete v buňce zobrazovat např. součet hodnot ze dvou jiných položek a takový součet není jednou z napočítaných položek datasetu, pak musíte použít tento typ a nadefinovat si příslušný výraz sami. Rovněž pokud chcete v buňce zobrazovat hodnoty ze svých uživatelsky definovatelných položek, pak musíte použít tento typ, jelikož položky datasetu definovaného výrobcem se samozřejmě nemohou odkazovat na položky uživatelské.

Pokud máte zobrazen definovatelný sloupec, který obsahuje definovatelnou položku typu Celé číslo se způsobem editace Skrytý seznam nebo Svislý či Vodorovný přepínač, je místo uložené hodnoty z databáze (1,2,3,.....) zobrazen text ze seznamu hodnot v definici definovatelné položky pro příslušnou položku. Pokud je v databázi uložena hodnota, která je mimo rozsah nadefinovaných textů v definici položky, je v seznamu zobrazen text "Položka výčtu nebyla nalezena". Objasníme na příkladu:

Máte nadefinovánu a v definovatelném sloupci zobrazenu uživatelsky definovatelnou položku dle popisu výše, která může nabývat hodnot První, Druhá nebo Třetí. Pokud pak z definovatelné položky hodnotu Třetí smažete, v definovatelném sloupci bude hodnota Třetí nahrazena textem "Položka výčtu nebyla nalezena".

Nevýhodou tohoto typu jsou omezené možnosti třídění seznamu podle těchto sloupců.

Typ Objekt není k dispozici pro neobjektový dataset, např. paměťový dataset. Pro paměťové datasety se nabízí typ Výraz.

Výraz

V případě, že zobrazená data nejsou spojena přímo s určitým objektem, ale jsou přebírána z paměťového datasetu (MemoryDataset), může být nad daným seznamem k dispozici možnost definování sloupců typu Výraz.

Pro typ Výraz je následně možné zadat Položku, Třídu a samotný Výraz.

• Pokud je zadána Položka, předpokládá se, že Položka reprezentuje odkaz (ID) na Business objekt následně zadané Třídy. Ve Výrazu pak lze používat položky z tohoto business objektu.

  Tento způsob lze tedy použít pouze v případě, že jedna z položek paměťového datasetu obsahuje ID požadovaného business objektu.

• Pokud Položka zadána není, zohledňuje se pouze obsah pole Výraz, nad kterým je možné vyvolat editor výrazů nabízející položky z příslušného paměťového datasetu.

Pokud chcete poskytnout uživateli možnost definování uživatelského sloupce nad seznamem čerpajícím z paměťového datasetu v rámci skriptování, podívejte se na vzorový příklad, viz FAQ Jak připravit MemoryDataset pro definování uživatelských sloupců?

Definice nadpisu pro daný sloupec. Povinná položka.

V případě typu "Tabulka" předvyplní při výběru/změně vybrané položky nadpisem definovaným v datasetu. U sloupců typu Objekt předvyplnění není možné, zde musí nadpis sloupce uživatel zadat ručně.

Pokud se nezadá třída, ve výrazu lze používat pouze položky datasetu (obdobně jako v případě typu Tabulka) a funkce běžně nabízené v editoru výrazu.

Možné způsoby zobrazení:

• výchozí - způsobí zobrazení hodnoty v textové podobě – buď přímo textu u znakových položek nebo čísla podle masky volitelně specifikované v další záložce Maska nebo logické hodnoty prezentované v textové podobě řetězci Ano/Ne
• zatržítko - lze použít pro zobrazení logické hodnoty v seznamu jako zatrhávací položka

• procentní sloupec - umožní zobrazení procentního údaje v grafické formě zobrazující procentní díl z celku

  

  Příklad tohoto způsobu zobrazení

  Pro správné zobrazení procentuálního pokrytí je třeba, aby vracená hodnota byla v intervalu <-1,1>. Pokud už hodnota sama o sobě je vyjádřena v procentech, je třeba ji vydělit 100.

  V objednávkách přijatých si nadefinujeme sloupec, který pomocí funkce SCM vrací procentuální pokrytí dokladu v procentech. Proto ji musíme vydělit 100. Dále viz též Základní pojmy a proces SCM - Použití QuickReports funkce (QR funkce) pro zjištění pokrytí dokladů.

• datumový sloupec - umožní zobrazení datumové položky, případně položky reprezentující datum a čas; formátování je určeno maskou specifikovanou na záložce Maska

  U datumových položek si můžete zvolit, zda k jejich zobrazení použijete zobrazení Výchozí nebo Datumový sloupec. Obě varianty mají své výhody i nevýhody.

  • Výchozí zobrazení

    • Datumové hodnoty jsou před zobrazením převáděny na textový řetězec, formát zobrazení je možné ovlivnit pomocí vestavěných formátovacích funkcí - pokud do pole Výraz vyplníte hodnotu NxFormatDate('mm. ddd yyyy',CompletedDate$DATE), budou se datumy zobrazovat ve tvaru 12. úno 2015, 5. čvn 2019 a podobně.

      Příklady některých funkcí a ukázky jejich použití naleznete v kapitole Příklady použití vybraných funkcí a výrazů.

    • Pokud není datum vyplněno, zobrazí se příslušná buňka automaticky jako prázdná.

  • zobrazení Datumový sloupec

    • Datumové hodnoty jsou zpracovávány jako čísla, v poli pole Výraz je možné snadno provádět aritmetické operace typu CompletedDate$DATE+14 apod.

    • Formát zobrazení je možné určit nastavením masky na záložce Maska.

    • Pokud není datum vyplněno, zobrazí se v buňce hodnota 30.12.1899 - toto chování není možné uživatelsky ovlivnit, pokud příslušný sloupec obsahuje záznamy s nevyplněnou hodnotou, může být vhodnější použít výchozí zobrazení a formátování vyřešit formátovací funkcí.

• číselník - je třeba použít, pokud bude vybrána položka číselníkového typu (typicky končící koncovkou _ID (např. CreatedBy_ID)) ať už ve variantě Tabulka (z datasetu), Objekt (zadaná výrazem) nebo Výraz (rovněž zadaná výrazem). Naopak možnost "číselník" není k dispozici, pokud je vybrána jiná položka, než položka odkazující se přímo do nějakého číselníku (např. pokud vyberete už přímo nějakou položku z daného číselníku, např. CreatedBy_ID.ID, protože ta už sama o sobě není číselníková). Číselníkem může také být uživatelsky definovatelná položka. V případě tohoto typu zobrazení se zpřístupní položka Položka číselníku k zobrazení.

Položka typu typu přepínač, kterou určíte, jakým způsobem chcete výsledný údaj zarovnat (vlevo, na střed nebo vpravo).

Zatrhávací položka s nabídkou několika desítek systémových barev v podobě skrytého seznamu.

Je-li volba zatržena, bude se výsledný text zobrazovat zvolenou barvou, v opačném případě se použije barva z výchozího barevného schématu.

Obdoba předchozí volby, určuje barvu podkladu výsledného údaje (pozadí buňky).

Kromě systémových barev je možné zadat zcela libovolnou barvu definovanou výrazem. Výraz musí vracet index požadované barvy (celé číslo), které získáte použitím funkce RGBColor nebo HLSColor. Může se jednat o alternativu k podmíněnému formátování.

if (Margin < 0, RGBColor(255, 127, 127), if (Margin <= 10, RGBColor(255, 255, 255), RGBColor(127, 255, 127)))

V případě zatržení této položky podklad ve zvolené barvě nevyplní celou plochu buňky - místo toho se na pozadí vykreslí barevný obdélník se zaoblenými rohy a kolem něj zůstanou prázdné okraje.

Výsledný údaj se zobrazí tučně.

Výsledný údaj se zobrazí kurzívou.

Kromě výchozího formátování definovaného prostřednictvím výše uvedených položek je možné definovat také podmíněné formátování, které se uplatní pouze v případě, že obsah buňky splňuje podmínku zadanou výrazem.

Tj. pokud je na daném řádku splněna zadaná podmínka, tak se buňka vykreslí jinak (jinou barvou, tučně apod.). Pro zobrazení typu grafické procento může podmíněná barva přebít základní barvu sloupce. (Např. do 50-ti procent bude mít graf jednu barvu a nad 50% jinou barvu apod.).

Výraz můžete zapsat ručně nebo jej můžete sestavit komfortněji pomocí Editoru výrazů, který si můžete vyvolat po stisku funkčního tlačítka (může se lišit dle verze a nastaveného vzhledu). Ve výrazech jsou k dispozici funkce a data z objektů dostupných v daném místě programu, viz funkce a datové položky objektu v editoru výrazů.