Установка

Установка на кассовый сервер (Artix Control Center)

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

1. Скачать и запустить скрипт установки:
   

   curl https://update.artix.su/static/cs/install_scripts/stable/cs_env/add_rep.sh -o /tmp/add_rep.sh
   chmod +x /tmp/add_rep.sh
   /tmp/add_rep.sh

2. Установить пакет artixcs-ads:
   

   sudo apt update
   sudo apt install artixcs-ads

Установка на кассе (Artix:SCO и Artix:POS)

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

apt update
apt install artix-ads

Настройки 

На Artix Control Center

Для добавления кассы в Artix Digital Signage кассу необходимо создать в Artix Control Center. Подробнее об этом можно прочитать в разделе "Архитектура торговой сети".

На кассе (Artix:POS)

Для отображения рекламы на втором мониторе необходимо:

1.  Установить пакет artix-view командой:
   

   aptitude install artix-view

2. Активировать модуль viewconnector:


   Наименование	Возможные значения	Описание
   Файл /linuxcash/cash/conf/ncash.ini.d/viewconnector.ini, секция [plugins], настройки приложения artix-view
   viewconnector	on off	Активация модуля viewconnector

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

   [plugins]
   viewconnector = on

3. Настроить параметры отображения информации для покупателя:
   

   Наименование	Возможные значения	Описание
   Файл /linuxcash/cash/conf/ncash.ini.d/viewconnector.ini, секция [View.Style], настройки отображения приложения artix-view
   displayType	0 – только чек, 1 – только реклама, 2 – чек слева, реклама справа, 3 – реклама слева, чек справа, 4 – чек вверху, реклама внизу, 5 – реклама вверху, чек внизу, 6 – в режиме ожидания - только реклама, в режиме формирования - только чек.	Тип отображения информации

   Пример настройки отображения чека слева, рекламы справа

   [View.Style]
   ; Настройки отображения приложения artix-view
   
   ; Тип отображения информации
   ; 0 - только чек
   ; 1 - только реклама
   ; 2 - чек слева, реклама справа
   ; 3 - реклама слева, чек справа
   ; 4 - чек вверху, реклама внизу
   ; 5 - реклама вверху, чек внизу
   ; 6 - в режиме ожидания - только реклама, в режиме формирования - только чек
   ; по умолчанию 0
   displayType = 2

4. Указать путь к потоку на Ads сервисе:
   

   Наименование	Возможные значения	Описание
   Файл /linuxcash/cash/conf/ncash.ini.d/viewconnector.ini, секция [ViewConnector.Ads], настройки модуля сервиса оповещения
   url	по умолчанию http://0.0.0.0:49152/v1/stream/connect	Путь к потоку на ads сервисе

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

   [ViewConnector.Ads]
   ; Путь к потоку на ads сервисе
   ; По умолчанию не указан
   ; Если не указан - не используется
   ;url = http://0.0.0.0:49152/v1/stream/connect

5. Сконфигурировать экраны:
   
    Для монитора, на который будет осуществляться вывод информации для покупателя, необходимо указать приложение /linuxcash/cash/view/artix-view:
   
   Подробнее о настройке экранов можно прочитать в статье "Настройка экрана".

Настройка сервиса

[Main]
; Основные настройки

; Адрес, который будет слушать сервис для соединения сервера
listen = 0.0.0.0:49152

; Период повторной попытки синхронизации после ошибки в секундах
; По умолчанию 60
;syncRepeat = 60

; Заполнитель, отображаемый, при отсутствии иных данных для отображения
; По умолчанию "/opt/artix-ads/placeholder"
;defaultPlaceholder = "/opt/artix-ads/placeholder"

На кассе самообслуживания (Artix:SCO)

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

[Ads]
; Включение модуля, по умолчанию false
;enable = false

; Путь к потоку на ads сервисе
; По умолчанию http://0.0.0.0:49152/v1/stream/connect
;url = http://0.0.0.0:49152/v1/stream/connect

; Время простоя, после которого начинает отображаться реклама
; в секундах, не менее 1 секунды, по умолчанию 60
;showTimeout = 60

; Экран, на котором отображается реклама, по умолчанию primary
; Возможные значения:
; primary - основной экран программы
; second - первый попавшийся не основной экран
; системное название экрана - список можно посмотреть в root.log
;screen = primary

; Автоматический переход в режим формирования после закрытия рекламы, по умолчанию false
;startCheck = false

; Отключить виджет рекламы в продаже для Slim
; Реклама будет отображаться на весь экран
; По умолчанию false
;disableWidget = false

Настройка сервиса

[Main]
; Основные настройки

; Адрес, который будет слушать сервис для соединения сервера
listen = 0.0.0.0:49152
 
; Период повторной попытки синхронизации после ошибки в секундах
; По умолчанию 60
;syncRepeat = 60

; Заполнитель, отображаемый, при отсутствии иных данных для отображения
; По умолчанию "/opt/artix-ads/placeholder"
;defaultPlaceholder = "/opt/artix-ads/placeholder"

В Artix Digital Signage

Настройки Artix Digital Signage задаются на кассовом сервере (Artix Control Center) или на другом сервере с установленным пакетом artixcs-ads.

server.port = 8024
server.servlet.context-path=/ads

spring.datasource.url=jdbc:postgresql://localhost:5432/ads
spring.datasource.username=netroot
spring.datasource.password=netroot
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect

server.servlet.session.cookie.path=/

cs.url=http://127.0.0.1:38051/CSrest/rest/

# upload large files with rest
server.tomcat.max-swallow-size=-1
spring.servlet.multipart.max-file-size=1GB
spring.servlet.multipart.max-request-size=2GB

# accept special character in query string
server.tomcat.relaxed-query-chars=|,{,},[,],^

serviceName=artixcs-ads

После настройки приложение будет доступно по адресу http://<IP-адрес сервиса>:8824.