Dialog Parametry tiskové sestavy

Smysl dialogu

Tento dialog umožňuje

Nastavit (před samotným spuštěním některých tiskových sestav, PDF a XML výstupů) parametry, kterými lze ovlivnit obsah daného výstupu.
Kromě toho, že zadané parametry ovlivní obsah tiskové sestavy, budou také uvedeny v hlavičce tiskové sestavy, aby bylo zřejmé, pro jaké parametry byl tisk realizován.
Zobrazit v tabulce data, která jsou základem tiskové sestavy. Tato data lze nejen prohlížet na obrazovce, ale v případě potřeby také vytisknout nebo vyexportovat do diskového souboru .
Upravovat definice parametrů, SQL výrazů a celé sestavy v kartě Definice parametrů a Definice sestavy.
POZOR! Tyto karty jsou přístupné pouze vrcholovému administrátorovi. Změny v těchto kartách lze provádět pouze za předpokladu dobré znalosti problematiky tiskových sestav, případně SQL dotazů, atd..

Kde je k dispozici

Obvyklá situace, kdy se tento dialog zobrazuje je automatické zobrazení u tiskových sestav, které jsou navrženy tak, že vyžadují nastavení parametrů filtru.
Další možností je na vyžádání uživatele, pokud uživatel potřebuje tento dialog např. za účelem zobrazení dat. Takovéto spuštění dialogu lze provést přidržením klávesové zkratky <Ctrl+Shift> .

Hlavní části

Karta Parametry filtru

Tato karta obsahuje seznam parametrů, které může uživatel nastavit. Mohou to být např. Datum OD - DO, Jméno aktéra, zaškrtávací pole s hodnotou Ano/Ne, atd..
Karta Definice parametrů

Tuto kartu a podkarty může kdykoliv zobrazit pouze vývojář nebo administrátor tiskových sestav pokud je příslušná tisková sestava provedena na míru (jde o uživatelský tisk).
- Podkarta Definice parametrů pro filtr
  
  Tato karta obsahuje technický popis parametrů, které se uživateli zobrazí na první kartě tohoto dialogu. Pro každou tiskovou sestavu může být nastaveno několik parametrů. Pokud však není tento parametr ošetřen v tiskové sestavě, pak samotný zápis do této karty nemá žádný smysl (nebude mít na nastavení v tomto dialogu žádný vliv).
  
  Konvence zápisu
  - [název parametru] = tento název musí být shodný s parametrama pro tisk, tedy PrnXXX. Seznam těchto parametrů je vyjmenovaný v proceduře Module_globals. Podle typu se uživateli zobrazí datumové pole, editační pole ...
  - Caption - lidský popis parametru, tak jak ho uvidí uživatel v dialogu
  - Default - hodnota parametru, která bude předvyplněna při otevření dialogu.
    U stringového parametru lze použít SQL výraz v podobě "SQL: výraz" nebo přímo string "XXX". Bez "SQL:" bude výraz brán za string.
  - Ciselnik - název číselníku, ze kterého bude uživatel moct vybrat příslušnou hodnotu
  - Visible - Nepovinný parametr, ale pokud je nastaven na False, pak je možné u daného parametru nastavit nějakou hodnotu, kterou potřebujeme pro tisk nastavit, ale uživateli se v dialogu nezobrazí.
  Příklady:
  - [PrnDatumDo]
    Caption = Datum
  - [PrnString1]
    Caption = Druh účtu
    Default = XXX
    Ciselnik = DRUH_UCTU
  - [PrnString2]
    Caption = Měna
    Default = SQL: dej_menu(XXXX);
  - [PrnBool1]
    Caption = Jenom po splatnosti
    Default = FALSE
    Visible = False
- Podkarta SQL výraz pro zjištění práva
  
  Tato karta bsahuje SQL výraz pro zjištění, zda má přihlášený uživatel oprávnění ke generování příslušné tiskové sestavy.
  
  Tento výraz vyhodnocuje TKWQueryTisk při přiřazení ID sestavy a pokud nevyhoví, tak přiřazení odmítne
  
  Pokud je text
  - prázdný, pak právo není kontrolováno
  - neprázdný, pak se předpokládá tvar např: SET :Result = Pravo_Uziv_Objct ( :ID_OBJCT, "R" )
  Parametry, které zde mohou figurovat, jsou:
  - :Result - povinný - výsledek typu Boolean
  - :ID_OBJCT - nepovinný, ID objektu, BigInt
  - :KOD_TRIDY - nepovinný, kód třídy, Char(20)
- Podkarta SQL výraz pro zjištění dostupnosti
  
  Tato karta obsahuje SQL výraz pro zjištění, zda je se má příslušná tisková sestava nabídnout pro příslušnou situaci.
  
  Tento výraz je používán pro sestavení seznamu dostupných tiskových sestav.
  
  Pokud je text
  - prázdný, pak není kontrolováno
  - neprázdný, pak se předpokládá tvar např: SET :Result = Pravo_Uziv_Objct ( :ID_OBJCT, "R" )
  Parametry, které zde mohou figurovat, jsou:
  - :Result - povinný - výsledek typu Boolean
  - :ID_OBJCT - nepovinný, ID objektu, BigInt
  - :KOD_TRIDY - nepovinný, kód třídy, Char(20)
