Введение

Экран гостя, или  Guest Screen — это новая версия второго экрана. Здесь и далее —  GS.

Горячие клавиши:

  • F11 — включение/выключение отображения во весь экран
  • F5 — обновить 
  • Ctrl+F5  — обновить без кэша

Системные требования

Минимальные системные требования ниже:

  • Операционная система —  Windows 10. Работа на младших операционных системах не гарантируется
  • Процессор — 1 ГГц x64. Поддержка x86/x32 не проверялась.
  • Оперативная память — 4 Гб
  • Место на жёстком диске — 100 Гб
  • Net Framework 4. Скачать:  http://microsoft.com/ru-ru/download/details.aspx?id=3556
    • В  Windows XP  или при установленном Net Framework 4 необходим пакет обновлений KB2468871

    • В  Windows 7 embedded  необходим пакет обновлений  KB2533623

  • Библиотеки  Visual C++ redistributable 2013. Скачать: https://www.microsoft.com/ru-RU/download/details.aspx?id=40784.
    Если выдает ошибку "Пожалуйста, установите пакет VC redist 2033", установите  x86 версию
  • На сервере должны быть открыты порты:

Установка

Скачайте с FTP-сервера установочный файл по адресу ftp://ftp.ucs.ru/rk7/other/Guest_Screen/.


Примите пользовательское соглашение, выберите язык и  путь установки


Укажите  порт, на котором будет работать GS. Нажмите  Далее  и  Установить.

Начиная с версии Guest Screen 1.0.0.68 в установщике реализован выбор предустановленных тем.

Для выбора доступны темы:

  • Bakary — пекарня
  • Сafe — кофейня
  • Pizza — пиццерия.

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

Данные темы доступны с разрешениями экранов:

Для альбомной ориентации, пикселейДля портретной ориентации, пикселей
800*600600*800
1024*600600*1024
1024*768768*1024
1024*12801280*1024
1366*768768*1366
1440*900900*1440
1600*900900*1600
1920*10801080*1920

1280*800

800*1280

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

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

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

Получение лицензий

Экран гостя требует лицензирования. 

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

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

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

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

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

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

Первым делом, GS необходимо активировать. Для активации лицензии, на объекте должна быть мастер-лицензия. Если её нет, получите.
При отсутствии мастер-лицензии, появится ошибка:

Выберите объект, на котором собираетесь активировать лицензию. 

После выбора объекта, нажмите кнопку  Получить новую  и выберите мастер-лицензию. Нажмите кнопку  Сгенерировать.

Если необходимо удалить лицензию, GS необходимо тоже запустить от администратора.
Если необходимо привязать существующую лицензию, выберите пункт  Привязать существующую лицензию и выберите в списке доступную мастер-лицензию.

Нажмите Привязать лицензию.

Изменение настроек лицензии

В настройках можно изменить лицензии. Для этого перейдите в  Настройки > Лицензия и авторизуйтесь под дилером.

Здесь можно выбрать другую лицензию или сгенерировать новую.

Настройка связи с r keeper 7

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

Для интеграции RK7 и GS требуется драйвер HTTP Order Notify  версии 18+. Так как в актуально сборке его ещё нет, необходимо обновить его руками. Для этого:

  1. Остановите сервер справочников и кассовый сервер;
  2. Скачайте файл httpnotf.udb из прикреплённых файлов или с FTP: ftp://ftp.ucs.ru/rk7/other/KDS_PRO/Extra_Files/
  3. Скопируйте файл httpnotf.udb  в [папка установки RK7]\base\workmods  с заменой
  4. Запустите серверы r_keeper_7

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

Откройте менеджерскую станцию и перейдите в раздел Сервис > Кассовые станции и устройства.

Включите использование  HTTP порта на кассовом сервере. Укажите свободный порт в поле HTTP Data Port и не ставьте галочку  Use Free Listen Port.

Далее необходимо настроить драйвер HTTP order notify

Для r_keeper 7.6.5 и старше

