Сокращения

  1. Система KDS PRO — система
  2. Режим быстрых чеков — режим fastfood 
  3. Режим ресторан полного сервиса — обычный режим
  4. Кассовый сервер — кассовый сервер r_keeper_7. Подробнее в статье о кассовом сервере
  5. Сервер, клиент — если не указано иное, подразумевается сервер и клиент KDS PRO
  6. Личный кабинет — сайт kds.ucs.ru

Введение

Система KDS PRO предназначена для взаимодействия сотрудников кухни и зала ресторана с процессом приготовления блюд и выдачи их. KDS PRO дополняет r_keeper_7 и не работает без него.
В статье описана установка и настройка KDS PRO версии 1.3 и выше. Если вам нужна более старая версия, обратитесь к приложенному к статье файлу. 

Принципиальная схема работы системы представлена ниже:

Система состоит из нескольких приложений:

  1. Сервер
  2. Клиент
  3. Личный кабинет

Настройки KDS PRO хранится в личном кабинете, поэтому системе для работы требуется подключение к интернету. На компьютерах настройки хранятся в зашифрованном виде.

Поддерживается 2 режима работы: ресторан полного сервиса и fastfood. Режим по умолчанию — ресторан полного сервиса.
Характеристики работы в режиме fastfood:

  1. Товары при заказах моментально отображаются на клиентах KDS PRO 
  2. При появлении изменений на кассе, кассовый сервер отсылает данные о них в дополнительный интерфейс. Заказанные позиции появляются в списке сразу. 
  3. Сервер KDS PRO знает об оплате заказа.
  4. Мобильный официант и киоск самообслуживания отсылают заказы через этот же интерфейс кассового сервера.

В обычном режиме KDS PRO опрашивает кассовые серверы на наличие заказов.

  1. Отображаются только сохранённые заказы, о факте оплаты сервер KDS PRO не знает.
  2. Заказы с киоска или мобильного официанта получаются таким же образом.

Система KDS PRO требует лицензирования. Для активации лицензии достаточно получить мастер-лицензию, которая проверяется онлайн. Мастер-лицензии можно активировать и распределить между серверами KDS в личном кабинете.

Обратите внимание, что при первом запуске сервера KDS PRO появляется надпись KDS Server NOT ACTIVATED— это нормально, просто продолжайте установку по инструкции. 

Установка сервера

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

  • Операционная система:
    • Windows 7 x32/x64 и выше;
    • Android 5.0 и выше;
  • Процессор: x32/x64 с частотой 1 ГГц и выше;
  • Оперативная память:
    • 1 ГБ для x32;
    • 2 ГБ x64;
  • Место на жестком диске: 512 Мб для обоих версий.
  • r_keeper не ниже 7.6.2.123
  • Java 1.8.0.192 и выше

У сервера нет установщика. Для установки скачайте и распакуйте архив KdsProServer.7z с FTP-сервера ftp://ftp.ucs.ru/rk7/other/KDS_PRO/ В пути к файлам сервера не должно быть пробелов, заменяйте их на "_" или "-".

В корневой папке найдите файл настроек kds_pro.config. Это текстовый файл, откройте его блокнотом и укажите свободный порт, как написано ниже. По нему клиенты системы будут подключаться к серверу:

webServerPort=1234

Примечание. Если версия сервера ниже 1.6, файл kds_pro.config находится в папке \bin\. Если его там нет — создайте. 

Сервер работает только через HTTPS. Для запуска нескольких серверов, необходимо указывать разные порты.
Если есть у вас есть фаерволл, добавьте в исключения исполняемый файл java.exe, который находится в папке установки java: \java\bin\.

Для простого запуска сервера запустите файл \KDSPRO\bin\runConsole.bat. Чтобы установить сервер как службу, есть группа bat-файлов, которые находятся в папке \KDSPRO\bin\. Их функционал описан ниже:

  • installService.bat — установить сервер как службу. Запускать от администратора. После установки службу необходимо запустить.
    Иногда, после установки службы, её нельзя запустить через оснастку Службы. В этом случае перезагрузите компьютер.
  • queryService.bat — возвращает состояние службы
  • runConsole.bat — запуск сервера как приложения
  • startService.bat — запустить службу сервера
  • stopService.bat — остановить службу сервера
  • uninstallService.bat — удалить службу сервера. Запускать от администратора

