Правила считывания конфигурационных файлов

Настройки вступают в силу после перезапуска кассовой программы.

Конфигурационные файлы представляют собой файлы формата *.ini, в которых находятся настройки кассового ПО Artix. Основным конфигурационным файлом является /linuxcash/cash/conf/ncash.ini, также настройки могут находиться в директориях /linuxcash/cash/conf/ncash.ini.d/ и /linuxcash/cash/conf/ncash.ini.d/puppet/.

Порядок считывания настроек:

  1. Сначала считываются настройки из основного конфигурационного файла /linuxcash/cash/conf/ncash.ini.

  2. Затем считываются настройки из конфигурационных файлов директории /linuxcash/cash/conf/ncash.ini.d/.

  3. В последнюю очередь считываются настройки из конфигурационных файлов директории /linuxcash/cash/conf/ncash.ini.d/puppet/.

Настройки из директории /linuxcash/cash/conf/ncash.ini.d/puppet/, являются самыми приоритетными, они будут применены для кассового ПО Artix.

Дополнительные конфигурационные файлы

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

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

  1. Указать в дополнительном конфигурационном файле секции, необходимые параметры и их значения.

    Секции в основном и дополнительном конфигурационных файлах должны совпадать.

  2. Используя директиву include в основном конфигурационном файле указать путь до дополнительного.

    Пример

    Дополнительный конфигурационный файл был создан в директории /linuxcash/test.conf.

    В основном конфигурационном файле в директории /linuxcash/cash/paysystems/yarus/artixyarus.conf указаны следующие настройки, а также путь до дополнительного конфигурационного файла:

    Пример настройки основного конфигурационного файла
    [main]
    
    ;Хост терминала (По умолчанию 192.168.0.1)
    host = 192.168.10.1
    
    ;Порт терминала (По умолчанию 5757)
    port = 5757
    
    @include /linuxcash/test.conf

    Дополнительный конфигурационный файл имеет следующие параметры:

    Пример настройки дополнительного конфигурационного файла
    [main]
    port = 4444
    valCode = 777
    Если параметры, считанные из основного конфигурационного файла, совпадают с параметрами из дополнительного конфигурационного файла, то они перезаписываются.

    В данном случае будет применен новый параметр valCode со значением "777", значение параметра port будет перезаписано на "4444", значение параметра host останется прежним: "192.168.10.1".

Просмотр актуальных настроек кассы

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

Для просмотра актуальных настроек кассы необходимо выполнить команду:

/linuxcash/cash/bin/currentsettings
Пример вывода
Текущие настройки:
[GUI]
	interface = keyboard                                                                               (/linuxcash/cash/conf/ncash.ini.d/gui.ini)
	showCursor = false                                                                                 (/linuxcash/cash/conf/ncash.ini.d/gui.ini)
	pricePrecisionToShow = 2                                                                           (/linuxcash/cash/conf/ncash.ini.d/gui.ini)
[Shift.Duration]
	enableLimit = false                                                                                (/linuxcash/cash/conf/ncash.ini)
Для просмотра актуальных настроек для отдельной секции необходимо выполнить команду:
/linuxcash/cash/bin/currentsettings -s <название секции>
Пример вывода для секции GUI
{
    "priceprecisiontoshow": "2",
    "showcursor": "true"
}
Для просмотра актуальных значений для отдельной настройки из секции необходимо выполнить команду:
/linuxcash/cash/bin/currentsettings -s <название секции>:<название настройки>
Пример вывода для настройки showcursor из секции GUI
true
  • No labels