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
• Objekt
• Výraz

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

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.

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 /. 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é.

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

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.

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

• obrázek ze seznamu - ve sloupci je možné zobrazit systémový obrázek (ikonu), která je v seznamu obrázků. Seznam se zobrazí kliknutím na informační ikonu označenou na obrázku níže.
  
  

  Seznam obrázků je systémový, tzn. nelze obrázky měnit za vlastní. Každý obrázek je označen vlastním číslem, které následně lze použít ve výrazu, kterým se učí, jaký obrázek zobrazit. Pro lepší představu o využití v praxi si uvedeme jeden příklad
  

  V agendě Firmy máme záznamy s kompletně vyplněnými adresami. Máme zde firmy jak z České republiky, tak také z Německa, Velké Británie nebo USA. Abychom měli seznam firem přehlednější budeme si chtít označit tuzemské firmy obrázkem číslo 5. Německé firmy obrázkem číslo 8, firmy z USA obrázkem číslo 4. Pokud bude firma z jiné země než výše uvedené zobrazí se obrázek číslo 15. Firmy, které nemají vyplněn Kód země si označíme obrázkem číslo 10.

  Do výrazu tedy zadáme následující:

  if (ResidenceAddress_ID.CountryCode='CZ', 5,
  if (ResidenceAddress_ID.CountryCode='DE', 8, 
  if (ResidenceAddress_ID.CountryCode='US', 4,
  if (ResidenceAddress_ID.CountryCode='', 10, 15 ))))

  Seznam firem bude následně vypadat přibližně jako na obrázku.
  

  
  
  
  
  

  Výše uvedený příklad je jen ilustrací využití obrázků v kombinací s funkcí If. reálné využití může být mnohem širší.
  

• čí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 /// (v závislosti na verzi systému a na nastavení 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ů.