Важно: KDS PRO подключается к кассовому серверу. Поэтому запускайте его только при запущенном кассовом сервере.

Если вы остановили сервер, но новый пишет, что порт занят — откройте диспетчер задач и закройте сервер через него.

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

Первым делом необходимо создать пользователя, который будет связывать KDS PRO и r_keeper_7.

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

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

После создания пользователя необходимо настроить доступ к кассовому серверу по HTTP.

  1. Перейдите в меню Сервис > Станции и устройства
  2. В свойствах кассового сервера укажите свободный порт в поле HTTP Data Port. Этот порт позже нужно будет прописать в личном кабинете.
  3. В разделе HTTP Ограничения в каждом пункте выберите HTTP Access
  4. По желанию можно указать папку для сохранения лога запросов и ответов в поле HTTP log path
  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 пропишите строку подключения в виде:
https://имя_пользователя:пароль_пользователя@адрес_сервера:порт_сервера/orderTaker
  1. Имя пользователя и пароль указывать не обязательно. Вписывайте их только, если они есть в личном кабинете. Эти данные есть в личном кабинете, их описание ниже. Порт сервера находится в файле настроек kds_pro.config.
  2. Перейдите в Сервис > Интерфейсы и создайте новый интерфейс
  3. В разделе Файлы библиотек (DLL) выберите нужный ресторан и укажите драйвер кассовому серверу HTTP Order Notify
  4. Активируйте интерфейс и сохраните.

Настройка классификации

Настройте классификацию и категории товаров для KDS PRO.

  1. Перейдите в справочник Настройки > Параметры > Установочные > Связь с другими системами > KDS и VDU > Классификация для КДС и VDU
  2. В поле Ссылка выберите классификацию для КДС, например Сервис-печать
  3. В классификации обязательно должна быть хотя бы одна категория с блюдами. Только блюда в этой категории появятся в KDS PRO
  4. Сохраните и закройте классификации.

Личный кабинет

Личный кабинет предназначен для настройки системы KDS PRO. Для полноценной работы в личном кабинете требуется наличие действующей мастер-лицензии KDS PRO. Если мастер-лицензии нет, или она просрочилась, личный кабинет будет работать в режиме ограниченного функционала.
Описание элементов интерфейса на скриншоте ниже:

При первом входе в личный кабинет, доступна авторизация только по Dealer ID. В дальнейшем можно создать пользователей с ограниченными правами и авторизовываться под ними. После настройки системы создайте учётную запись администратора для владельца объекта.
Для работы в личном кабинете у дилерской учётной записи должны быть созданы корпорация и объект.

Связь с кассовым сервером

Теперь необходимо подключить к личному кабинету кассовый сервер и сервер KDS PRO. Начнём с кассового сервера.
После авторизации в личном кабинете система предложит выбрать корпорацию и объект:

Выберите объект, нажмите кнопку Новый сервер:

Введите название сервера и выберите объект. Нажмите кнопку Создать.

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

Теперь нужно настроить подключение к кассовым серверам. Внизу страницы есть секция Кассовые серверы. Нажмите кнопку Добавить. В списке появятся поля для заполнения:


Введите:

  • Адрес кассового сервера. В нашем случае это 127.0.0.1. Указывайте локальный, а не внешний IP-адрес.
  • Порт кассового сервера. Этот порт задаётся в поле HTTP Data Port кассового сервера. В нашем случае это 8086.
  • Логин пользователя r_keeper_7, которого вы создали ранее. У него должен быть доступ к HTTP-интерфейсу.
  • Пароль этого пользователя.

Нажмите кнопку Сохранить. Кассовый сервер настроен.

Связь с сервером получения заказов

