API Wysokiego Poziomu
Zestaw funkcji wysokiego poziomu obs³uguj¹cych rozkazy kasy.
Więcej...
Opis szczegółowy
Zestaw funkcji wysokiego poziomu obs³uguj¹cych rozkazy kasy.
Zestaw funkcji wysokiego poziomu sk³ada siê z dwóch rodzajów funkcji. Pierwsza grupa o nazwach POSS_XXX s³u¿y do tworzenia i wysy³ania do kasy rozkazów. Druga grupa funkcji o nazwach POSG_XXX s³u¿y do odbioru i analizy danych zwracanych w wyniku wys³ania odpowiedniego rozkazu do kasy.
Dokumentacje poszczególnych parametrów funcji znajduj¹ siê w dokumentacji programisty kasy COMBO. Wiêkszoœæ parametrów literalnie odpowiada zarówno typami danych jak i przyjmowanymi wartoœciami. Jednak¿e dla zmiejszenia iloœci parametrów wywo³añ w sytuacja, gdy w parametrach funkcji wystêpuj¹ wartoœci i bloki powtarzaj¹ce siê, zosta³y one zast¹pione listami wartoœci (znakowymi) oddzielanymi separatorami - znakiem \n (nowej linii). Oprócz tego, we wszystkich miejscach, gdzie wystêpuj¹ pojêcia daty i czasu s¹ one przekazywane i zwracane w formacie zgodnym z ISO-8601 w postaci ci¹gu znaków o formacie: "RRRR-MM-DDTHH:MM:SS".
Ka¿da funkcja POSS_XXX przyjmuje 3 standardowe parametry
- hDevice - uchwyt urz¹dzenia,
- phRequest - wskaŸnik do POSNET_HANDLE w którym umieszczony zostanie uchwyt stworzonego i wys³anego zapytania. Jeœ³i informacja ta nie jest pottrzebna mo¿na przekazaæ wartoœæ NULL,
- tryb - tryb wysy³ania rozkazu por. Tryby wysy³ania rozkazów
Pozosta³e parametry s¹ zale¿ne od rozkazu.
- Ostrzeżenie:
- Funkcje POSS_ w przypadku b³êdu NIE USUWAJ¥ stworzonego obiektu rozkazowego. Nale¿y go usun¹æ poprzez przekazanie do funkcji POSG_Default lub u¿ycie POS_DestroyRequest.
Ka¿da funcja POSG_XXX przyjmuje jeden standardowy parametr:
- hRequest - uchwyt odebranej odpowiedzi do rozkodowania.
W przypadku, gdy wynik operacji nas nie interesuje mo¿emy u¿yæ funcji
POSG_Default, która automatycznie zniszczy wynik, zwracaj¹c jedynie status operacji (bez danych). W ten sposób wszystkie operacje POSS_XXX maj¹ swó odpowiednik w postaci POSG_XXX lub POSG_Default.