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
adresář pro výkazy prodeje publikací adresář reportů adresář transakčních logů 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): 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ářů: ,, a
-3 -
I.2.
Konfigurační soubor
Systém je konfigurován textovým souborem pokladna.cfg standardní struktury typu: Klíč = 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
pokladna.cfg
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 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:
<č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 ID T
NN CCCCCCC PP
- čas transakce (datum je definováno názvem souboru) - ID publikace/vstupenky (integer:7) - 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) - počet kusů (integer:2 = 1..99) - cena v haléřích za kus (integer:7) - 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ů 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: ;<dopoledne>;;
Položky jsou odděleny středníky a formát je kompatibilní s MS Excel CSV. Do adresářů a 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 -