Начиная с версии 7.6.5.371 настройки Http Order Notify переместились из Устройств в свойства кассового сервера. Порядок действий для этих версий такой:

  1. В параметре драйвера DestURLs пропишите строку подключения в виде:
    http://адрес_сервера_GS:порт_сервера_GS/api/httpNotify/postOrders
  2. Сохраните изменения
  3. Перезапустите кассовый сервер.

    Если требуется указать несколько строчек подключения, их можно указать через точку запятой ";".
    Например: http://127.0.0.1:2121/api/httpNotify/postOrders;https://127.0.0.1:1234/orderTaker

Для r_keeper младше 7.6.5

Если же у вас версия r_keeper меньше 7.6.5, то интерфейс HTTP Order Notify необходимо на кассовый сервер добавить самостоятельно. Инструкция ниже

  1. Для работы KDS PRO требуется драйвер не ниже 18 версии. Поэтому, если ваша версия ниже — перед добавлением интерфейса на кассовый сервер, скачайте драйвер с FTP: ftp://ftp.ucs.ru/rk7/other/KDS_PRO/Extra_Files/httpnotf.udb
  2. Скопируйте файл httpnotf.udb с заменой в папку сервера справочников
  3. Перезапустите кассовый сервер
  4. Добавьте на кассовый сервер драйвер HTTP Order Notify:

  5. Настройте драйвер для всех кассовых серверов по необходимости.
  6. В параметре драйвера DestURLs пропишите строку подключения в виде:
    http://адрес_сервера_GS:порт_сервера_GS/api/httpNotify/postOrders

  7. Перейдите в Сервис > Интерфейсы и создайте новый интерфейс
  8. В разделе Файлы библиотек (DLL) выберите нужный ресторан и укажите драйвер кассовому серверу HTTP Order Notify
  9. Активируйте интерфейс и сохраните.

Перейдите в меню Персонал > Работники и создайте пользователя в роли HTTP Access, не используя в названии русские буквы. Убедитесь, что у роли есть все права. 
Сохраните настройки и перезапустите кассовый сервер.

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

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

После 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. По желанию, укажите уровень логирования и частоту синхронизацию с r_keeper_7
  8. Нажмите кнопку  Сохранить  
  9. Настройка подключения завершена.

Обновление

Обновление Guest Screen происходит через установщик.
Если у вас была установлена версия 0.0.0.х, то обязательно удалите файл базы данных gs.db. Он находится в корневой папке установки с GuestScreen.exe

Запустите установщик, система обнаружит старую версию и предложит её обновить:

Импорт шаблонов

После обновления необходимо загрузить новый стандартный шаблон. Скачайте файл шаблонов с FTP-сервера по ссылке ftp://ftp.ucs.ru/rk7/other/Guest_Screen/. Файл шаблона имеет расширение  .exp,  например GS-UCS-0.0.1.33.exp.
Откройте GS и перейдите в настройки, вкладка  Общие

Выберите файл шаблона в поле  Загрузить шаблон и настройки. Отметьте обе галочки и нажмите  Импортировать:

Стандартные шаблоны загрузятся в GS.

Показ контента

Настройки экранов

В настройках выберите раздел  Экраны

Здесь можно выбрать монитор для показа контента и разрешение.

Стандартные настройки

В GS есть несколько понятий, описывающих показ контента на экране:

  • Режимы  — это режим работы кассы;
  • Сценарии  — последовательность условий, в соответствии с которыми будут показаны  сцены;
  • Сцены  — оформление контента, который будет показываться по сценариям.

В GS по умолчанию есть готовые режимы:

  • Режим ожидания (до регистрации кассира)
  • Заказ. Создание нового
  • Работа экрана с не запущенной кассой
  • Заказ. Блюда не выбраны
  • Заказ. Режим добавления блюд
  • Заказ. Расчет и статус оплаты
  • Заказ. Печать чека

