Установка и подключение приложения

В статье описана установка r_k Guest Screen.Здесь и далее также могут использоваться названия: r_k GS, экран гостя.

Установка и настройка состоит из нескольких этапов:

1. Установка Guest Screen
2. Лицензирование
3. Настройка в менеджерской станции
4. Настройка в Guest Screen.

С версии 3.1.0-dev.13 доступен запуск GS с использованием протокола https. Все новые установки будут по умолчанию на нём.
При обновлении старых версий сохранится протокол http. Поменять настройки можно в файле appsettings.json, в директории с установленным GS, секция urls:

Протокол https не доступен на Windows 7, там остается вариант работы на http.

Установка Guest Screen

Для установки:

1. Скачайте с FTP-сервера установочный файл по адресу https://files-rkcloud.ucs.ru/d/65231391cff842d49a1a/?p=/rk7/other/Guest_Screen&mode=list
2. Установите GuestScreen, следуя подсказкам установщика
3. Выберите путь установки. Обратите внимание, если вы установите GS в Program Files, то программу необходимо будет всегда запускать от имени администратора

4. Укажите порт, на котором будет работать GS. Можно оставить предложенный
   

5. Начиная с версии Guest Screen 1.0.0.68, в установщике реализован выбор предустановленных тем. Для выбора доступны темы:
   • Bakary — пекарня
     
   • Сafe — кофейня
     
   • Pizza — пиццерия.
     

6. При установке выберите предустановленную тему и разрешение экрана. Нажмите кнопку Далее
   
   Данные темы доступны с разрешениями экранов:

   Для альбомной ориентации, пикселей	Для портретной ориентации, пикселей
   800*600	600*800
   1024*600	600*1024
   1024*768	768*1024
   1024*1280	1280*1024
   1366*768	768*1366
   1440*900	900*1440
   1600*900	900*1600
   1920*1080	1080*1920
   1280*800	800*1280

7. Завершите установку.

После установки на рабочем столе появится ярлык клиента r_k GS. Первый запуск r_k GS всегда необходимо производить от имени администратора.

После установки перейдите в Настройки > Режимы и проверьте наличие шаблона режимов и сценариев. В списке должны быть 8 стандартных режимов. Если их нет, сделайте импорт шаблонов.

Лицензирование

r_k Guest Screen необходимо пролицензировать. 

Для работы требуется 2 вида лицензий:

• Лицензия по подписке на Guest Screen — R-Keeper модуль Guest Screen 12 мес ПО. Она проверяется онлайн
• Для r_keeper 7.6.5 и старше дополнительно требуется лицензия на интерфейс HttpOrderNotify. Она называется R-Keeper модуль Интерфейс уведомлений о заказах ПО. Лицензия добавляется автоматически при покупке лицензии r_k GuestScreen. Срок действия лицензии для HttpOrderNotify равен сроку действия лицензии r_k GuestScreen.
  

Количество лицензий R-Keeper модуль Интерфейс уведомлений о заказах ПО должно быть равно количеству дополнительных подключений к HttpOrderNotify.

Подробную информацию читайте в статье Лицензирование.

Настройки в менеджерской станции

Обновление драйвера

Для интеграции r_keeper и r_k Guest Screen требуется драйвер HTTP Order Notify версии 18 или старше. Если версия драйвера неактуальна, выполните следующие действия:

1. Остановите сервер справочников и кассовый сервер
2. Скачайте файл httpnotf.udb. Его можно взять из архивной версии rk7 по пути \base\workmods или по ссылке
3. Скопируйте файл httpnotf.udb в [папка установки RK7]\base\workmods с заменой
4. Запустите серверы r_keeper.

Настройка в менеджерской станции

1. Откройте менеджерскую станцию r_keeper
2. Перейдите в раздел Сервис > Кассовые станции и устройства
3. Выберите ресторан и кассовый сервер, который будет передавать данные r_k GS
4. В Свойствах:
   • Включите использование HTTP порта на кассовом сервере
     
   • Укажите свободный порт в поле HTTP Data Port и не ставьте флаг Use Free Listen Port
     
5. Далее необходимо настроить драйвер HTTP order notify. 

Далее необходимо создать пользователя, который будет связывать r_k GS и r_keeper. Для этого:

1. Перейдите в Персонал > Работники
2. Выберите ресторан, в котором будет использоваться r_k GS 
3. Создайте роль и назовите ее HTTP Access
4. Перейдите в Свойства роли
5. Раскройте раздел Менеджерские ограничения > Привилегия на объекты и поставьте флаг в поле HTTP Access/HTTP Драйвер
   
6. Создайте работника в роли HTTP Access. Имя работника должно быть написано латинскими буквами без пробелов, например, http.
   
7. В поле Учетная запись укажите пароль работника и сохраните изменения.

Настройки в r_k завершены. Перезапустите кассовый сервер. 

Параметры запуска

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

• /port 2121 — порт запуска приложения, цифры указываются через пробел, по умолчанию 2121
• /db gs.db — имя базы данных приложения через пробел, по умолчанию gs.db
• /theme C:/ucs_1.0.95.zip — параметр импорта темы при запуске, указывается полный путь до файла темы через пробел
• /exp C:/GS-UCS-0.0.1.33.exp — параметр импорта шаблона настроек при запуске, указывается полный путь до файла exp через пробел
• /screenres 1024.768 — параметр установки размера окна при запуске, через пробел, 2 цифры, разделенных точкой
• /gpu-acceleration — включение ускорения GPU при во встроенном браузере CEF.
  

Настройки в r_k GuestScreen

Для перехода в настройки r_k GS, запустите программу и нажмите 5 раз в правом верхнем углу экрана. При нажатии должен появляться белый круг.

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

Откроется экран с настройками подключения. Укажите данные подключения к кассовому серверу по HTTP-интерфейсу.

1. XML-инт.: адрес — IP-адрес кассового сервера
2. XML-инт.: порт — порт HTTP кассового сервера
3. RK7: логин — название пользователя из группы HTTP-Access
4. RK7: пароль — пароль этого пользователя
   
5. Нажмите кнопку Проверить. Система проверит подключение и покажет сообщение, в зависимости от результата.
   1. ​Если данные введены верно, появится сообщение об установленном соединении
      
   2. Если неверно указать логин и пароль, появится ошибка Unauthorized
      
   3. Ошибка An error occured while sending the request означает, что неверно указаны настройки подключения к кассовому серверу. Проверьте IP и порт подключения.
      
6. После успешного подключения с кассового сервера загрузится код ресторана и кассы. Выберите нужные кассы, с которых должны приходить заказы в поле Код кассы 
   
7. Если кассы не отображаются, нажмите кнопку Обновить
8. В пункте Код типа исключенного заказа, при необходимости укажите категорию заказа, которая не должна отображаться на экране GS.
   
   Если категории заказа не отобразились, нажмите на кнопку Обновить.
9. По желанию, укажите частоту синхронизации с r_keeper и количество минут, после которого будут игнорироваться пакеты XML кассы (например, выключали кассовый сервер надолго, потом включили и кассовый сервер выслал то, что не успел до выключения, это и отобразится в r_k GS)
   
   
10. Нажмите кнопку Сохранить.

Настройка подключения завершена.

Для корректного вступления настроек в силу перезагрузите компьютер.