(C) NDemia Ltd, 2012
Компонент расширения (плагин) для NDemia CashMatic: Симулятор приёма купюр
- 1 Назначение NDemia CashMatic SimCash
- 2 Установка NDemia CashMatic SimCash
- 3 Работа NDemia CashMatic SimCash
- 4 Некоторые дополнительные возможности NDemia CashMatic SimCash
- 4.1 Открытие и закрытие панели симулятора по команде из javascript
- 4.2 Проверка состояния панели симулятора из javascript
- 4.3 Программная симуляция ввода купюры
- 5 Удаление (отключение) NDemia CashMatic SimCash
1 Назначение NDemia CashMatic SimCash
Данная программа обеспечивает возможность отладки интерфейса приёма купюр в NDemia CashMatic KioskBrowser
(см. http://www.ndemia.com/CashMatic/)
2 Установка NDemia CashMatic SimCash
Для использования данной программы требуется установить NDemia CashMatic KioskBrowser версии не ниже 2.7.0:
http://www.ndemia.com/CashMatic/download/release/
Если NDemia CashMatic уже установлен, то загрузите инсталлятор и запустите установку SimCash:
http://www.ndemia.com/CashMatic/plugins/SimCash/Install.SimCash.exe
ВНИМАНИЕ: для симуляции приёма купюр должны быть обязательно сделаны некоторые настройки в Панели управления NDemia CashMatic ( http://www.ndemia.com/CashMatic/u-home/UG/setup/ )
На вкладке Купюроприёмник ( http://www.ndemia.com/CashMatic/u-home/UG/setup/billvalidator.php ) должен быть установлен флаг "Разрешить симуляцию ввода купюр".
На вкладке Интерфейс ( http://www.ndemia.com/CashMatic/u-home/UG/setup/interface.php ) должен быть установлен флаг "Использовать службу NDemia CashMatic Kiosk" и должен быть снят флаг "Игнорировать симуляцию ввода купюр".
ВСЕ УКАЗАННЫЕ НАСТРОЙКИ ОБЯЗАТЕЛЬНЫ, иначе симулятор работать не будет.
3 Работа NDemia CashMatic SimCash
Когда платёжный интерфейс NDemia CashMatic KioskBrowser перейдёт в режим приёма наличных, на экране в верхнем правом углу появится окно - панель "Симулятор приёма купюр", через которое нажатием кнопок можно имитировать ввод наличных.
При этом будут доступны только кнопки с номиналами купюр, приём которых разрешён по условиям MinBill/MaxBill ( http://www.ndemia.com/CashMatic/u-home/PG/bv/SessionObjProps.php )
Когда приём наличных будет программно отключен, окно автоматически закроется.
4 Некоторые дополнительные возможности NDemia CashMatic SimCash
4.1 Открытие и закрытие панели симулятора по команде из javascript
У разработчика прикладного скрипта есть возможность программно открывать и закрывать панель "Симулятор приёма купюр".
Панель открывается одним из вызовов (любым):
CashMatic.Session.Event("SimCash.Show");
CashMatic.Terminal.Event("SimCash.Show");
Панель закрывается одним из вызовов (любым):CashMatic.Session.Event("SimCash.Hide");
CashMatic.Terminal.Event("SimCash.Hide");
Для отключения автоматического открытия/закрытия панели при включении/выключении приёма купюр требуется настройка в системном реестре Windows.HKEY_LOCAL_MACHINE\SOFTWARE\NDemia\CashMatic\Plugins\SimCash
параметр ShowReasons (REG_DWORD)
значение 5 - панель открывается/закрывается только по командам прикладного скрипта;
значение 0x25 (по умолчанию) - панель открывается/закрывается и автоматически (при включении/выключении приёма купюр), и по командам прикладного скрипта.
4.2 Проверка состояния панели симулятора из javascript
Разработчик прикладного скрипта имеет возможность программно проверить, открыта ли панель "Симулятор приёма купюр".
CashMatic.Session.GetProp("SimCash.Display"); //если панель открыта, то "1" (истина), иначе - пустая строка (ложь)
4.3 Программная симуляция ввода купюры
Разработчик прикладного скрипта с помощью NDemia CashMatic SimCash может программно симулировать ввод купюр прямо из javascript (т.е. не пользуясь кнопками панели "Симулятор приёма купюр", а используя какой-либо собственный интерфейс или алгоритм).
//симулируем ввод 1000 рублей
CashMatic.Session.AddProp("SimCash.Bill", 1000); //параметр
CashMatic.Session.Event("SimCash.Simulate"); //выполнение
5 Удаление (отключение) NDemia CashMatic SimCash
Программное удаление NDemia CashMatic SimCash в текущей версии не реализовано.
Для удаления вручную нужно удалить папку "\Program Files\NDemia\CashMatic\Plugins\SimCash". Кроме этого, обязательно нужно удалить или отключить загрузку компонента в системном реестре, иначе будет выдаваться сообщение об ошибке запуска NDemia CashMatic KioskBrowser.
Для отключения загрузки компонента нужно удалить раздел реестра HKEY_LOCAL_MACHINE\SOFTWARE\NDemia\CashMatic\Plugins\SimCash (требуется удаление, переименования раздела недостаточно).
Для отключения без удаления раздела реестра достаточно удалить или переименовать параметр CLSID в указанном разделе.