Editor zobrazovaných údajů (Editor definic)

Slouží k nadefinování obsahu a vzhledu Panelu definovatelných údajů seznamu nebo Panelu definovatelných údajů detailu, které si můžete nechat zobrazovat v záložkách Seznam resp. Detail ve většině agend. V dalším textu naleznete:

Editor vyvoláte v dané agendě (která podporuje panely definovatelných údajů seznamu, detailu, ...):

  • volbou v menu: Nastavení→Panel definovatelných údajů seznamu resp. detailu→Editor definic:

    Příklad vyvolání Editoru definic z menu Nastavení

  • volbou Editor definic z lokálního menu vyvolaného nad zobrazeným panelem - možno jen, je-li panel zobrazen

Poté se zobrazí okno editoru, přičemž se do něj načte obsah definice panelu aktuálně vybrané pro zobrazení v záložce Seznam (resp. Detail) v dané agendě. Pokud není žádná definice aktuálně vybraná pro zobrazení (panel se nezobrazuje), je vyvolaný editor prázdný. V horní části okna editoru je k dispozici položka Vybraná definice typu skrytý seznam. Zde se zobrazuje název aktuálně vybrané definice, ale můžete si zvolit jinou ze seznamu již existujících definic. Nabízí se zde všechny existující uživatelské (tj. nenabízí se zde definice základní dodávaná výrobcem). Do editoru si můžete rovněž nechat načíst Základní definici. V editoru si můžete zobrazovat buď náhled výsledku definic jednotlivých buněk nebo pomocí zatržítka Ukázat definice v horní části okna si můžete přepnout na zobrazení vlastních definic jednotlivých buněk.

Vyvolaný Editor definic s příkladem definice v agendě faktur vydaných

Načtenou definici můžete prohlížet, případně upravovat a poté pomocí funkce Uložit jako uložit pod stejným nebo libovolným jiným jménem (pak přibude jako nová v seznamu uživatelských definic).

Práce s definicemi panelů je obdobná práci s definicemi omezení v záložce Omezení.

Pro vlastní provádění definice panelu jsou k dispozici funkce lokálního menu:

Příklad lokálního menu v editoru zobrazovaných údajů (zobrazí se po stisku pravého tlačítka myši, je-li kurzor v poli editoru zobrazovaných údajů)

Název Popis:
Vlastnosti buňky

V této volbě se definuje vlastní obsah buňky (text, položka z tabulky databáze, položka Business objektu, agregační položka) a dále její vzhled, tj. font a barvy, případně i podmínky pro zobrazení buňky nebo řádku/sloupce. Pro tyto definice platí obdobná pravidla jako pro vkládání položek do tiskových sestav.

Obsah buňky je možné rychle přemísťovat myší pomocí metody drag-and-drop.

Dialog Obsah buňky lze zobrazit:

  • volbou Vlastnosti buňky z lokálního menu
  • dvojklikem levého tlačítka myši
  • z klávesnice kombinací kláves Alt+Enter

Po vyvolání se zobrazí dialogové okno:

Příklad okna vyvolaného nad položkou pro zobrazení částky celkem bez daně z definovatelného panelu detailu u faktur vydaných

K dispozici zde jsou následující záložky:

Záložka Data

Zde máte možnost zadat definici dat, které se mají v buňce zobrazovat. Položky zde nastavitelné:

Název Popis
Typ

Položka typu skrytý seznam, ve které zvolíte, jakého typu budou zobrazovaná data, resp. odkud se budou příslušné údaje čerpat. Možnosti:

Text

Tuto možnost vyberete v případě, že v dané buňce má být nějaký textový popisek. Je-li zvolena volba Text, pak následující položka, která se zpřístupní, je obyčejná editační položka, do níž zadáte příslušný text.

V panelu def. údajů Detailu ve fakturách vydaných si můžeme nadefinovat řádek pro zobrazování celkové částky bez DPH, viz obrázek v úvodu kapitoly. Pak do buňky předcházející buňce s vlastní definicí celkové částky zadáme popisek:

Příklad zadání textové položky

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

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

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

Agregace

Tuto možnost vyberete, pokud chcete nadefinovat položku, ve které se mají zobrazovat nějaké sumární informace za všechny označené záznamy. V dalších dvou položkách typu skrytý seznam vyberete, o jakou agregační (sumační) funkci má jít (např. Součet, Průměr, Maximum, Minimum apod.) a pro jakou položku daných záznamů se má vyčíslovat. (K výběru jsou položky datasetu MAIN pro danou agendu, agregovat nad položkami z jiných datasetů nelze.)

V panelu def. údajů Seznamu ve fakturách vydaných chceme vidět Součet částky bez daně za označené faktury. Pak definici položky nadefinujeme následovně:

Příklad zadání agregační položky

V panelu def. údajů Seznamu objednávek přijatých nebo dodacích listů bychom chtěli operativně vidět celkovou hmotnost zboží na označených dokladech, což využijeme při plánování dopravy. Pak definici položky nadefinujeme následovně:

