Editor zobrazovaných údajov (editor definícií)

Slúži na nadefinovanie obsahu a vzhľadu Panelu definovateľných údajov zoznamu alebo Panelu definovateľných údajov detailu, ktoré si môžete nechať zobrazovať na záložkách Zoznam resp. Detail vo väčšine agend. V ďalšom texte nájdete:

Editor vyvoláte v danej agende (ktorá podporuje panely definovateľných údajov zoznamu, detailu, ...):

  • voľbou v menu: Ostatné nastavenie→Panel definovateľných údajov zoznamu resp. detailu→editor definícií:

    Príklad vyvolania editora definícií z menu Nastavenie

  • voľbou editor definícií z lokálneho menu vyvolaného nad zobrazeným panelom - možné len, ak je panel zobrazený

Potom sa zobrazí okno editora, pričom sa doň načíta obsah definície panelu aktuálne vybranej na zobrazenie na záložke Zoznam (resp. Detail) v danej agende. Ak nie je žiadna definícia aktuálne vybraná na zobrazenie (panel sa nezobrazuje), vyvolaný editor je prázdny. V hornej časti okna editora je k dispozícii položka Vybraná definícia typu skrytý zoznam. Tu sa zobrazuje názov aktuálne vybranej definície, ale môžete si zvoliť inú zo zoznamu už existujúcich definícií. Ponúkajú sa tu všetky existujúce používateľské (tj. neponúka sa tu základná definícia dodávaná výrobcom). Do editora si môžete taktiež nechať načítať Základnú definíciu. V editore si môžete zobrazovať buď náhľad výsledku definícií jednotlivých buniek alebo pomocou zaškrtávadla Ukázať definície v hornej časti okna si môžete prepnúť na zobrazenie vlastných definícií jednotlivých buniek.

Vyvolaný editor definícií s príkladom definícia v agende faktúr vydaných

Načítanú definíciu môžete prezerať, prípadne upravovať a potom pomocou funkcie Uložiť ako uložiť pod rovnakým alebo ľubovoľným iným menom (potom pribudne ako nová v zozname používateľských definícií).

Práca s definíciami panelov je obdobná práci s definíciou obmedzenia v záložke Obmedzenie.

Pre vlastné vykonávanie definície panelu sú k dispozícii funkcie lokálneho menu:

Príklad lokálneho menu v editore zobrazovaných údajov (zobrazí sa po stlačení pravého tlačidla myši, ak je kurzor v poli editora zobrazovaných údajov)

Názov Popis:
Vlastnosti bunky

V tejto voľbe sa definuje vlastný obsah bunky (text, položka z tabuľky databáza, položka business objektu, agregačná položka) a ďalej jej vzhľad, tj. font a farby, prípadne aj podmienky na zobrazenie bunky alebo riadka/stĺpca. Pre tieto definície platia obdobné pravidlá ako pre vkladanie položiek do tlačových zostáv.

Obsah bunky je možné rýchlo premiestňovať myšou pomocou metódy drag-and-drop.

Dialóg Obsah bunky je možné zobraziť:

  • voľbou Vlastnosti bunky z lokálneho menu
  • dvojklikom ľavého tlačidla myši
  • z klávesnice kombináciou klávesov Alt+Enter

Po vyvolaní sa zobrazí dialógové okno:

Príklad okna vyvolaného nad položkou na zobrazenie čiastky celkom bez dane z definovateľného panela detailu pri vydaných faktúrach

K dispozícii sú tu nasledujúce záložky:

Záložka Dáta

Tu máte možnosť zadať definíciu dát, ktoré sa majú v bunke zobrazovať. Položky tu nastaviteľné:

Názov Popis
Typ

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ť. Možnosti:

Text

Túto možnosť vyberiete v prípade, že v danej bunke má byť nejaký textový popisok. Ak je zvolená voľba Text, potom nasledujúca položka, ktorá sa sprístupní, je obyčajná editačná položka, do ktorej zadáte príslušný text.

V paneli def. údajov Detailu vo faktúrach vydaných si môžeme nadefinovať riadok na zobrazovanie celkovej sumy bez DPH, viď obrázok v úvode kapitoly. Potom do bunky predchádzajúcej bunke s vlastnou definíciou celkovej sumy zadáme popisok:

Príklad zadania textovej položky

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 zodpovedajúcu 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, používateľsky ich nemožno nijako ovplyvňovať (ale bohužiaľ ani prezerať, ako sú definované).

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 nejde o položky z tabuliek databázy!

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

