Základní informace
- Tisk do tiskové šablony umožňují tlačítka umístěná v editačním formuláři nebo na nahlížecí stránce.
- Mezi podporované tiskové šablony patří soubory „xls“, „xlsx“, „doc“, „docx“, „html“, „txt“, „csv“ a „pdf“.
- Tiskové šablony „xlsx“ a „docx“ podporují automatickou konverzi do „pdf“.
Umístění a správa tiskových šablon
- Tiskové šablony musí být uloženy v adresáři „NETGenium\Templates“.
- Do tohoto adresáře je možné soubory nakopírovat napřímo z plochy serveru, nebo prostřednictvím dialogu pro nastavení NET Genia na záložce „Tiskové šablony“.
- Z těchto souborů je následně možné vybírat přímo ve vlastnostech tlačítka zvolenou tiskovou šablonu.
Identifikátory a proměnné v tiskových šablonách
- V tiskových šablonách mohou být používány pouze identifikátory databázových ovládacích prvků a skriptové proměnné.
- Skriptové proměnné je možné naplnit před samotným tiskem pomocí skriptu.
- Na místo v šabloně, kam je potřeba dosadit hodnoty, se vkládají identifikátory databázových ovládacích prvků nebo názvy proměnných.
- NET Genium otevře tiskovou šablonu, vyhledá výskyty všech identifikátorů, a nahradí je příslušnými hodnotami.
Tisk z editačního formuláře
- Dosazení hodnot databázových ovládacích prvků do tiskové šablony z aktuálně otevřeného záznamu v editačním formuláři používá identifikátory ve zkráceném tvaru ve formátu „#ng_ovládací_prvek#“.
Tisk z nahlížecích stránek a tabulek
- Tisk záznamů nahlížecí tabulky vyžaduje používání identifikátorů v plném tvaru v následujících možných formátech:
První formát (doporučený)
- „#DG10#.#ng_ovládací_prvek#”, „#DG11#.#ng_ovládací_prvek#”, atd.
- Určený a nejvhodnější pro datagridy, používá zapisování pomocí ID datagridu (JavaScriptový název prvku).
- Tento způsob je stabilnější v případech, kdy se do formuláře přidávají další datagridy a mění se tak jejich pořadí, což by u druhého formátu vedlo ke změně identifikátoru.
- Zjištění identifikátoru
Druhý formát
- „#datagrid1#.#ng_ovládací_prvek#”, „#datagrid2#.#ng_ovládací_prvek#”, atd.
- Formát plného identifikátoru s pojmenováním typu vizuálního ovládacího prvku a s číslem jeho pořadí zohledňuje situace, kdy je v editačním formuláři nebo na nahlížecí stránce umístěno více nahlížecích tabulek se stejným zdrojem dat, jen s různými omezujícími podmínkami.
- Další příklady: ** „#calendar1#.#ng_ovládací_prvek#”, „#calendar2#.#ng_ovládací_prvek#”, atd. ** „#timetable1#.#ng_ovládací_prvek#”, „#timetable2#.#ng_ovládací_prvek#”, atd. ** „#planner1#.#ng_ovládací_prvek#”, „#planner2#.#ng_ovládací_prvek#”, atd.
Třetí formát
- „#ng_formulář#.#ng_ovládací_prvek#”.
Chování tisku při použití plných identifikátorů
- NET Genium rozpoznává výskyt identifikátorů v plném tvaru, a zajistí automatické vkládání hodnot jednotlivých záznamů pod sebe.
- Jsou-li identifikátory umístěny vedle sebe v jedné řádce, je výstupem tisku tabulka, kde má každý záznam tabulky svůj řádek v tiskové šabloně.
- Jsou-li identifikátory umístěny vedle sebe ve dvou řádcích, je výstupem tisku tabulka, kde se každý záznam tabulky skládá ze dvou řádek v tiskové šabloně.
Specifické scénáře tisku
- Tisk z nahlížecí stránky, která obsahuje pouze jednu nahlížecí tabulku, nevyžaduje identifikátory v plném tvaru, stačí identifikátory ve zjednodušeném tvaru.
- Tisk statistické nahlížecí tabulky s agregovanými sloupci používá identifikátory sloupců „c0“, „c1“, „c2“ atd., tj. podle jejich pořadí v hlavičce tabulky, s číslováním od nuly.
Formátování hodnot v tiskových šablonách
- Tiskové šablony vytvořené v aplikaci MS Word musí mít identifikátory umístěné v poli typu „MergeField“.
- Hodnoty mohou být v tiskové šabloně formátovány podle šablon pomocí syntaxe „#identifikátor@formát#“.
Události po tisku
- Po úspěšném vytvoření tiskové sestavy se automaticky spouští externí funkce „NETGenium.OnAfterPrint“, ve které je možné ovlivnit jak název výsledného souboru, tak i obsah nebo formát souboru.
Vztah k další dokumentaci