Příklad zadání agregační položky

V agendě Skladové karty může dojít k situaci, kdy je nastavena např. agregační funkce pro součet množství na dílčích skladových kartách. Pokud ale zároveň na skladových kartách nastavíme filtr, že chceme vidět pouze skladové karty z určitého skladu, agregační funkce bude i nadále sčítat množství dílčích skladových karet ze všech skladů. Je tedy nutné brát tuto vlastnost funkce v potaz.

Záložka Podmínky

Výraz, podle kterého se podmínka pro zobrazování dané buňky, daného sloupce nebo daného řádku vyhodnotí. Není-li podmínka splněna, pak se buňka, řádek nebo sloupec nezobrazuje.

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

Pro řádek zobrazující kredit si můžeme nadefinovat podmínku, že se má zobrazovat jen v případě, že má nějakou nezaplacenou částku: Čili do podmínky pro řádek můžeme zadat např. FirmNotPaidAmount>0.

Záložka Formát

V této záložce si nastavíte formát zobrazení výsledného údaje. Tj. barvu písma a barvu podkladu, zarovnání, zda má písmo být tučné či nikoli. Pro objektové položky a agregace (viz Typ výše) lze nastavit i masku pro zobrazování (např. počet desetinných míst).

Tabulkové údaje se zobrazují jen podle masky v dané tabulce.

Pokud nastavíte buňce nějakou barvu pozadí, stejnou barvou se zbarví také pozadí dalších nevyplněných buněk na řádku vlevo i vpravo od buňky, a to až k první vyplněné buňce.
Nastavit výšku řádků Zadáte výšku řádků (výšku lze paralelně nastavovat uchopením rozdělovníku mezi řádky (vlevo u každého řádku) a tažením myší na požadovanou výšku).
Nastavit šířku sloupců Zadáte šířku sloupců (šířku sloupců lze paralelně nastavovat uchopením rozdělovníku mezi sloupci (nad každým sloupcem) a tažením myší na požadovanou šířku).
Vložit
  • Vložit řádek - tato volba vloží nový prázdný řádek na aktuální pozici (na místo, odkud jste vyvolali lokální menu) a současně přesune všechny hodnoty a formáty buněk následujících řádků o jeden řádek níže.
  • Vložit sloupec - vloží nový prázdný sloupec na aktuální pozici (na místo, odkud jste vyvolali lokální menu) a současně přesune všechny hodnoty a formáty buněk následujících sloupců o jeden sloupec doprava.
Odebrat
  • Odebrat řádek - odstraní aktuální řádek, tj. řádek, v němž leží buňka, ze které jste vyvolali lokální menu, a současně přesune všechny hodnoty a formáty buněk následujících řádků o jeden řádek výše.
  • Odebrat sloupec - odstraní aktuální sloupec, tj. sloupec, v němž leží buňka, ze které jste vyvolali lokální menu, a současně přesune všechny hodnoty a formáty buněk následujících sloupců o jeden sloupec doleva.
Nastavení...

Vyvolá stejné dialogové okno jako při stisku funkce Nastavení. Jeho popis naleznete u této funkce.
Název Kl. Popis:
Uložit jako -

Aktuální nastavení uloží jako definici pod zadaným jménem. Podle tohoto jména pak budete definice vybírat z menu Nastavení (viz výše), proto by mělo být co nejvýstižnější. Definici můžete uložit jako

  • Globální - tj. definice bude společná pro celou firmu. V seznamu existujících definic v omezovacím panelu jsou zvýrazněny tučně.
  • Uživatelskou - tj. pokud nezaškrtnete předvolbu Globální, bude definice uložena jako uživatelská a bude k dispozici pouze uživateli, který ji nadefinoval.

Práce s definicemi panelů zobrazovaných údajů je obdobná práci s definicemi omezení v záložce Omezení.
Odstranit - Vymaže aktuálně vybranou definici (jejíž název je aktuálně zobrazen v omezovacím panelu) ze seznamu definic.
Základní definice -

Načte do editoru obsah základní definice (defaultně dodávané výrobcem).

Funkce je k dispozici jen, pokud má pro danou agendu význam, tj. výrobce pro ni dodává nějakou předdefinovanou základní definici.
Vyčistit - Vymaže obsah aktuální definice.
Prog/Definice - Přepínač zobrazení mezi definicí panelu a odpovídajícím programovým fragmentem. Funkce je k dispozici pouze systémovým uživatelům a vývojovým pracovníkům pro účely přenosu vizuálně definované definice do programu.
Do souboru - Uloží aktuální definici do souboru pod zadaným jménem.
Ze souboru - Načte aktuální definici ze souboru zadaného jména.
Nastavení -