Keďže položky datasetu na danom mieste programu sú vyhodnotené a načítané do pamäte, potom sa dá 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 potom 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ôže obsahovať okrem matematických a iných funkcií aj QuickReports funkcie a referencie na vlastnosti business objektu, ku ktorému sa agenda viaže. 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.

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

Agregácia

Túto možnosť vyberiete, ak chcete nadefinovať položku, v ktorej sa majú zobrazovať nejaké sumárne informácie za všetky označené záznamy. V ďalších dvoch položkách typu skrytý zoznam vyberiete, o akú agregačnú (sumačnú) funkciu má ísť (napr. Súčet, Priemer, Maximum, Minimum a pod.) a pre akú položku daných záznamov sa má vyčísľovať. (Na výber sú položky datasetu MAIN pre danú agendu, agregovať nad položkami z iných datasetov nie je možné.)

V paneli definovateľných údajov Zoznamu vo faktúrach vydaných chceme vidieť Súčet sumy bez dane za označené faktúry. Potom definíciu položky nadefinujeme nasledovne:

Príklad zadania agregačnej položky

V paneli def. údajov Zoznamu objednávok prijatých alebo dodacích listov by sme chceli operatívne vidieť celkovú hmotnosť tovaru na označených dokladoch, čo využijeme pri plánovaní dopravy. Potom definíciu položky nadefinujeme nasledovne:

Príklad zadania agregačnej položky

V agende Skladové karty môže dôjsť k situácii, keď je nastavená napr. agregačná funkcia pre súčet množstva na čiastkových skladových kartách. Ak ale zároveň na skladových kartách nastavíme filter, že chceme vidieť iba skladové karty z určitého skladu, agregačná funkcia bude aj naďalej sčítať množstvo čiastkových skladových kariet zo všetkých skladov. Je teda nutné brať túto vlastnosť funkcie do úvahy.

Ďalšie vybrané položky záložky:

Tooltip - Text zapísaný v tejto položke sa zobrazí ako nápoveda (hint) po nabehnutí kurzora myši na bunku, kde je Tooltip vyplnený.

Príklad zobrazenia Tooltipu v paneli nad bunkou po nabehnutí kurzora na danú bunku.

Záložka Podmienky

Výraz, podľa ktorého sa podmienka na zobrazovanie danej bunky, daného stĺpca alebo daného riadku vyhodnotí. Ak podmienka nie je splnená, potom sa bunka, riadok alebo stĺpec nezobrazuje.

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 z objektov dostupných na danom mieste programu, viď funkcie a dátové položky objektu v editore výrazov.

Pre riadok zobrazujúci kredit si môžeme nadefinovať podmienku, že sa má zobrazovať len v prípade, že má nejakú nezaplatenú sumu: Čiže do podmienky pre riadok môžeme zadať napr. FirmNotPaidAmount>0.

Záložka Formát

V tejto záložke si nastavíte formát zobrazenia výsledného údaja. Tj. farbu písma a farbu podkladu (možné pre svetlý a tmavý režim samostatne), zarovnanie, či má byť písmo tučné alebo nie. Pre objektové položky a agregácie (viď Typ vyššie) možno nastaviť aj masku pre zobrazovanie (napr. počet desatinných miest).

Tabuľkové údaje sa zobrazujú len podľa masky v danej tabuľke.

Ak nastavíte bunke nejakú farbu pozadia, rovnakou farbou sa zafarbí aj pozadie ďalších nevyplnených buniek na riadku vľavo aj vpravo od bunky, a to až k prvej vyplnenej bunke.
Nastaviť šírku stĺpcov Zadáte šírku stĺpcov (šírku stĺpcov možno paralelne nastavovať uchopením rozdeľovača medzi stĺpcami (nad každým stĺpcom) a ťahaním myšou na požadovanú šírku).
Vložiť
  • Vložiť riadok - táto voľba vloží nový prázdny riadok na aktuálnu pozíciu (na miesto, odkiaľ ste vyvolali lokálne menu) a súčasne presunie všetky hodnoty a formáty buniek nasledujúcich riadkov o jeden riadok nižšie.
  • Vložiť stĺpec - vloží nový prázdny stĺpec na aktuálnu pozíciu (na miesto, odkiaľ ste vyvolali lokálne menu) a súčasne presunie všetky hodnoty a formáty buniek nasledujúcich stĺpcov o jeden stĺpec doprava.
