Сеанс купюроприёмника - это процесс, в ходе которого купюроприёмник принимает купюры от пользователя. С точки зрения общего сценария платежа (сценария работы пользователя) приём купюр часто удобно рассматривать как одно целостное событие или состояние: "пользователь вносит деньги". На самом деле за время этого состояния происходит ряд переключений - сеанс купюроприёмника состоит из одного и более циклов включения-выключения приёма купюр на купюроприёмнике, причём каждый цикл может отличаться от других диапазоном принимаемых купюр, таймаутом и т.п.
NDemia CashMatic сообщает прикладному скрипту о различных событиях, связанных с купюроприёмником и соответствующих различным изменениям параметров, успешному или неуспешному приёму купюр и т.п.
Для получения этих событий прикладная программа (скрипт) должна создать собственные обработчики.
Исходя из основного назначения купюроприёмника (приём и проверка купюр), самыми главными являются события приёма купюры (
OnAccept) или проверки купюры (
OnDetect) объекта
CashMaticCashSession.
Следует обратить особое внимание на завершение приёма или проверки купюр, поскольку при некорректном завершении можно потерять информацию о последней купюре, введённой "почти одновременно" с моментом завершения.
Во избежание потери последней купюры прикладная программа должна обязательно завершать режим приёма/проверки купюр явным вызовом
CashSession.Active = false;
или
CashSession.Cancel();
где
CashSession - это объект
CashMaticCashSession, созданный как
CashMatic.Cash.CreateSession();
В этом случае купюры больше не будут приниматься купюроприёмником, несмотря на существование объекта
CashMaticCashSession (используемый в javascript механизм "сборки мусора" (garbage collection) может задерживать удаление объекта, даже если все ссылки на объект освобождены).
Далее приведены примеры реализации обработчиков событий в прикладном скрипте, для следующих случаев:
- Строка javascript как обработчик события сеанса купюроприёмника;
- Функция javascript как обработчик события сеанса купюроприёмника;
- Объектный обработчик событий сеанса купюроприёмника.