Зайдите в личный кабинет > настройки сервера > интерфейс получения заказов и заполните поля:

  1. Пользователь и пароль — необязательно. Можно указать для дополнительной защиты.
  2. Нажмите кнопку Сохранить в личном кабинете.
  3. Вставьте строчку подключения в поле DestURLs драйвера HTTP Order Notify кассового сервера. Если используется нестандартный порт, замените 1234 на свой порт.
  4. Интерфейс получения заказов настроен.

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

Чтобы активировать продукт, у вас должна быть мастер-лицензия из списка ниже. 

Мастер-лицензия KDS PRO бывает 2 видов:

  • Бессрочная — R-Keeper модуль KDS PRO ПО
  • По подписке — R-Keeper модуль KDS PRO 12 мес ПО

На 1 KDS-клиент необходимо получить 1 мастер-лицензию. Лицензия проверяется автоматически, не реже, чем раз в 10 дней.

По умолчанию, новый сервер создаётся без лицензии и её нужно активировать. Для этого нажмите значок  и выберите пункт Получить лицензию:

Вас перенаправит на страницу получения лицензии.

Есть 2 варианта активации лицензии:

  • Активация новой лицензии
  • Привязка старой лицензии

Активация новой лицензии

  1. Выберите тип лицензии. Тип зависит от версии сервера
    1. Версия до 1.6.0
    2. Версии после 1.6.0
  2. Выберите подходящую мастер-лицензию в списке
  3. Укажите количество пользователей
  4. Нажмите кнопку Сгенерировать
  5. Сервер проверит лицензию и активирует её, если всё в порядке. Появится сообщение об успешном получении лицензии:
  6. Сервер станет зелёного цвета и у него появится информация о лицензии.
  7. Готово. Лицензия активирована.

Привязка существующей лицензии

Если лицензии была активирована ранее, вам достаточно привязать ее в личном кабинете. 

Перейдите в меню Получить лицензию > Привязать

Выберите лицензию из списка и активируйте ее.

Удаление сервера

Чтобы удалить сервер из личного кабинета, нажмите кнопку  и выберите пункт Удалить:

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

Настройка клиента

После создания сервера в личном кабинете, необходимо создать клиентов. Их может быть несколько, но не больше числа мастер-лицензий на сервере лицензирования.
Чтобы создать клиента, нажмите на нужный сервер. Попав в раздел Клиенты сервера, нажмите кнопку Новый клиент:
 

Введите название клиента, название профиля и выберите шаблон профиля. Шаблон профиля — это набор предустановленных настроек, примерно соответствующих названию профиля.

В названиях клиента и профиля можно использовать русский язык и пробелы. Регистр не важен. Для авторизации в клиенте используется Название клиента, оно указано над картинкой экрана в личном кабинете:

Настройка экрана клиента

Нажмите на профиль, чтобы попасть в его настройки. Здесь можно:

  • Настроить жизненный цикл заказа
  • Настроить действия, возможные на этом клиенте
  • Настроить фильтр заказов
  • Настроить параметры, отображения заказа
  • Настроить внешний вид, звуки и таймеры
  • Сохранить настройки профиля для будущего использования
    1. Для этого нажмите кнопку экспорт в верхней части меню
    2. Введите название шаблона и нажмите кнопку Экспорт
    3. Теперь, при создании клиента можно выбрать созданный шаблон. Удаление шаблона пока не реализовано.

Пользователи

Это информационный раздел. Новых пользователей создавать необязательно. 

В личном кабинете существует 3 вида пользователей:

  • Дилеры — имеют все права
  • Администраторы — могут управлять пользователями и просматривать объекты
  • Пользователи — могут просматривать объекты

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

Нажмите кнопку новый пользователь. Заполните учётные данные и выберите роль. Указывайте актуальную почту, т.к. на неё придет письмо с паролем.

Нажмите кнопку Создать.

Назначьте пользователю объекты, к которым он должен иметь доступ с помощью кнопки редактирования пользователя 
Нажмите кнопку Добавить объект и выберите нужные объекты:

Объект появится в профиле пользователя. 

Доступ к объекту можно удалить, нажав на значок  корзины.