- Podkarta SQL příkaz, který se má provést před tiskem
  
  Tato karta obsahuje SQL příkaz, který se má provést těsně před tiskem, ale až po zadání případných parametrů.
  
  Tento příkaz bude spuštěn tak jak je, pouze se předá hodnota parametru IdObjct, pokud takový bude v příkazu obsažen.
  
  Příklad příkazu:
  
  Call Nejaka_Procedura ( :IdObjct )
Karta Definice sestavy

Tuto kartu obsahující informace o tiskové sestavě může zobrazit pouze vývojář nebo administrátor tiskových sestav.
- Název - lidský popis názvu tiskové sestavy.
- WB dotaz - fyzické jméno dotazu, tak jak je uložen v databázi a ze kterého jsou čerpána data ve WB pohledu.
- WB pohled - fyzické jméno pohledu, tak jak je uložené v databázi.
- ID - identifikační číslo tiskové definice.
- Typ - zařazení do
  - Strom
  - Složka - Může obsahovat další složky a dotazy
  - Dotaz - Může obsahovat přehledy a doklady
  - Přehled - Nemůže obsahovat nic (obsahuje již jen definici sestavy)
  - Doklad - Nemůže obsahovat nic (obsahuje již jen definici sestavy)
  - Speciál - Nastavení parametrů, prostředí, ... a jeho volání je prováděno v příslušných místech v DELPHI
- Klasifikace - jde o sedmimístný kód, který určuje druh tiskové sestavy.
  - 1. pozice
    - O - oficiální - jedná se především o zákonem stanovené formuláře (např. tisk přiznání k DPH)
    - N - neoficiální (všechny ostatní)
  - 2. pozice
    - E - externí - to jsou takové tiskové sestavy, které jdou mimo firmu
    - I - interní - tyto tiskové sestavy zústávají uvnitř firmy a nedostanou se k zákazníkovi
    - M - mzdové
    - X - neurčeno
  - 3. pozice
    - P - prodejní - týká se především dokladů
    - N - neprodejní - týká se především neúčetních záležitostí, jako jsou např. dopisy, ceníky, ...
    - M - měsíční výstupy (týká se pouze mzdových tisků)
    - R - rekapitulace (týká se pouze mzdových tisků)
    - X - neurčeno
  - 4. pozice
    - A - tisk do PDF (v některých sestavách se rozhoduje, zda bude použitý podpis uživatele (naskenovaný podpis), jidne se rozhoduje, zda se budou tisknout související objekty.
    - - - klasický tisk na tiskárnu
  - 5. pozice
    - S - v tisku se pracuje se střediskama
    - X - neurčeno
  - 6.-7.pozice
    - X - neurčeno
  Při zadávání je nutné dodržet rozpad druhu. Např. tisk přiznání k DPH je O (oficiální), ale tisk faktury vydané je NEP-XXX (neoficiální, externí, prodejní). Není tedy možné zadat OIP-XXX.
- Orientace - výchozí nastavení orientace tisku (svisle / vodorovně).
- Výstup - výchozí nastavení výstupního zařízení.
- Originál - zaškrtnuté pole určuje, že se jedná o tisk vytvořený vývojáři Kaskády. Tyto tiskové sestavy jsou blokovány proti modifikaci a/nebo likvidaci. Při aktualizaci Kaskády budou obnoveny aktuální definicí tiskové sestavy.
- Dostupná - tímto údajem lze sestavu, která je teprve ve vývoji, skrýt. Vývojáři Kasády se ale zobrazuje vždy.
- Výchozí počet kopií - tímto nastavením může vrcholový administrátor nebo administrátor tiskových sestav pro všechny uživatele určit výchozí počet kopií dané sestavy. Standardně je při dodávce systému u všech tiskových sestav hodnota 1.
  Toto nastavení se uživatelům projeví pouze v případě, že mají v uživatelských preferencích povolenou volbu Při tisku vždy přednastavit výchozí počet kopií pro danou sestavu.
- Textové pole s popisem sestavy - toto textové pole slouží k zaznamenávání úprav, které se v dané sestavě provedly.
Karta Dotaz

Tuto kartu může kdykoliv zobrazit pouze vývojář nebo administrátor tiskových sestav pokud je příslušná tisková sestava provedena na míru (jde o uživatelský tisk).

Karta obsahuje SQL dotaz, který dovede z jedné nebo více tabulek vybrat data podle zadaných podmínek, seskupit a vypočítat agregované hodnoty a výsledné záznamy vhodně uspořádat. Jako odpověď na dotaz vznikne fiktivní tabulka (kurzor), se kterou lze pracovat podobně jako s tabulkou. Nad tímto dotazem je postaven i WB pohled, který s danými daty pracuje.

Více informací o SQL dotazech najdete v 602SQL Helpu (viz. kapitola Vývoj a provoz aplikací v klientském prostředí / Dotazy, případně další).
Karta Data

Tato karta je dostupná pouze v případě, že má uživatel v uživatelských preferencích zapnutou volbu V dialogu pro parametry tisku zobrazit kartu Data.

Karta obsahuje data, která jsou základem tiskové sestavy. Tyto data je možné vyexportovat mimo Kaskádu (klávesovou zkratkou <Ctrl+E>). Více viz. Export dat tiskové sestavy do externího dokumentu.