Встроенный браузер предназначен для расширения возможностей кассового узла. Данное решение позволяет использовать существующие веб-сервисы предприятия для информирования об остатках товара на других торговых точках сети, использовать ресурсы сети Интернет для получения дополнительной информации о товаре.
Конфигурирование
Для вызова браузера необходимо в утилите администрирования Yuki на клавишу назначить действие на основе команды COMMAND_WEB_BROWSER.
В параметрах команды указываются:
| Наименование | Тип данных | Возможные значения | Описание | Примечания |
|---|---|---|---|---|
| url | строковый | Ссылка на стартовую страницу | Обязательный параметр. Например, | |
| showCursor | логический |
| Отображение курсора | По умолчанию true |
| codePage | строковый |
| Кодовая страница. Используется для отображения локальных файлов | По умолчанию "UTF-8" |
| printService | целочисленный | Используется для печати xml-документа из встроенного браузера | Указывается порт сервиса печати | |
| showDigitalKeyboard | логический |
| Использование цифровой клавиатуры в touch-интерфейсе | По умолчанию false |
| lockDelay | логический |
| Отключение блокировки кассы по бездействию в браузере | По умолчанию false |
Настройка прокси-сервера
В случае необходимости для работы браузера можно настроить прокси-сервер. Настройка происходит в основном конфигурационном файле /linuxcash/cash/conf/ncash.ini в секции [Proxy]. За настройку отвечают следующие параметры:
| Наименование | Тип данных | Описание | Примечания |
|---|---|---|---|
hostName | строковый | IP-адрес прокси-сервера | Если параметр |
port | целочисленный | Порт прокси-сервера | По умолчанию |
user | строковый | Логин | Параметры |
password | строковый | Пароль | Параметры |
[Proxy] ; Настройки прокси сервера ; Имя хоста ;hostName = 195.154.233.59 ; Порт. 3128 по-умолчанию. ;port = 3128 ; Логин ;user = user ; Пароль ;password = pass
Использование
При нажатии клавиши вызова браузера выполняется загрузка страницы, указанной в параметрах действия. Если касса оборудована мышью, возможно включить отображение курсора. В противном случае интерфейс веб-сервиса должен предоставлять возможность управления только с клавиатуры без использования манипулятора. Выход из режима браузера выполняется по нажатию клавиши ESC.
Запуск браузера доступен в контекстах:
- формирование товарной части документа,
- оплата чека,
- сдача.
Отображение текстовых файлов
С помощью браузера можно также просматривать текстовые файлы. Для этого необходимо в качестве url необходимо указать схему file и ввести полное имя файла. Если кодировка файла отличается от UTF-8, необходимо явно указать используемую кодовую страницу.
txt.file:///linuxcash/logs/current/readme.txt
Переход в браузер с использованием данных из чека
Для перехода на сайт торговой сети с использованием данных из чека может быть использован встроенный браузер. Для этого в утилите администрирования Yuki необходимо настроить действие на основе команды COMMAND_WEB_BROWSER с параметром url, в котором при помощи макросов определить структуру веб-адреса.
Макросы могут содержать информацию из:
- текущего документа (
document), - карты (
cardRecord), - клиента (
client), - выделенной позиции (
position).
| Макрос | Отображаемая информация |
|---|---|
document.num | Номер чека |
document.cashCode | Номер кассы |
document.shopCode | Номер магазина |
cardRecord.number | Номер карты |
cardRecord.multiplicator | Мультипликатор карты |
client.name | Имя покупателя |
client.phoneNumber | Номер телефона покупателя |
client.sex | Пол покупателя |
position.code | Код выделенной позиции |
position.bcode | Штрих-код выделенной позиции |
Полный список макросов доступен здесь.
Пусть необходимо при добавлении карты открыть сайт торговой сети и зарегистрировать карту.
Сайт компании расположен по адресу https://magazin.ru и для регистрации карты необходимо перейти по адресу https://magazin.ru/card/<номер_карты>.
В значении параметра url необходимо указать:
https://magazin.ru/card/%(cardRecord.number[s])
В случае добавления нескольких карт клиента в чек номер карты подставляется в соответствии с приоритетом:
- Карта лояльности.
- Дисконтная карта.
- Социальная карта.
При наличии нескольких карт одного типа в макрос будут подставлены данные первой добавленной.
Печать xml-документа в браузере
Для печати xml-документа из встроенного браузера необходимо в утилите администрирования Yuki настроить действие на основе команды COMMAND_WEB_BROWSER с параметром printService. В качестве значения параметра указывается порт, на котором будет работать сервис.
Таким образом при запуске браузера в фоновом режиме будет запущен сервис печати. Печать документа будет осуществлена на первом подключенном ФР. После закрытия встроенного браузера сервис печати будет приостановлен.
Для передачи данных используется POST-запрос, например, можно воспользоваться утилитой curl (при необходимости установите curl командой apt-get install curl):
curl -d "@<Путь к отчету>" <ip адрес кассы>:<порт сервиса>
В качестве примера ниже указан запрос на печать отчета xreport.xml:
curl -d "@/linuxcash/cash/reports/xreport.xml" localhost:6060
Возможные ошибки при печати документа
Если в ФР закончилась чековая лента, то на экран будет выведен диалог "Нет чековой ленты. Повторить попытку?":
- при подтверждении операции будет осуществлена попытка повтора печати,
- при отказе от операции диалог будет закрыт, печать осуществляться не будет.
Если связь с ФР потеряна, то на экран будет выведен диалог "Нет связи с ФР. Повторить попытку?":
- при подтверждении операции будет осуществлена попытка соединения с ФР,
- при отказе от операции диалог будет закрыт, печать осуществляться не будет.