Кассовое ПО Artix позволяет выводить диалог с запросом подтверждения перед выполнением определенных кассовых команд. Этот механизм предназначен для предотвращения случайных действий кассира при возврате товаров.

Конфигурирование модуля

Активация модуля режима подтверждения действий определяется параметром confirmationmode, который задается в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/confirmationmode.ini в секции [plugins].

Наименование	Тип данных	Возможные значения	Описание	Примечания
confirmationmode	строковый	on off	Активация модуля режима подтверждения действий	По умолчанию `off`

[plugins]
; Режим подтверждения действий
;confirmationmode = off

Для настройки плагина подтверждения действий необходимо в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/confirmationmode.ini добавить подсекцию

вида [ConfirmCommand.<Порядковый номер>]. Каждая подсекция может содержать следующие параметры:

Наименование Тип данных Возможные значения Описание Примечания

command

строковый

COMMAND_BACKBYSALE
COMMAND_BACK

Команда для подтверждения действия

Применение модуля с другими командами требует проведения дополнительного тестирования на корректность выполнения.

text

строковый

Текст в диалоге для подтверждения действия

contexts

строковый

4 – главное меню,
6 – открытый документ,
18 – возврат по чеку продажи,
255 – любой контекст

Список кодов контекстов, в которых при выполнении команды требуется подтверждение. Значения указываются через запятую

Если параметр contexts не указан, то диалог для подтверждения действия будет выведен на экран при вызове команды в любом контексте

Диалог для подтверждения действия будет выведен на экран при условии, что команда вызывается в указанном контексте.

; Настройка команд для подтверждения действий
; Для добавления команды необходимо добавить секцию вида
;
;[ConfirmCommand.<Порядковый номер>]
;command = COMMAND_BACKBYSALE
;text = Вы уверены, что хотите продолжить операцию возврата по чеку продажи?
;contexts = 6
; где command - команда для подтверждения действия
; text - текст в диалоге для подтверждения действия
; contexts - список кодов контекстов, в которых при выполнении команды требуется подтверждение. Если не указано, то во всех контекстах.

;[ConfirmCommand.1]
;command = COMMAND_BACKBYSALE
;text = Вы уверены, что хотите продолжить операцию возврата по чеку продажи?
;contexts = 6

Подтверждение при возврате

Для появления диалога подтверждения при возврате и возврате по чеку продажи необходимо:

Активировать модуль режима подтверждения действий.
[plugins] ; Режим подтверждения действий confirmationmode = on

Настроить подсекции с командами.

[ConfirmCommand.1]
command = COMMAND_BACK
text = Вы уверены, что хотите продолжить операцию возврата?

[ConfirmCommand.2]
command = COMMAND_BACKBYSALE
text = Вы уверены, что хотите продолжить операцию возврата по чеку продажи?
contexts = 6

Перезапустить кассовую программу.

При вызове команды:

COMMAND_BACK на экране будет отображен диалог "Вы уверены, что хотите продолжить операцию возврата?". При нажатии кнопки "Продолжить" будет произведен переход в режим возврата.
COMMAND_BACKBYSALE на экране будет отображен диалог "Вы уверены, что хотите продолжить операцию возврата по чеку продажи?". При нажатии кнопки "Продолжить" будет произведен переход в выбор документа продажи.

Возможные ошибки

Если в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/confirmationmode.ini в подсекции [ConfirmCommand.<Порядковый номер>]:

некорректно указано значение для параметра command, то диалог для подтверждения действия не будет выведен. В логе будет предупреждение:
WARN confirmationmode - Неизвестная команда COMMAND_BACKBYSALE1
не указан параметр text, то диалог для подтверждения действия не будет выведен. В логе будет предупреждение:
WARN confirmationmode - Не указан текст для подтверждения команды COMMAND_BACKBYSALE
некорректно указано значение кодов для параметра contexts, то диалог для подтверждения действия не будет выведен. В логе будет предупреждение:
WARN confirmationmode - Неверный код контекста 144 для команды COMMAND_BACKBYSALE

Логирование

Логирование запросов на подтверждение ведется в основном логе кассовой программы /linuxcash/logs/current/terminal.log.