Для работы Exchanger необходимо установить пакет artix45-exchangers, в результате чего на кассе появится каталог /linuxcash/cash/exchangesystems.

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

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

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

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

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

Настройки из директории /linuxcash/cash/exchangesystems/exchangers/config/cash/conf.d/ являются самыми приоритетными. Если они заданы, то в первую очередь будут использоваться они.

При обработке файлов-справочников и файлов-продаж всегда используется рабочая директория, в которой формируются данные файлы. Процесс работы Exchanger записывается в лог-файлы. Расположение всех файлов и директорий задается общими настройками в секции [main] конфигурационного файла /linuxcash/cash/exchangesystems/exchangers/config/cash/exchangers.ini.

Наименование

Тип данных

Описание

Примечания

workDirectoryстроковый

Рабочая директория, в которой будет выполняться обработка справочников и файлов продаж – их конвертация, загрузка и выгрузка

Значением по умолчанию является директория /linuxcash/cash/data/tmp/exchangers
logDirectoryстроковый

Директория ведения журнала событий Exchanger

Значением по умолчанию является директория /linuxcash/logs/current
errorsFilePathстроковый

Путь до файла-флага с количеством ошибок сервиса

Значение по умолчанию не задано

Если значение параметра задано, то при наличии ошибок сервиса в указанной директории автоматически будет создан файл-флаг, который будет представлять собой json-объект вида:

{"errorsCount": <количество_ошибок>}

Если возникают новые ошибки в сервисе, то значение параметра errorsCount увеличивается на их количество.

Пример настроек
[main]
; Рабочая директория
workDirectory = /linuxcash/cash/data/tmp/exchangers
; Директория для лога
logDirectory = /linuxcash/logs/current
; Путь до файла с количеством ошибок сервиса
; По умолчанию ""
errorsFilePath = linuxcash/cash/error/file.file

Настройка сервиса Exchanger для различных форматов описана в главе "Обмен АСТУ – Касса".

Логирование

Все процессы обмена, выполняемые между товароучетной системой и кассой, регистрируются в соответствующих журналах. Файлы логов за текущую смену хранятся в директории /linuxcash/logs/current/. При закрытии смены архивируются и переносятся в директорию /linuxcash/logs/archive/logs.

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

НаименованиеОписание
dictLoadmain.logЛог запуска процесса загрузки справочников
dictLoad<номер_кассы>.logЛог событий загрузки справочников на кассу
saleUnloadmain.logЛог запуска процесса выгрузки продаж
saleUnload<номер_кассы>.logЛог событий выгрузки продаж из кассы

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

Настройка логов на кассе осуществляется в файле /linuxcash/cash/exchangesystems/exchangers/config/cash/logging.properties.

В настройках можно изменить уровень логирования на любой из следующих:

  • INFO,
  • DEBUG,

  • WARNING,

  • ERROR,

  • CRITICAL.

Самым детализированным уровнем логирования является DEBUG (вес лог-файла выше, чем у остальных).

Не рекомендуется вносить изменения в остальные настройки.

Если файл настройки логов (logging.properties) отсутствует, то в директории /tmp/ будет создан файл логирования exchangers.log.

  • No labels