Odobrať
  • Odobrať riadok - odstráni aktuálny riadok, tj. riadok, v ktorom leží bunka, z ktorej ste vyvolali lokálne menu, a súčasne presunie všetky hodnoty a formáty buniek nasledujúcich riadkov o jeden riadok vyššie.
  • Odobrať stĺpec - odstráni aktuálny stĺpec, tj. stĺpec, v ktorom leží bunka, z ktorej ste vyvolali lokálne menu, a súčasne presunie všetky hodnoty a formáty buniek nasledujúcich stĺpcov o jeden stĺpec doľava.
Nastavenie...

Vyvolá rovnaké dialógové okno ako pri stlačení funkcie Nastavenie. Jeho popis nájdete pri tejto funkcii.
Názov Kl. Popis:
Uložiť ako -

Aktuálne nastavenie uloží ako definíciu pod zadaným menom. Podľa tohto mena potom budete definície vyberať z menu Nastavenie (viď vyššie), preto by malo byť čo najvýstižnejšie. Definíciu môžete uložiť ako

  • Globálnu - tj. definícia bude spoločná pre celú firmu. V zozname existujúcich definícií v obmedzovacom paneli sú zvýraznené tučne.
  • Používateľskú - tj. pokiaľ nezaškrtnete predvoľbu Globálna, bude definícia uložená ako používateľská a bude k dispozícii iba používateľovi, ktorý ju nadefinoval.

Práca s definíciami panelov zobrazovaných údajov je obdobná práci s definíciami obmedzení na záložke Obmedzenie.
Odstrániť - Vymaže aktuálne vybranú definíciu (ktorej názov je aktuálne zobrazený v obmedzovacom paneli) zo zoznamu definícií.
Základná definícia -

Načíta do editora obsah základnej definície (predvolene dodávanej výrobcom).

Funkcia je k dispozícii len, pokiaľ má pre danú agendu význam, tj. výrobca pre ňu dodáva nejakú preddefinovanú základnú definíciu.
Vyčistiť - Vymaže obsah aktuálnej definície.
Prog/Definícia - Prepínač zobrazenia medzi definíciou panelu a zodpovedajúcim programovým fragmentom. Funkcia je k dispozícii iba systémovým používateľom a vývojovým pracovníkom na účely prenosu vizuálne definovanej definície do programu.
Do súboru - Uloží aktuálnu definíciu do súboru pod zadaným menom.
Zo súboru - Načíta aktuálnu definíciu zo súboru zadaného mena.
Nastavenie -

Po stlačení funkcie sa zobrazí modálne oknoClosed Vo Windows sa takto nazýva okno, ktoré keď je vyvolané, na obrazovke "zatieni" všetky ostatné okná a nie je možné ho odsunúť do pozadia bez toho, aby sa s ním používateľ priamo "vysporiadal" (tzn. stlačil OK, zrušiť, atď.). Typicky sa vyskytuje v prípadoch hlásení o chybách systému, interaktívnych dialógoch a pod. Opakom je nemodálne okno. Nastavenie panelu so záložkami:

Zmenou celkového počtu riadkov v definícii môžete riadky pridávať (pridávajú sa na koniec), resp. uberať (uberajú sa od konca). Pozor, ak znížite počet riadkov a definíciu panelu potom uložíte, prídete tým takisto aj o definície všetkých položiek nastavených na odobratých riadkoch.

Zmenou celkového počtu stĺpcov v definícii môžete stĺpce pridávať, resp. uberať.

Hodnota zadaná v milisekundách. Údaj dôležitý pre pohyb v zozname dokladov. Ak sa pohybujete v zozname dokladov v záložke, kde je panel zobrazený, jeho obsah sa prekresľuje údajmi aktuálneho záznamu. Pritom sa prekresľuje so zadaným časovým oneskorením. To znamená, že v zozname dokladov sa môžete rýchlo pohybovať kurzorom, a až keď sa na niektorom z nich zastavíte na dobu dlhšiu, než je zadané časové oneskorenie, zobrazený obsah panelu sa zaktualizuje podľa aktuálneho dokladu. Ak by nebolo zadané žiadne časové oneskorenie, prekresľoval by sa po každom pohybe z jedného záznamu na iný, čo by pohyb po dokladoch značne spomalilo.