И сценарии:

  • Mode1 –  Режим ожидания. Применяется к кассе на которой нет авторизации пользователя.
  • Mode11 –  Заказ. Создание нового. Выводит на экран изображение при свободной кассе, готовой принимать заказ;
  • Mode18 –  Работа экрана с незапущенной кассой. Выводит изображение на экран при потери связи с кассой;
  • Mode2 –  Сервисный режим (кассир зарегистрирован). Активируется при авторизации пользователя на кассе;
  • Mode32 –  Заказ. Режим добавления блюд. Выводит на экран изображения блюд при добавлении их на кассе;
  • Mode4 – сценарий оплаты. Выводит чек заказа с итоговой суммой оплаты;

Сцены

Сцены — это контент, который показывается по условиям сценариев. Соответственно, перед созданием сценариев, следует создать сцены. 

  1. Для создания сцены, перейдите в раздел  Сцены
  2. Нажмите кнопку  Добавить
  3. Введите название сцены и выберите её тип. Есть возможность добавлять  видео. Видео должно лежать по адресу  \Front\media\video.  Размер видео зависит от мощности компьютера. Если видео тормозит при воспроизведении, значит размер видео слишком большой для данного компьютера. 
  4. Загрузите выбранный контент. Для примера выберем тип сцены —  Изображение. Загрузите файл по кнопке Выбрать изображение
  5. Нажмите  Обзор  и выберите файл на компьютере. Файл загрузится в GS. Нажмите на нужное изображение мышкой.
  6. Настройте параметры отображения: растяжку, выравнивание, размер
  7. Нажмите  для создания сцены.
  8. Сцена готова, можно переходить к созданию сценария.
     

Сценарии

Проверьте, что у вас появились все сценарии по умолчанию. После установки их должно быть 6 штук. Если сценариев нет или они установились частично, необходимо  импортировать стандартные шаблоны.
Рассмотрим сценарий  Order mode32, т.е. режим добавления блюд. Перейдите в раздел  Сценарии  и нажмите на карандаш у нужного сценария:

Вы попадёте в окно редактирования сценария. Здесь можно создавать и удалять условия показа контента.  Условия проверяются последовательно сверху вниз и первое подходящее будет выполнено.

Создайте новое условие по кнопке

  1. Укажите  название  сценария;
  2. Выберите нужные сцены в блоках;
  3. Настройте условия показа сцены. Вы можете создавать условия на основе:
    • Наличия в заказе блюда из искомых категорий
    • Отсутствия в заказе блюда из искомых категорий
    • Последнего блюда из категорий
    • Наличие в заказе блюда с кодами
    • Отсутствия в заказе блюда с кодами
    • Последнее блюдо с кодами

      Важно!

      Ранние версии GS запрашивают данные у RK7 в момент запуска. Поэтому, если подключение к кассовому серверу есть, а данные блюд не показываются, перезапустите GS.
  4. Укажите коды ресторанов, к которым применять созданный сценарий;
  5. Укажите бизнес-периоды, во время которых будет выполняться данный сценарий;
  6. Выберите модель показа:
    • Показывать после оплаты
    • Показывать до оплаты
    • Показывать всегда
  7. Нажмите кнопку

Создадим пример сценария. 

В этой схеме первым проверится условие  Салаты. Если в заказе салат отсутствует, то начнет выполняться следующее условие —  Супы. Если в заказе есть блюдо с супом, то это условие выведет на экран изображение с определенными настройками. Если в заказе отсутствует блюдо с супом, то отработается следующее условие, расположенное ниже по списку.
Если в заказе присутствует суп и салат, то на экран выведется условие  Салаты, т.к. это условие расположено выше условия  Супы и имеет приоритет отображения. При необходимости условия можно менять местами, нажав на стрелку вверх или вниз .

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

Рассмотрим первое условие Салаты. Зайдите в режим редактирования условия  Салаты  — нажмите знак карандаша
Выберите нужные блюда в поле Наличие в заказе блюда с кодами. Измените остальные настройки по усмотрению. Сохраните настройки .

Сделаем настройки для условия  Супы:

Теперь, если пробить на кассе заказ с салатом, экране появится заказ с нашими настройками сцен.

Если в заказе пробить супы, мы увидим следующий экран с заказом:

Настройки условий с супами применяются в первую очередь, так как в заказ суп "борщ" был добавлен раньше, чем салат и у него приоритет отображения.