Задание правил разбора штрих-кодов в input.ini позволяет добиться большой гибкости при обработке последовательностей данных, отличающихся по структуре.

Конфигурирование

Для возможности задания правил разбора штрих-кодов в input.ini необходимо:

1. Активировать плагин input в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/input.ini в секции [plugins].

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

   Пример настройки

   [plugins]
   ; Плагин разбора вводимых данных
   input = on

2. Задать правила разбора и преобразований в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/input.ini.

   Правила разбора представляют собой набор секций вида [Rule.<порядок>] или [Rule.<порядок>.<имя захваченного значения>], где <порядок> – целое положительное число.

   Пример

   ;[Rule.1]
   ; Правило разбора с порядком 1
   ...
   
   ;[Rule.1.code]
   ;Правило преобразования захваченного значения code
   ...
   
   ;[Rule.1.weight]
   ;Правило преобразования захваченного значения weight
   ...
   
   ;[Rule.2]
   ; Правило разбора с порядком 2
   ...
   
   ;[Rule.2.barcode]
   ;Правило преобразования захваченного значения barcode
   ...
   
   ;[Rule.2.weight]
   ;Правило преобразования захваченного значения weight
   ...
   
   ;[Rule.2.price]
    ;Правило преобразования захваченного значения price
   ...
   
   

   В каждой секции задается одно правило в формате:

   search = <регулярное выражение со значениями для захвата>

   В каждой секции вида [Rule.<порядок>.<имя захваченного значения>] задаются два правила в формате:

   search = <регулярное выражение со значениями для захвата>  
   replace = <выражение для подстановки обработанных захваченных значений в исходное регулярное выражение>

   Допускается использование следующих имен для захваченных значений:

   • barcode – штрих-код товара,

   • code – код товара,

   • weight – вес товара,

   • price – цена товара,

   • quantity – количество товара.

   Пример настройки

   ;[Rule.1]
   ; Правило разбора с порядком 1
   ;search = "((?<piece>26)|(?<fractional>27))(?<code>[0-9]{10})(?(piece)(?<quantity>[0-9]{5})|(?<weight>[0-9]{5})),[0-9]{5};"
   
   ;[Rule.2]
   ; Правило разбора с порядком 2
   ;search = "(?<text>.*prc=)?(?<barcode>[0-9]{13})(?<price>P[0-9]*)?(?<date_price>D[0-9]{6})?(?<old_price>L[0-9]*)?"
   
   ;[Rule.1.code]
   ; Правило преобразования захваченного значения code
   ;search = "0*([0-9]{0,10})"
   ;replace = "\1"
   
   ;[Rule.1.weight]
   ; Правило преобразования захваченного значения weight
   ;search = "0*([0-9]{0,2})([0-9]{3})"
   ;replace = "\1.\2"
   
   ;[Rule.2.price]
   ; Правило преобразования захваченного значения price
   ;search = "^P(.*)([0-9]{2}$)"
   ;replace = "\1.\2"

   Имена piece и fractional используются для захвата целых и дробных значений соответственно и могут быть заданы произвольно.

   Значения date_price и old_price не используются кассовым ПО.

   Значения для префиксов кодов или штрих-кодов (в примере выше – 26 и 27) могут быть заданы произвольно.

   Значения по умолчанию не заданы. Для корректной работы необходимо раскомментировать секции и параметры.

Принцип работы

Поиск подходящего правила разбора происходит по возрастанию порядка. Если введенная последовательность данных удовлетворяет правилу разбора, то будет осуществлен переход к разбору по секциям для захваченных значений. При корректных данных товары с введенными штрих-кодами (кодами) будут добавлены в чек.

Если введенные данные содержат как штрих-код товара так и код, то товар будет добавлен по штрих-коду.

Если введенные данные содержат как вес товара так и количество, то товар будет добавлен со значением веса.

Примеры разбора

Добавление товара с применением следующего правила

В кассовом ПО Artix реализована возможность применения следующего правила к вводимым данным, если при добавлении в чек товар не был найден. Для этого необходимо включить настройку useNextRuleIfGoodsNotFound в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/input.ini в секции [Input]:

• при значении true, если товар не найден по правилу разбора, то используется следующее правило,
• при значении false следующее правило разбора не применяется.

[Input]
; Применить следующее правило к вводимым данным, если товар не найден
; По умолчанию false
useNextRuleIfGoodsNotFound = true

Логирование

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