Pokladní systém PD 2002 v1.00 Servisní manuál -1 -
-2 -
Instalace programu spočívá ve zkopírování souborů do zvoleného adresáře a vytvoření adresářové struktury dle popisu. Programový soubor pokladna.exe se spouští z aktuálního ze svého adresáře. Před spuštěním je třeba nastartovat rezidentní podporu DPMI (cwsdpmi.exe). Program pracuje s kódovou stránkou 852. I.1. I.1.1. Soubory Struktura adresáře Adresář pokladního systému má následující strukturu: <pokladni> adresář s profily pokladnich <publi> adresář pro výkazy prodeje publikací <report> adresář reportů <trans> adresář transakčních logů <vstup> adresář pro výkazy prodeje vstupenek pokladna.exe hlavní program pokladna.cfg konfigurační soubor (viz. dále) pokladna.log hlavní log, zaznamenává spuštění a ukončení programu, chybové stavy a diagnostická data publi.csv definiční soubor publikací vstup.csv definiční soubor vstupenek Externí adresáře (mohou být i na jiných discích... jejich umístění definuje pokladna.cfg): <backup> adresář záložních kopií <pool> přenosový adresář (pro kopírování na server) <server> adresář s namapovaným síťovým diskem... tyto adresáře musí mít v sobě vytvořenou strukturu pro kopírování/zálohování reportů a logů. Minimum je vytvoření vnitřních adresářů: <publi>,<report>,<trans> a <vstup> -3 -
I.2. Konfigurační soubor Systém je konfigurován textovým souborem pokladna.cfg standardní struktury typu: Klíč = <hodnota> Popis jednotlivých klíčů konfiguračního souboru je uveden přímo v něm coby komentář. Za komentář je považována každá řádka začínající znakem #. Soubor musí být umístěn vždy v aktuálním adresáři v okamžiku spouštění systému. I.2.1. Definiční soubory Jména definičních souborů jsou uvedena v konfiguraci (standardně publi.csv a vstup.csv). Definiční soubory obsahují jména ID a ceny publikací a vstupenek. Jsou textové soubory formátu CSV MS Excel, kde na každém řádku je jedna položka, parametry položky jsou odděleny středníkem. Soubory mohou obsahovat také doplňkové informace, na které pokladní systém nebere zřetel. Z každého souboru je vynecháno prvních X řádek coby hlavička (pro každý ze souborů je velikost hlavičky definovaná v pokladna.cfg). Z každé řádky jsou pak vybrány ty parametry, které definují ID, jméno a cenu publikace/vstupenky. Vybraný parametr je definován v pokladna.cfg jako index v poli parametrů vzniklém z jedné řádky definičního souboru (oddělovačem položek je ; ). Příklad souboru vstup.csv a nastavení v pokladna.cfg: vstup.csv ID ;jméno ;cena 99999;Dospělí;30,00 99998;Děti/studenti;20,00 99997;Neplatící;0 99996;Rodina;70,00 99995;Výprava;30,00 pokladna.cfg dsvsoubor = vstup.csv dsvhlavicka = 1 dsvjmeno = 2 dsvid = 1 dsvcena = 3-4 -
Cena musí mít jeden z následujících formátů: celé koruny koruny a haléře oddělené tečkou nebo čárkou (haléře vždy 2 cifry) I.2.2. Pokladníci Profily pokladníků jsou uloženy v adresáři <pokladni>. Názvy profilových souborů mají tvar??.pro kde dvoupísmenný název je zároveň jednoznačným identifikátorem pokladníka. Soubor má stejný formát jako pokladna.cfg. Klíče jsou však jen dva: jméno pokladníka a zakódované PIN. K vytvoření nového pokladníka, popřípadě přepsání stávajícího (např. změna PIN) slouží jednoduchý program pokladní.exe v adresáři <pokladni>. I.2.3. Logy Systém má dva logy aplikační a transakční. Aplikační log zaznamenává činnost aplikace (starty, ukončení, chyby). Je umístěn v hlavním (aktuálním) adresáři aplikace. Struktura aplikačního logu je: <datum> <čas> <činnost/stav> Transakční logy jsou generovány zvlášť pro každý den a zaznamenávají obchodní transakce (prodeje). Jméno transakčního logu má formát: ddmmrr.log (den, měsíc, rok každá část dvě číslice). Formát transakčního logu: HH:MM:SS ----ID- T NN CCCCCCC PP GGGGG --CRC- hh:mm:ss - čas transakce (datum je definováno názvem souboru) ID - ID publikace/vstupenky (integer:7) T - typ transakce N = běžná návštěvnická vstupenka V = vstupenka v rámci výpravy P = prodej publikací O = oprava (není podporováno) NN - počet kusů (integer:2 = 1..99) CCCCCCC - cena v haléřích za kus (integer:7) PP - identifikační zkratka pokladníka (string:2) -5 -
GGGGG CRC - číslo transakce v daném dni = pořadové číslo paragonu (integer:5) - zabezpečovací kód (string:6) Transakční log je chráněn proti neoprávněným zásahům kódem CRC32. Jakýkoli zásah do souboru bude má za následek porušení zabezpečení. Porušení integrity transakčního logu je hlášeno v aplikačním logu a ve všech denních reportech. I.2.4. Reporty a výkazy Při ukončování generuje pokladní systém přehledové soubory, které archivuje a odesílá po lokální síti na server k dalšímu zpracování. Adresář reportů <report> bsahuje pro každý den vygenerovaný report návštěvnosti. Formát jména je stejný jako u transakčního logu: ddmmrr.log První část reportu je textová a obsahuje tisknutelný přehled návštěvnosti za daný den. Každá řádka začíná znakem # (komentář) pro oddělení od datové části. Druhá část reportu obsahuje strojově zpracovatelnou tabulku návštěvnosti formátu: <typ vstupenky>;<dopoledne>;<odpoledne>;<večer> Položky jsou odděleny středníky a formát je kompatibilní s MS Excel CSV. Do adresářů <publi> a <vstup> jsou ukládány výkazy prodeje. Formát jména souborů je ddmmrrxx.log kde prvních 6 znaků se shoduje s formátem transakčního logu a reportu (den,měsíc,rok) a XX je kód pokladníka. Výkazy slouží jako vstupy do systému skladového hospodářství, neboť každý s pokladníků má svůj vlastní podsklad ze kterého čerpá publikace a vůči kterému vykazuje tržbu. V adresářích se nacházejí dva typy souborů: *.TXT klasické textové výkazy vhodné pro tisk nebo k nahlédnutí; *.EUR soubory respektující standard přenosu dat mezi registračními pokladnami typu EURO2000 a skladovými systémy. -6 -
I.2.5. Vzdálená konfigurace V adresáři <server> je možné umístit konfigurační dávku pro pokladní systém. Při startu pokladní počítač hledá na serveru soubor davka.bat... existuje-li je spuštěn. Dávka může obsahovat libovolné příkazy DOS 6.22. Po provedení je dávkový soubor ze serveru smazán (známka toho, že byl proveden). I.3. Spouštění I.4. Ukončení -7 -