Кассовое ПО 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

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

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

  1. Активировать модуль режима подтверждения действий.

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

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

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

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

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

  • 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. 

  • No labels