1. Problém

Při zavádění tiskových parametrů do šablon může často dojít k tomu, že se tiskový parametr nenačte (je místo něj prázdné místo) nebo se v sestavě objeví místo konkrétní hodnoty právě tiskový parametr (příklad: Tato smlouva byla vydána dne [[Smlouva_datum]].)

2. Příčina

Pokud jsme si jisti, že se hodnota, kterou načítáme v Evoliu skutečně nachází, je zřejmě problém v některé ze tří fází, kterými Evolio prochází když data z databáze načítá a zadává je do tiskové sestavy. Při načítání každého parametru se prochází těmito fázemi:
1. fáze - Hledání parametrů - Evolio projde postupně všechny parametry v sestavě a u každého zjistí, zda vůbec takový tiskový parametr v seznamu parametrů existuje.
2. fáze - Načítání hodnot z databáze - Evolio v této fázi pro každý parametr načítá hodnoty z databáze.
3. fáze - Dosazování hodnot do šablony - Všechny hodnoty, které Evolio najde dosadí do šablony.
Potenciálně největším zdrojem chyb a problémů může být třetí fáze.

3. Řešení

Řešením situace, kdy se některý parametr nezobrazuje korektně nebo vůbec, mohou být tzv. ladící parametry, které lze umístit kdekoliv do sestavy.

Použitelné ladicí parametry:

#Debug - Základní parametr, který spouští při zadání tisku šablony ladící konzolu. Bez zadání tohoto parametru nemůžeme ladit.
#Step - Rovněž důležitý parametr. Bez jeho zadání by se pouze vypsal log toho, co se stalo, ale nemohli bychom práci Evolia s parametry krokovat.
#LogAll - Pokud vůbec nevíme, ve které fázi chyba při tisku šablony nastává, zavoláme tento parametr, který loguje všechny tři fáze.
#LogX - X zastupuje číslo jedné ze tří fází, pokud máme tušení, kde by mohlo k chybě docházet, je zbytečné logovat vše, stačí logovat jen fázi, kterou potřebujeme.
#Show - Ukazuje jak textový výpis každého parametru, tak grafické zpracování v dokumentu (užitečné zejména při dosazování ve třetí fázi)
#ShowAll - Ukazuje textový výpis každého parametru.

Příklad použití v tiskové šabloně:

#Debug#Step#Show#Log1#

Ladicí aplikace

Taková sekvence příkazů spustí ladící aplikaci, kde se po jednotlivých parametrech postup zastaví a bude čekat na odezvu uživatele. Odezva může být buď kliknutí na tlačítko "Další" nebo kliknutím na tlačítko "Přeskočit".
Další - Tlačítko Další posunuje ladící konzolu na zpracování dalšího kroku.
Přeskočit na další kategorii - znamená, že ladicí program přejde ke zpracování další fáze.
Přeskočit dokud nenalezne slovo - lze použít pro hledání chyby v konkrétním tiskovém parametru. Provede bez zastavení všechny kroky, dokud nenarazí na konkrétní hledaný výraz.

Vzhled ladicí aplikace a zobrazení dokumentu při ladění


4. Klíčová slova

Tiskové parametry, ladění, tiskové šablony, ladící aplikace