Po stisku funkce se zobrazí modální oknoClosed Ve Windows se takto nazývá okno, které když je vyvoláno na obrazovku "zastíní" všechna ostatní okna a není možné je odsunout do pozadí, aniž se s ním uživatel přímo "vypořádá" (tj. stiskne OK, zrušit, atd.). Typicky se vyskytuje v případech hlášení o chybách systému, interaktivních dialozích apod. Opakem je nemodální okno. Nastavení panelu se záložkami:

Změnou celkového počtu řádků v definici můžete řádky přidávat (přidávají se na konec), resp. ubírat (ubírají se od konce). Pozor, pokud snížíte počet řádků a definici panelu pak uložíte, přijdete tím rovněž i o definice všech položek nastavených na ubraných řádcích.

Změnou celkového počtu sloupců v definici můžete sloupce přidávat, resp. ubírat.

Hodnota zadaná v milisekundách. Údaj důležitý pro pohyb v seznamu dokladů. Pokud se pohybujete v seznamu dokladů v záložce, kde je panel zobrazen, jeho obsah se překresluje údaji aktuálního záznamu. Přičemž se překresluje se zadanou časovou prodlevou. Tzn., že v seznamu dokladů se můžete rychle pohybovat kurzorem, a teprve, když se na nějakém z nich zastavíte na dobu delší, než je zadaná časová prodleva, zobrazený obsah panelu se zaktualizuje podle aktuálního dokladu. Pokud by nebyla zadána žádná časová prodleva, překresloval by se po každém pohybu z jednoho záznamu na jiný, což by pohyb po dokladech značně zpomalilo.

Hodnota zadaná v milisekundách. Údaj důležitý pro pohyb v seznamu dokladů související s jejich označováním/odznačováním. Pokud měníte označené záznamy v seznamu, kde je zobrazen panel obsahující položky s agregačními funkcemi, je třeba jejich obsah aktualizovat podle aktuálně označených záznamů. Aby se neaktualizovaly po označení/odznačení každého záznamu, je možno nastavit časovou prodlevu. Tzn., že v seznamu dokladů můžete rychle označovat/odznačovat, a teprve, když od poslední změny v označování uběhne zadaná časová prodleva, agregační položky v panelu se zaktualizují. Pokud by nebyla zadána žádná časová prodleva, pohyb po dokladech a jejich označování by to značně zpomalilo. Při změnách v označování záznamů jsou po dobu prodlevy, kdy je hodnota agregačních položek nezaktualizovaná, v nich zobrazeny otazníky:

Zobrazení otazníků v hodnotě agregační položky, pokud není právě zaktualizovaná po provedených změnách v označování záznamů

Viditelná výška při zobrazení panelu v příslušné záložce.

  • Automaticky - v tomto případě se výška panelu u každého záznamu automaticky přizpůsobuje podle potřeby tak, aby byly viditelné položky na všech řádcích panelu, které se mají pro daný záznam zobrazovat (tj. splňují podmínku pro zobrazení). Výhodou je, že u každého záznamu jsou vidět všechny položky, které mají být pro něj zobrazeny, a přitom panel zabírá pro každý záznam nejmenší možný prostor, ale nevýhodou je, že při rychlejším pohybu po záznamech se jeho výška neustále mění, což vyvolává vizuální dojem blikání, který nemusí být každému příjemný.
  • Fixní - v tomto případě, je výška panelu konstantní pro každý záznam, bez ohledu na to, zda zobrazovaných řádků pro daný záznam je méně nebo více. Je-li jich více, je možno v panelu po jednotlivých rolovat. Výhodou je, že odstraňuje nepříjemný dojem blikání při rychlém pohybu po záznamech, nevýhodou může být to, že u záznamů, u kterých se má zobrazovat menší počet řádků, může zůstat část panelu prázdná a panel zabírá zbytečný prostor a naopak u záznamů, u kterých se má zobrazovat větší počet řádků, nejsou najednou vidět všechny.
  • Maximální - kombinace předchozího, kdy se výška panelu přizpůsobuje podle potřeby, ale je stanovena horní hranice pro výšku panelu.

Záložka slouží pro vytváření uživatelských datových objektů s datovými položkami v datovém modelu.

Název datového objektu.

SQL výraz, kterým se naplní datový objekt.

Datové položky objektu je vhodné v SQL pojmenovávat pomocí konvence as.

Pro agendu Adresář firem vytvoříme definovatelný panel seznamu s tímto SQL, které nám mezi datové objekty doplní položky se součtem celkových částek z faktury vydaných a dobropisů vydaných vystavených na danou 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 příklad naleznete mezi dodávanými příklady v adresáři instalace ABRA Gen, v podadresáři Examples. Zde je k dispozici instalační sada HowToWorkEffectiveWithSqlInShowGrid.ais obsahující výše zmíněný definovatelný panel s SQL pro agendu Adresář firem.
OK - Zavře editor definic. Pokud daná definice zatím nebyla uložena, nabídne možnost provedené změny uložit.
Storno - Zavře editor definic bez uložení provedených změn.