Установка клиента

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

  • Операционная система:
    • Windows XP
    • Windows 7 и выше x32/x64;
    • Android 5.0 и выше;
  • Процессор: x32/x64 с частотой 1 ГГц и выше;
  • Оперативная память:
    • 1 ГБ для x32;
    • 2 ГБ x64;
  • Место на жестком диске: 512 Мб для обоих версий.

Для работы клиента тоже требуется установленная Java 1.8.0.192 и выше. Скачайте клиент с FTP-сервера: ftp://ftp.ucs.ru/rk7/other/KDS_PRO и распакуйте архив на жесткий диск. 

  • Клиент для Windows XP это файл KDSProClient_WinXP_setup-1.0.0.1
  • Клиент для Windows 7 и выше — это файл KdsProClient_Win7+.7z

Отредактируйте файл browser.cfg блокнотом. Обязательно укажите строчку с host и port, остальные настройки можно оставить по умолчанию.

host=127.0.0.1 ; адрес сервера KDS PRO. Адрес должен быть доступен по сети.
port=1234      ; порт сервера KDS PRO. Порт должен совпадать с настройкой сервера в kds_pro.config
top=0          ; координаты верхнего угла
left=0         ; координаты левого угла
width=1600     ; ширина окна
height=900     ; высота окна
zoom=0.7       ; масштаб

Запуск клиента

Для запуска клиента:

  1. Запустите сервер справочников и кассовый сервер
  2. Запустите сервер KDS PRO
  3. Запустите клиент KDS PRO. Он находится в папке KDSPRO\Client и называется run.bat

Во время первого запуска, клиент KDS PRO попросит ввести код активации. Для активации клиента:

  1. В личном кабинете выберите сервер KDS PRO
  2. Нажмите кнопку Получить код активации в правом верхнем углу
  3. На экране появится код активации. Скопируйте его.
    Срок действия кода 30 минут. Если время истекло, необходимо получить новый код.  Код активации нужно вводить для каждого клиента KDS PRO. При активации первого клиента будет активирован и сервер KDS PRO.
  4. Пропишите в клиенте KDS PRO полученный код и нажмите Ввод. Клиент активируется.
  5. После успешной активации, надпись Введите код авторизации сервера изменится на Введите название клиента. Введите название клиента из личного кабинета. Каждый клиент необходимо активировать 1 раз.
  6. Нажмите Вход и попадёте в рабочую форму. Создайте заказ на кассе и сохраните. Он должен появится в клиенте:
  7. Авторизация прошла успешно.

Интерфейс

В левом верхнем углу клиента есть 3 индикатора, обозначающие различные статусы.

Описание индикаторов слева направо:

  1. Статус лицензии
  2. Статус соединения с кассовым сервером
  3. Статус получения данных от кассового сервера
Возможные цвета:
  • Красный — неактивен
  • Жёлтый цвет лицензии — до даты окончания лицензии осталось менее 10 дней.
  • Зеленый — активен

Буква в заказе KDS — это код кассовой станции + номер буквы в алфавите соответствующий этому коду. Например, если код станции с которой делается заказ 1, значит номер будет высвечиваться А-01.
Со станции с кодом 3 - номер будет C-02 и так далее.

Решение проблем

Включение логирования клиента

Запустите клиент KDS PRO с параметром -DebugLog. В папке с клиентом должен появиться файл debug.log, который можно открыть как текстовый файл. В нем находится лог клиента.

Проблемы с обновлением

Если возникают ошибки после обновления KDS PRO, то необходимо:

  1. Остановить сервер KDS PRO
  2. Удалить файл kitchenbase.kdb
  3. Запустить сервер KDS PRO
  4. Авторизоваться в личном кабинете KDS PRO
  5. Авторизоваться в клиенте KDS PRO

Ошибки могут быть самые разные. Главное, что они возникают после обновления. Пример ошибки в логе:

Null pointer (Out of memory)

Важно: KDS PRO работает только с r_keeper не ниже 7.6.2.123.

ВложениеРазмер
httpnotf.zip1.35 МБ
ustanovka_i_nastroyka_kds_pro_do_versii_1.3.pdf1.68 МБ