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

Slúži na nadefinovanie obsahu a vzhľadu Panela definovateľných údajov zoznamu alebo Panela definovateľných údajov detailu, ktoré si môžete nechať zobrazovať v záložkach 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é Nastavenia→Panel definovateľných údajov zoznamu resp. detailu→Editor definícií:

    Príklad vyvolania Editora definícií z menu Nastavenia

  • 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 neho načíta obsah definície panela aktuálne vybranej na zobrazenie v záložke Zoznam (resp. Detail) v danej agende. Pokiaľ nie je aktuálne vybraná žiadna definícia na zobrazenie (panel sa nezobrazuje), je vyvolaný editor 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 užívateľské (tzn. neponúka sa tu definícia základná dodávaná výrobcom). Do editora si môžete nechať načítať aj Základnú definíciu. V editore si môžete zobrazovať buď náhľad výsledku definícií jednotlivých buniek alebo pomocou začiarkavacieho políčka 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ície v agende faktúr vydaných

Načítanú definíciu môžete prehliadať, 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 užívateľských definícií).

Práca s definíciami panelov je podobná ako práca s definíciami obmedzení v záložke Obmedzenie.

Na vlastné zostavovanie definície panela 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ázy, položka Business objektu, agregačná položka) a ďalej jej vzhľad, tzn. font a farby, prípadne aj podmienky zobrazenia bunky alebo riadka/stĺpca. Pre tieto definície platia podobné 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 faktúrach vydaných

K dispozícii tu sú nasledovné záložky:

Záložka Dáta

Máte možnosť zadať sem 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á popiska. Ak je zvolená voľba Text, 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 čiastky bez DPH, viď obrázok v úvode kapitoly. Potom do bunky predchádzajúcej bunku s vlastnou definíciou celkovej čiastky zadáme popisku:

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

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ôž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. 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.

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

Agregácia

Túto možnosť vyberiete, pokiaľ 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 ktorú agregačnú (sumačnú) funkciu má ísť (napr. súčet, Priemer, Maximum, Minimum a pod.) a pre ktorú položku daných záznamov sa má vyčíslovať. (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 def. údajov Zoznamu vo faktúrach vydaných chceme vidieť Súčet čiastky bez dane za označené faktúry. Potom definíciu položky nadefinujeme nasledovným spôsobom:

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 nasledovným spôsobom:

Príklad zadania agregačnej položky

V agende Skladové karty môže dôjsť k situácii, kedy je nastavená napr. agregačná funkcia pre súčet množstva na čiastkových skladových kartách. Pokiaľ ale zároveň na skladových kartách nastavíme filter, že chceme vidieť len skladové karty z určitého skladu, agregačné funkcie bude i 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 pre zobrazovanie danej bunky, daného stĺpca alebo daného riadka vyhodnotí. Ak podmienka nie je splnená, bunka, riadok alebo stĺpec sa 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 objektov dostupných v 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ú čiastku: Č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. Tzn. farbu písma a farbu podkladu, zarovnanie, či má byť písmo tučné alebo nie. Pre objektové položky a agregácie (viď Typ vyššie) je možné nastaviť aj masku zobrazovania (napr. počet desatinných miest).

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

Pokiaľ 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ť výšku riadkov Zadáte výšku riadkov (výšku je možné paralelne nastavovať uchopením rozdeľovacieho znaku medzi riadkami (vľavo pri každom riadku) a ťahaním myšou na požadovanú výšku).
Nastaviť šírku stĺpcov Zadáte šírku stĺpcov (šírku stĺpcov je možné paralelne nastavovať uchytením rozdeľovacieho znaku 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, tzn. 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, tzn. 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 - tzn. definícia bude spoločná pre celú firmu. V zozname existujúcich definícií v obmedzovacom paneli sú zvýraznené tučne.
  • Užívateľskú - tzn. pokiaľ nezačiarknete predvoľbu Globálna, definícia bude uložená ako užívateľská a bude k dispozícii len užívateľovi, ktorý ju nadefinoval.

Práca s definíciami panelov zobrazovaných údajov je podobná ako práca s definíciami obmedzení v 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 (defaultne dodávanej výrobcom).

Funkcia je k dispozícii len, pokiaľ má pre danú agendu význam, tzn. 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 panela a príslušným programovým fragmentom. Funkcia je k dispozícii iba systémovým užívateľom a vývojovým pracovníkom za účelom 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 uží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 panela so záložkami:

Zmenou celkového počtu riadkov v definícii môžete riadky pridávať (pridávajú sa na koniec), resp. odoberať (odoberajú sa od konca). Pozor, pokiaľ znížite počet riadkov a definíciu panela následne uložíte, prídete tým rovnako aj o definície všetkých položiek nastavených na odobraných riadkoch.

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

Hodnota zadávaná v milisekundách. Údaj dôležitý pre pohyb v zozname dokladov. Pokiaľ sa pohybujete v zozname dokladov v záložke, kde je panel zobrazený, jeho obsah sa prekresľuje údajmi aktuálneho záznamu. Pričom sa prekresľuje so zadaným časovým rozstupom. Tzn., že v zozname dokladov sa môžete rýchlo pohybovať kurzorom a až vtedy, ak sa na nejakom z nich zastavíte na dobu dlhšiu, ako je zadaný časový rozstup, zobrazený obsah panela sa zaktualizuje podľa aktuálneho dokladu. Pokiaľ by nebol zadaný žiadny časový rozstup, prekresľoval by sa po každom pohybe z jedného záznamu na iný, čo by pohyb po dokladoch značne spomalilo.

Hodnota zadávaná 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ý rozstup. Tzn., že v zozname dokladov môžete rýchlo označovať/odznačovať,a až vtedy, ak od poslednej zmeny v označovaní ubehne zadaný časový rozstup, agregačné položky v paneli sa zaktualizujú. Pokiaľ by nebol zadaný žiadny časový rozstup, pohyb po dokladoch a ich označovanie by to značne spomalilo. Pri zmenách v označovaní záznamov sú v nich počas doby rozstupu, kedy je hodnota agregačných položiek nezaktualizovaná, 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í panela v príslušnej záložke.

  • Automaticky - v tomto prípade sa výška panela pri každom zázname automaticky prispôsobuje podľa potreby tak, aby boli viditeľné položky na všetkých riadkoch panela, ktoré sa majú pre daný záznam zobrazovať (tzn. spĺňajú podmienku zobrazenia). Výhodou je, že pri každom zázname sú viditeľné všetky položky, ktoré majú byť preň zobrazené, 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 panela konštantná pre každý záznam, bez ohľadu na to, či je zobrazovaných riadkov pre daný záznam menej alebo viac. Ak je ich 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ť panela prázdna a panel zaberá zbytočný priestor a naopak pri záznamoch, v ktorých sa má zobrazovať väčší počet riadkov, nie je vidieť všetky naraz.
  • Maximálna - kombinácia predchádzajúceho, kedy sa výška panela prispôsobuje podľa potreby, ale je stanovená horná hranica výšky panela.

Záložka slúži na vytváranie uží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 pomenová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úry vydaných a dobropisov vydaných vystavených na danú firmu:

'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 spomenutý definovateľný panel s SQL pre agendu Adresár firiem.
OK - Zatvorí editor definícií. Pokiaľ daná definícia zatiaľ nebola uložená, ponúkne možnosť vykonané zmeny uložiť.
Storno - Zatvorí editor definícií bez uloženia uskutočnených zmien.