Hodnota zadaná v milisekundách. Údaj dôležitý pre pohyb v zozname dokladov súvisiaci s ich označovaním/odznačovaním. Pokiaľ meníte označené záznamy v zozname, kde je zobrazený panel obsahujúci položky s agregačnými funkciami, je potrebné ich obsah aktualizovať podľa aktuálne označených záznamov. Aby sa neaktualizovali po označení/odznačení každého záznamu, je možné nastaviť časovú prodlevu. Tzn., že v zozname dokladov môžete rýchlo označovať/odznačovať, a až keď od poslednej zmeny v označovaní uplynie zadaná časová prodleva, agregačné položky v paneli sa zaktualizujú. Pokiaľ by nebola zadaná žiadna časová prodleva, pohyb po dokladoch a ich označovanie by to značne spomalilo. Pri zmenách v označovaní záznamov sú počas prodlevy, keď je hodnota agregačných položiek nezaktualizovaná, v nich zobrazené otázniky:

Zobrazenie otáznikov v hodnote agregačnej položky, pokiaľ nie je práve zaktualizovaná po vykonaných zmenách v označovaní záznamov

Viditeľná výška pri zobrazení panelu v príslušnej záložke.

  • Automaticky - v tomto prípade sa výška panelu pri každom zázname automaticky prispôsobuje podľa potreby tak, aby boli viditeľné položky na všetkých riadkoch panelu, ktoré sa majú pre daný záznam zobrazovať (tj. spĺňajú podmienku na zobrazenie). Výhodou je, že pri každom zázname sú vidieť všetky položky, ktoré sa majú preň zobraziť, a pritom panel zaberá pre každý záznam najmenší možný priestor, ale nevýhodou je, že pri rýchlejšom pohybe po záznamoch sa jeho výška neustále mení, čo vyvoláva vizuálny dojem blikania, ktorý nemusí byť každému príjemný.
  • Fixná - v tomto prípade je výška panelu konštantná pre každý záznam, bez ohľadu na to, či zobrazovaných riadkov pre daný záznam je menej alebo viac. Ak ich je viac, je možné v paneli po jednotlivých rolovať. Výhodou je, že odstraňuje nepríjemný dojem blikania pri rýchlom pohybe po záznamoch, nevýhodou môže byť to, že pri záznamoch, pri ktorých sa má zobrazovať menší počet riadkov, môže zostať časť panelu prázdna a panel zaberá zbytočný priestor a naopak pri záznamoch, pri ktorých sa má zobrazovať väčší počet riadkov, nie sú naraz vidieť všetky.
  • Maximálny - kombinácia predchádzajúceho, keď sa výška panela prispôsobuje podľa potreby, ale je stanovená horná hranica pre výšku panela.

Záložka slúži na vytváranie používateľských dátových objektov s dátovými položkami v dátovom modeli.

Názov dátového objektu.

SQL výraz, ktorým sa naplní dátový objekt.

Dátové položky objektu je vhodné v SQL pomenúvať pomocou konvencie as.

Pre agendu Adresár firiem vytvoríme definovateľný panel zoznamu s týmto SQL, ktoré nám medzi dátové objekty doplní položky so súčtom celkových súm z faktúr vydaných a dobropisov vydaných vystavených na danú firmu:

Pre firebird:

'SELECT (SELECT SUM(Amount) FROM IssuedInvoices WHERE Firm_ID = ' + NxQuotedStr(ID) + ') as IssuedInvoicesSum, (SELECT SUM(Amount) FROM IssuedCreditNotes WHERE Firm_ID = ' + NxQuotedStr(ID) + ') as IssuedCreditNotesSum FROM rdb$database'

Tento príklad nájdete medzi dodávanými príkladmi v adresári inštalácie ABRA Gen, v podadresári Examples. Tu je k dispozícii inštalačná sada HowToWorkEffectiveWithSqlInShowGrid.ais obsahujúca vyššie uvedený definovateľný panel so SQL pre agendu Adresár firiem.

Pre Oracle:

'SELECT (SELECT SUM(Amount) FROM IssuedInvoices WHERE Firm_ID = ' + NxQuotedStr(ID) + ') as IssuedInvoicesSum, (SELECT SUM(Amount) FROM IssuedCreditNotes WHERE Firm_ID = ' + NxQuotedStr(ID) + ') as IssuedCreditNotesSum FROM DUAL'
OK - Zavrie editor definícií. Pokiaľ daná definícia zatiaľ nebola uložená, ponúkne možnosť vykonané zmeny uložiť.
Storno - Zavrie editor definícií bez uloženia vykonaných zmien.