Интерфейс
CashMaticCashSessionEvents не реализуется собственными объектами
NDemia CashMatic.
Этот интерфейс должен реализовываться объектом или объектами прикладных скриптов, разрабатываемых на основе
NDemia CashMatic.
Объект, реализующий интерфейс
CashMaticCashSessionEvents, называется обработчиком событий сеанса купюроприёмника (см.
Примеры обработчиков событий сеанса купюроприёмника).
Сеанс купюроприёмника (объект
CashMaticCashSession) имеет методы установки (добавления) обработчиков (
AddHandler) и удаления обработчиков (
RemoveHandler).
Установка обработчиков событий сеанса купюроприёмника не является обязательной.
Может быть установлено один и более одного обработчиков событий от одного источника (сеанса купюроприёмника).
Каждый обработчик событий, установленный методом
AddHandler объекта
CashMaticCashSession, должен быть удалён методом
RemoveHandler объекта
CashMaticCashSession.
Допускается многократная установка одного обработчика событий, число удалений должно соответствовать числу установок.
Обработчик событий уведомляется о событиях сеанса купюроприёмника посредством вызовов соответствующих методов.
Установка обработчика событий методом
AddHandler и удаление обработчика событий методом
RemoveHandler допускаются в любое время, в том числе во время выполнения метода данного или другого обработчика событий.
Во время выполнения методов обработчик событий не должен без существенных причин изменять объект-источник событий (сеанс купюроприёмника,
CashMaticCashSession), поскольку это может породить вложенные события с вызовом других методов (таким образом, будет нарушена естественная последовательность событий, что создаёт трудности для разработки и отладки стабильно работающего приложения).
Обработчик событий не должен полагаться на отсутствие других обработчиков в том же сеансе купюроприёмника (они могут быть, например, неявно установлены
компонентами расширений).
Если одновременно установлено несколько (более одного) обработчиков событий:
- не требуется соблюдение какого-либо соответствия между порядком добавления и порядком удаления обработчиков событий (кроме точного баланса вызовов AddHandler/RemoveHandler);
- все установленные обработчики событий будут в равной мере уведомляться о событиях сеанса купюроприёмника;
- не гарантируется какой-либо определённый порядок уведомления различных обработчиков;
- никакой из установленных обработчиков событий не может препятствовать уведомлению всех остальных установленных обработчиков событий или влиять на это уведомление каким-либо образом.
| Имя | Тип результата | Тип обращения | Назначение |
| OnAccept(CashSession, Bill) | Пустой | Метод | Метод вызывается при успешном приёме купюры Bill (номинал купюры, объект CashMaticBill) в сеансе купюроприёмника CashSession (объект CashMaticCashSession).
|
| OnActive(CashSession, Active) | Пустой | Метод | Метод вызывается при изменении активности сеанса купюроприёмника (изменении свойства Active или вызове метода Cancel), т.е. при включении или выключении приёма/проверки купюр.
Параметр CashSession - сеанс купюроприёмника (объект CashMaticCashSession);
Параметр Active - логическое значение, равное новому (изменившемуся) значению свойства CashMaticCashSession.Active. |
| OnBillCount(CashSession, BillCount) | Пустой | Метод | Метод вызывается при изменении количества принятых купюр в сеансе купюроприёмника CashSession (объект CashMaticCashSession), как при успешном приёме купюры, так и при сбросе счётчиков вызовом CashMaticCashSession.ResetCounters().
Параметр BillCount - значение, равное новому (изменившемуся) количеству принятых купюр (объект CashMaticCashCounter).
|
| OnBillRange(CashSession, MinBill, MaxBill) | Пустой | Метод | Метод вызывается при изменении диапазона допустимых номиналов купюр в сеансе купюроприёмника CashSession (объект CashMaticCashSession), как при изменении диапазона через свойство CashMaticCashSession.MinBill, свойство CashMaticCashSession.MaxBill, метод CashMaticCashSession.SetBillRange(MinBill, MaxBill), так и при сбросе диапазона вызовом метода CashMaticCashSession.ResetBillRange().
Параметр CashSession - сеанс купюроприёмника, в котором произошло изменение диапазона допустимых номиналов купюр (объект CashMaticCashSession);
Параметр MinBill - значение, равное новому (изменившемуся) минимальному допустимому номиналу купюр (объект CashMaticBill);
Параметр MaxBill - значение, равное новому (изменившемуся) максимальному допустимому номиналу купюр (объект CashMaticBill).
|
| OnCancel(CashSession) | Пустой | Метод | Метод вызывается при отмене/прекращении приёма/проверки купюр в сеансе купюроприёмника CashSession (объект CashMaticCashSession). |
| OnDetect(CashSession, Bill) | Пустой | Метод | Метод вызывается при успешной проверке купюры Bill (номинал купюры, объект CashMaticBill) в сеансе купюроприёмника CashSession (объект CashMaticCashSession).
|
| OnFailure(CashSession) | Пустой | Метод | Метод вызывается при ошибке купюроприёмника в сеансе CashSession (объект CashMaticCashSession). |
| OnReject(CashSession) | Пустой | Метод | Метод вызывается в случае браковки купюры при приёме/проверке в сеансе купюроприёмника CashSession (объект CashMaticCashSession).
Бракованная купюра возвращается пользователю.
Номинал купюры недоступен (либо купюроприёмник его не определил, либо определил как выходящий за пределы диапазона допустимых номиналов - см. объект CashMaticCashSession, свойства MinBill и MaxBill, методы SetBillRange и ResetBillRange). |
| OnTimeout(CashSession, Timeout) | Пустой | Метод | Метод вызывается в случае завершения по таймауту приёма/проверки купюры в сеансе купюроприёмника CashSession (объект CashMaticCashSession).
Параметр Timeout - таймаут (превышенное значение, в секундах). |
Совместимость: интерфейс CashMaticCashSessionEvents поддерживается в NDemia CashMatic, начиная с версии 2.6.0
