Установка

Последнее изменение статьи 03.12.2025 14:24

Экран гостя, или Guest Screen — это новая версия второго экрана. Здесь и далее — 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. Завершите установку.

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

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

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

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

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

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

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

Активируйте лицензию в свойствах ресторана после получения. Перезапустите кассовый сервер после активации лицензирования.

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

Активация мастер-лицензии

Запустите GS. При первом запуске на экране появится окно авторизации.

Авторизуйтесь с логином и паролем от Системы лицензирования

Начиная с версии Guest Screen 1.0.0.83, вход в лицензирование осуществляется только по электронной почте дилера.

После успешного входа появится экран для активации лицензии.

1. Нажмите на кнопку Выбрать
2. С помощью поиска найдите и выберите свой объект
3. Далее нажмите на раздел Получить новую
4. Выберите мастер-лицензию
5. Нажмите кнопку Сгенерировать
   

Готово, система пролицензирована. Если все прошло хорошо, откроется стандартное окно с названием программы. 

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

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

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

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

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

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

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

1. Перейдите в Персонал > Работники
2. Выберите ресторан, в котором будет использоваться 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.

Настройки в Guest Screen

Для перехода в настройки 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 7 и количество минут, после которого будут игнорироваться пакеты XML кассы (например, выключали кассовый сервер надолго, потом включили и кассовый сервер выслал то, что не успел до выключения, это и отобразится в GS)
   
   
10. Нажмите кнопку Сохранить.

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

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