Editor stĺpcov (Editor definícií stĺpcov)

Položka typu skrytý zoznam, v ktorej zvolíte, akého typu budú zobrazované dáta, resp. odkiaľ sa budú príslušné údaje čerpať. Predvypĺňa sa naposledy použitý typ.

Možnosti:

Tabuľka (dataset)

V tomto prípade nasledujúca položka, ktorá je k dispozícii pod prepínačom, je položka typu skrytý zoznam, z ktorého vyberiete príslušnú položku. Ponúkajú sa tu položky, ktoré sú v danom mieste programu k dispozícii. Ide o položky tzv. datasetu a sú dané programovo, užívateľsky ich nie je možné ovplyvňovať (ale bohužiaľ ani prehliadať, ako sú definované).

V ponuke sa zobrazuje z datasetu popisok (DisplayLabel) a v zátvorke výraz (FieldName) - na jednoznačnú identifikáciu.

Nezamieňajte s tabuľkami z databázy a položkami týchto tabuliek, ku ktorým existuje automaticky generovaná a dodávaná dokumentácia GenDoc.chm. Tu sa nejedná o položky z tabuliek databázy!

Ide o akýsi zoznam položiek, prostredníctvom ktorých sa v danom mieste programu pristupuje k niektorým položkám dostupných Business objektov (BO), a pomocou nich k záznamom databázy. Typicky obsahuje všetky položky editovateľné v záložke Detail a prípadne niektoré len zobraziteľné. Položky sú buď dátové a tie vedú priamo k niektorej položke dostupného BO, alebo sú kalkulované a tie sú potom podľa svojho výrazu nejako programovo napočítavané. Takže niektoré tu dostupné položky nájdete aj pomocou voľby Objekt. Na rozdiel od voľby Objekt tu však môžete nájsť aj nejaké položky počítané, ktoré vo voľbe Objekt samozrejme nemôžu byť k dispozícii.

Nakoľko položky datasetu v danom mieste programu sú vyhodnotené a načítané do pamäte, dá sa všeobecne povedať, že pre položku, ktorá je k dispozícii ako cez dataset, tak cez BO, bude použitie definície cez tabuľku (dataset) výhodnejšie, keďže jej zobrazenie tak bude rýchlejšie.

Objekt

V tomto prípade v nasledujúcej položke musíte uviesť odkaz priamo na dátovú položku objektu (BO), resp. nejaký výraz. Výraz môžete zapísať ručne alebo ho môžete zostaviť komfortnejšie pomocou Editora výrazov, ktorý si môžete vyvolať po stlačení funkčného tlačidla (môže sa líšiť podľa verzie a nastaveného vzhľadu). Rozdiel od predchádzajúcej voľby viď vyššie. Výraz môže obsahovať okrem matematických a iných funkcií tiež QuickReports funkcie a referencie na vlastnosti business objektu, ku ktorému sa agenda viaže.

Pokiaľ teda chcete v bunke zobrazovať napr. súčet hodnôt z dvoch iných položiek a tento súčet nie je jednou z napočítaných položiek datasetu, musíte použiť tento typ a nadefinovať si príslušný výraz sami. Taktiež pokiaľ chcete v bunke zobrazovať hodnoty zo svojich užívateľsky definovateľných položiek, tak musíte použiť tento typ, pretože položky datasetu definovaného výrobcom sa samozrejme nemôžu odkazovať na položky užívateľské.

Pokiaľ máte zobrazený definovateľný stĺpec, ktorý obsahuje definovateľnú položku typu Celé číslo so spôsobom editácie Skrytý zoznam alebo Zvislý či Vodorovný prepínač, je namiesto uloženej hodnoty z databázy (1,2,3,.....) zobrazený text zo zoznamu hodnôt v definícii definovateľnej položky pre príslušnú položku. Pokiaľ je v databáze uložená hodnota, ktorá je mimo rozsahu nadefinovaných textov v definícii položky, je v zozname zobrazený text "Položka zoznamu nebola nájdená". Objasníme na príklade:

Máte nadefinovanú a v definovateľnom stĺpci zobrazenú užívateľsky definovateľnú položku podľa popisu vyššie, ktorá môže nadobúdať hodnoty Prvá, Druhá alebo Tretia. Pokiaľ potom z definovateľnej položky hodnotu Tretia zmažete, v definovateľnom stĺpci bude hodnota Tretia nahradená textom "Položka zoznamu nebola nájdená".

Nevýhodou tohto typu sú obmedzené možnosti triedenia zoznamu podľa týchto stĺpcov.

Typ Objekt nie je k dispozícii pre neobjektový dataset, napr. 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ů?

Definícia nadpisu pre daný stĺpec. Povinná položka.

V prípade typu "Tabuľka" predvyplní pri výbere/zmene vybranej položky nadpisom definovaným v datasete. Pri stĺpcoch typu Objekt predvyplnenie nie je možné, tu musí nadpis stĺpca užívateľ zadať ručne.

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é spôsoby zobrazenia:

• 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

  

  Príklad tohto spôsobu zobrazenia

  Pre správne zobrazenie percentuálneho pokrytia je potrebné, aby vrátená hodnota bola v intervale <-1,1>. Ak je už hodnota sama o sebe vyjadrená v percentách, je ju potrebné vydeliť 100.

  V objednávkach prijatých si nadefinujeme stĺpec, ktorý pomocou funkcie SCM vracia percentuálne pokrytie dokladu v percentách. Preto ju musíme vydeliť 100. Ďalej viď tiež Základné pojmy a proces SCM - Použitie QuickReports funkcie (QR funkcie) na zistenie pokrytia dokladov.

• 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 Príklady použitia vybraných funkcií a výrazov.

    • 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í.

• 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 adresáři firem 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žnosť "číselník" nie je k dispozícii, ak je vybraná iná položka, ako položka odkazujúca sa priamo do nejakého číselníka (napr. ak z daného číselníka vyberiete už priamo nejakú položku, napr. CreatedBy_ID.ID, pretože tá už sama o sebe číselníková nie je). Číselníkom môže byť aj užívateľsky definovateľná položka. V prípade tohto typu zobrazenia sa sprístupní položka Položka číselníka na zobrazenie.

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.

Tzn. ak je na danom riadku splnená zadaná podmienka, bunka sa vykreslí inak (inou farbou, tučne a pod.). V rámci zobrazenia typu grafické percento môže podmienená farba prebiť základnú farbu stĺpca. (napr. do 50-tich percent bude mať graf jednu farbu a nad 50% inú farbu a pod.).

Výraz môžete zapísať ručne alebo ho môžete zostaviť komfortnejšie pomocou Editora výrazov, ktorý si môžete vyvolať po stlačení funkčného tlačidla (môže sa líšiť podľa verzie a nastaveného vzhľadu). Vo výrazoch sú k dispozícii funkcie a dáta objektov dostupných v danom mieste programu, viď funkcie a dátové položky objektu v editore výrazov.