Вводная информация

Програмный комплекс "Мобильный официант" интегрируемый в комплекс R-KEEPER v6 или R-KEEPER v7, позволяет значительно увеличить скорость и производительность работы официанта. Каждый официант будет иметь КПК (IPOD) с установленным на нем приложением RkMobWaiter, при помощи которого, сможет оформлять заказы клиентов не подходя к станции кассира/официанта. Заказ после сохранения и синхронизации с кассовым сервером (NT-RKSERVER) будет отослан на кухню как и в случае работы с обычным POS-терминалом (RKCLIENT). Соотвтетственно, время оформления заказа, а также ожидание клиентом заказа - уменьшается.

Немаловажным функционалом является и возможность приема на IPOD сообщений от различных программных модулей комплекса R-KEEPER. Все сообщения для официантов приходящие и обрабатываемые кассовым сервером напрямую (или специальным сервисом - MSGCmd.exe) будут автоматически переданы на сервер мобильных официантов (TMS), который в свою очередь передаст их на сам КПК (IPOD) официанта. Сообщения могут поступать со следующих модулей:

Monit32.exe - Монитор RK6
Система KDS - Kitchen Display System
Контроль заказов при помощи сканера и клавиатуры повара.
Система вызова официантов через кнопки радиовызова. + Пейджинговая система.

Примечание: Руководство по использованию ПО "Мобильный официант" - ftp://ftp.ucs.ru/books/r-keeper_v6_mobwaiter_iPod_ user_manual.pdf

Связь "мобильных официантов" с основной кассой (кассовым сервером) осуществляется с использованием технологии "Wi-Fi", через обычную точку доступа (access point), т.е. WI-FI-роутер.

Конфигурация на базе электронных блокнотов официантов включает в себя переносные терминалы на базе широко распространенных карманных компьютеров (под управлением ОС Windows CE или IOS).

Имеется реализация данного ПО с использованием мобильных устройств - "Orderman".
Реализация на Windows CE устарела. Ее заменили устройства на платформе IOS - IPOD, IPHONE, IPAD, IPAD mini.
Устройства на платформе Android - пока не поддерживаются.

Для использования ПО "Мобильный официант" в конфигурации предприятия должны присутствовать стандартные компоненты системы R-KEEPER v6 (или R-KEEPER v7). Так как в данной статье речь идет о связке ПО с RK6, то как минимум, уже должна быть установлена и настроена "Менеджерская часть RK6", кассовый сервер (предпочтительна реализация под NT, т.е. NT-RKSERVER) и кассовая часть (RKCLIENT - DOS или Win) .

Примечание: Настройка ПО "Мобильный официант" для совместной работы с R-KEEPER v7 описана здесь Установка TMS и мобильного официанта

Состав программного комплекса

ПО "Мобильный официант" условно можно разделить на две части:

Серверная часть - сервер TMS. Ставится на ПК под ОС Windows, где уже настроен и работает кассовый сервер (RKSERVER). Плюс дополнительное ПО: MSGCmd.exe (Сервис передачи сообщений).
Клиентская часть - представлена приложением RKMobWaiter (IOS) - качается на КПК непосредственно с магазина AppStore. (Модификация для WIN CE хотя давно не используется, выложена на ФТП - ftp://ftp.ucs.ru/r-keeper/WaiterNotepad/Current/WinCE/).

Схема взаимодействия ПО следующая:

КПК (IPOD) с ПО RKMobWaiter (столько устройств сколько необходимо) <---- WI-FI ----> WI-FI-роутер <----- LAN(TCP) -----> ПК с ПО TMS + NT-RKSERVER RK6

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

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

POS-терминал (кассовая станция RK6 с ПО RKCLIENT)
Офисный ПК - для кассового сервера (NT-RKSERVER) и TMS-сервера.
КПК - IPOD, IPHONE, IPAD mini на платформе IOS (Рекоммендуется).
Если КПК на платформе Win CE - Casio Cassiopeia E-125 + D-Link DCF-650W или Compaq iPAQ3600 + Orinoco PC24E, DELL Axim x51v, Acer u321, Glofish x500+, HP iPAQ 214 и др. (устаревшее).
WI-FI-роутер - например, DLINK DIR-320 или zyxel keenetic и др.

Для обеспечения стабильной связи можно использовать несколько «передатчиков», установленных на расстоянии друг от друга или более крупные антенны, подсоединенные вместо штатных. Также, возможно, построение распределенного решения. Например, при использовании на большой территории или при наличии радио-непрозрачных перегородок в зоне прямой видимости к выбору радио-хаба (WI-FI роутера) необходимо отнестись более тщательно. Не все радио-хабы поддерживают все конфигурации в базовой поставке. Возможен случай, когда для радио-хаба необходимо докупать микрокод (например: для lucent Technologies Orinico RG-1x00 для обеспечения bridging-а – режима при котором один участок сети через два радио-хаба становится виден на другом).

Настройки в Менеджерской RK6 (E_Rest32.exe)

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

Запустить приложение DealRK и при помощи него необходимо добавить в список станций, новую станцию (кассовую или официантскую - не важно). Например:

ID - UNIT55 (на скриншотах ниже, за пример взяты UNIT64 и UNIT65)
Тип станции - станция кассира (станция официанта).

Рис. - Редактор - Список станций.

Примечание: под заданным ID TMS-сервер будет подключаться к кассовому серверу. Таким образом, для кассового сервера все заказы с IPOD-ов будут поступать от имени ID присвоенного TMS.

В приложении E_Rest32.exe (Менеджерская RK6) прописать стандартные настройки характерные для официантской станции. Например: Название станции , чековый и отчетный принтеры отсутствуют.

Рис. - параметры станции TMS.

Рис. - Параметры станции TMS - Вкладка принтеры.

В разделе "Списки"\"Персонал" - "Официант", каждому официанту добавить уникальный 3х-4х значный пароль (Вкладка/поле - "Пароль"), необходимый при авторизации на КПК с ПО "Мобильный официант".

Рис. - Свойства персонала.

Сервер виртуальных станций - TMS (Transaction Messages Server)

Для работы системы "Мобильный официант" рекомендуется установить выделенный кассовый сервер под ОС Windows NT.

Рис. - Вид кассового сервера с подключенными к нему станциями TMS и обычной кассой RK6.

Установку TMS-сервера производить на том же ПК (OC Win 32-bit), на котором, уже установлен и работает кассовый сервер RK6 (NT-RKSERVER). К этому же кассовому серверу, в обязательном порядке, должна быть подключена хотя бы одна кассовая станция. На ней будут закрываться/оплачиваться в том числе и заказы оформленные через RkMobWaiter.

TMS, Rkserver и мобильные терминалы должны находиться в одном сегменте ЛВС.

Скопировать с фтп, - ftp://ftp.ucs.ru/r-keeper/WaiterNotepad/Current/TMS/RK6/ всё содержимое каталога и поместить в каталог \RK6\TMS.

Примечание: Процесс лицензирования был изменен - подробная информация

Поместить в Автозагрузку ярлык запуска сервиса - MobilGuard2.exe.

Сервер TMS имеет в своем составе два основных запускных файла MobilGuard2.exe (утилита запуска/перезапуска tms-сервера) и TMS2.exe (собственно сам tms-сервер).

Запускать tms-сервер необходимо именно через утилиту MobilGuard2.exe. Задача утилиты MobilGuard2.exe в том, что раз TMS-сервер выступает (для кассового сервера) в роли стандартной официантской станции RK6, то при "Общем Закрытии Дня" в кассовой системе RK6 необходимо выключать (отключать от кассового сервера) приложение TMS. Иначе, при закрытии дня на "Главной кассе" появится сообщение - "Не все станции завершили работу".

Утилита MobilGuard2 позволяет согласно выполненным настройкам в TMS2.INI (подробнее ниже) в указанное время выключать TMS (и при необходимости перезапустить обратно по указанным настройкам времени) .

С версий TMS 4.36 и выше появились возможность множественного запуска серверов TMS. Т.е. запускать на одном ПК сразу несколько инстанций (экземпляров) TMS-сервера. Дополнительная информация здесь. Также, более подробно описано ниже, в этой же статье.

Следующий шаг, выполнить настройки в конфигурационных файлах TMS-сервера

Конфигурационные файлы TMS-сервера

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

Настройка MBG2.INI

Файл MBG2.INI используется приложением MobilGuard.exe. Отметим только те параметры, которые обычно редактируются (все остальные, оставить по-умолчанию).

Отредактировать MBG2.INI:

[TMSList]                - Раздел, в котором указывается перечень всех запускаемых TMS. 
TMSTitle1=TMS64          - Название TMS, будет использоваться в качестве ЗАГОЛОВКА РАЗДЕЛА настроек в TMS2.INI
TMSTitle2=TMS65          - Аналогично предыдущему параметру.

[TMS]                    - Раздел настроек TMS
TMS2INI=TMS2.ini         - Указание конфигурационного файла, который содержит настройки TMS-серверов.

Важно! Начиная с версии TMS 5.109 и выше и использовании обновленного лицензирования (Lupdater2015.exe + l.ucs.ru) при запуске TMS через MobilGuard в настройках MBG2.INI необходимо, в обязательном порядке, добавить следующие параметры:

[TMS]
KeyPublicNo= - указать ID ключа (так же как и в TMS2.INI).
RestCode=NNNNNNNNN - где NNNNNNNNN - код ресторана (должен совпадать с кодом из RK).

Настройка TMS2.INI

Файл TMS2.INI является основным конфигурационным файлом сервера TMS.

Важно: Передача данных о заказах в систему VDU работает только в TMS для RK7 - для RK6 секция VDU не используется (по этой же причине в дистрибутиве TMS для RK6 отсутствует библиотека VDUSend.dll, необходимая для оправки данных на VDU)

Отметим только стандартные параметры, которые обычно редактируются (все остальные, оставить по-умолчанию).

Отредактировать TMS2.INI:

[LOG]                    - Раздел отвечающий за формирование информации в ЛОГЕ TMS-серверов. По-умолчанию, этот раздел остается без изменений.
...                      - Прочие (пропущенные) параметры.
CardInfo=1               - Лог запросов по карте. 1 - писать, 0 - нет.
PrecheckPrint=1          - Лог печати пречека. 
RTGI=1                   - Лог запросов к системе ПДС.
SendMessage=1            - Лог сообщений.
CardMsg=1                - 
SetDiscount=1            - 
GetOrderXML=1            -
UseDep=1                 - Вывод в лог используемого значения DEP.
Pager=1                  - Лог работы приложения RKPager.
AccessRem=1              - 
LocksLimits=1            -
ImagePages=1             -

[TMS]                    - Основной раздел общих (ГЛОБАЛЬНЫХ) настроек для всех запускаемых из этого каталога экземпляров TMS-серверов.
SortOnPrint=0
RestCode=199999999       - прописывается если используется новое лицензирование (LUpdater2015.exe + l.ucs.ru).
KeyPublicNo=25395D20     - указать ID лицензионного ключа(номер должен быть восьмизначным, если больше, "лишние" символы отбрасываются с начала номера. Если на конце номера буква в нижнем регистре - тоже отбрасывается).
UseLic=10                - указать количество подключений прописанных в ключе (в случае использования нескольких TMS, указывается не здесь а в каждом конкретном разделе настроек экземпляра TMS, см.ниже).
Index=0                  - индексное число номера лицензий, по-умолчанию = 0 (в случае настройки нескольких экземпляров, указывается в каждом конкретном разделе настроек каждой TMS, см.ниже).

Для каждой копии TMS должно быть прописано уникальное значение Index, в котором резервируется для каждого запускаемого экземпляра TMS количество одновременных подключений с разных IP. При первом старте TMS в памяти создаётся объект в 256 байт (Index). Каждая копия TMS по этому индексу проверяет доступность указанного числа лицензий, если все хорошо, то записывает в Index забранное кол-во лицензий.

Параметры UseLic и Index взаимосвязаны между собой.

PrintByDividers=1            - Влияет на отложенную печать.
SortBy=0                     - Сортировать меню по названию (0 - как есть, 1 - по коду, 2 - по имени).
MUT=300                      - Таймаут автоматического обновления меню на КПК.
DEP=04                       - Код группы станций из менеджерской RK6 (в актуальных версиях TMS параметр ОБЯЗАТЕЛЕН к заполнению).
AllTables=0                  - Если задан равным 1, то всем официантам будут доступны столы всех официантов.

Примечание: С версии TMS 5.91 от 26.05.2014 параметр "Dep" можно прописывать и для каждого отдельного экземпляра TMS!

Важно: Параметры раздела [TMS] считаются глобальными, будут использованы при запуске всех экземпляров TMS. Необходимо иметь ввиду, что некоторые из этих параметров могут быть вынесены в разделы настроек отдельных экземпляров TMS. Но не все! Все они указаны ниже, на примере настроек для [TMS64] и [TMS65].

[TMS64]                      - название раздела экземпляра TMS (прописывается так как указано в MBG2.INI)
Port=910                     - порт подключения к экземпляру TMS-сервера (значение дублируется при указании порта в mwnsettings.xml)
RKServer=R69SERV             - NETBIOS-имя кассового сервера (NT-RKSERVER), с которым работает данный экземпляр TMS.
TMSServer=UNIT64             - ID станции от имени которой, TMS будет работать с кассовым сервером (Задано в DealRk - см.выше в настройках Менеджерской RK6).
NBAdapter=0                  - Номер сетевого адаптера для подключения к кассовому серверу (NT-RKSERVER).
KeyPublicNo=                 - ID ключа для данного экземпляра TMS.
UseLic=5                     - количество лицензий забираемых из ключа для данного экземпляра TMS.
Index=1                      - номер индексного дампа зарезервированных экземпляром лицензий.
XMLcfg=mwnsettings64.xml     - указание конфигурационного файла используемого клиентскими приложениями (RkMobWaiter) для данного экземпляра TMS. (Сам файл mwnsettings64.xml переименовывается из стандартного mwnsettings6.xml)
RestCode=199999999           - код ресторана для данного экземпляра TMS (необходим при новом лицензировании LUpdater2015.exe + l.ucs.ru).

[TMS65]                      - аналогично предыдущему разделу - [TMS64], настраиваются и остальные запускаемые экземпляры серверов TMS.
Port=810                            
RKServer=R69SERV
TMSServer=UNIT65
NBAdapter=0
KeyPublicNo=
UseLic=5
Index=2
RestCode=199999999
XMLcfg=mwnsettings65.xml

В случае использования одного единственного экземпляра TMS прописать все необходимые параметры подключения и лицензирования в глобальном разделе [TMS] без настройки дополнительных разделов настроек запуска TMS по экземплярам. В нашем примере, - это [TMS64] и [TMS65].

В TMS2.INI имеются настройки автоматического завершения работы TMS, а также ее перезапуска. Поскольку TMS для кассового сервера (RKSERVER) является обычной официантской станцией, необходимо что бы, в момент Закрытия дня на кассовом сервере станция TMS была выключена. Для этого, можно использовать один из предложенных функционалов: Перезапуск или Выключение.

[Restart]                    - Раздел настроек перезапуска всех экземпляров TMS.
Time=23:00:00                - Указать время выключения TMS.
WaitSeconds=600              - Указать количество секунд до перезапуска.

Если, заведение работает круглосуточно, актуально использовать параметры перезапуска. На нашем примере, в 23.00 TMS отключится от кассового сервера на 10 минут, что бы дать ему возможность выполнить закрытие дня. После чего будет запущена снова. Обычно эти параметры согласуются с руководством и персоналом. И включаются в общую технологию работы с системой R-KEEPER.

[Close]                      - Раздел настроек выключения TMS.
Time=13:25:00                - Указать время выключения.

Эти настройки целесобразно использовать в обычных заведениях, что бы выключать TMS незадолго перед выполнением "Закрытия дня" на кассовом сервере.

Клиентское приложение RkMobWaiter запущенное на КПК берет свои настройки из конфигурационного файла - mwnsettings.xml передаваемого с TMS. Следующий раздел TMS2.INI содержит указание используемого XML-файла с настройками для клиентского приложения RkMobWaiter. Пример:

[CFGXML]                     - Название (глобального) раздела TMS указания конфигурационного файла *.XML для RkMobWaiter.
6=mwnsettings6.xml           - в связке с RK6 указание общего конфигурационного файла *.XML для всех запускаемых экземпляров TMS.

При настройке нескольких экземпляров TMS и указания для каждого экземпляра СВОЕГО конфигурационного *.XML-файла, настройку данного раздела можно игнорировать и указать *.XML-файлы в каждом разделе TMS. На нашем примере, это разделы [TMS64] и [TMS65]. То есть, либо указыватеся в них, либо здесь - и будет влиять на все экземпляры.

UseDig=3                     - указание количества знаков после запятой при отображении количества блюда на КПК (например, для весового товара)

XML-файл состоит из перечня тегов (<tag>) настроек клиентского приложения.
Теги влияют как на функционал RkMobWaiter так и на его отображение на экране мобильного устройства.
Краткое описание основных тегов содержится в конце статьи.

Оставшиеся разделы в TMS2.INI являются дополнительными и настраиваются только при определенной необходимости. Например, раздел [EXTSAVE] настраивается при работе КПК и заведения в целом в режиме - FAST FOOD. А раздел - [ENTERCARD] - настраивается при работе в конфигурации ПО "Карта на входе".

Примечание: при использовании режима FAST-FOOD кардинальным образом изменится функционал и технология работы с ПО RkMobWaiter. Настройка работы TMS в режиме FAST-FOOD описана отдельно - Настройка RkMobWaiter RK6 для работы в режиме "быстрого питания" (fast-food)

Так же, в каталоге \TMS имеется несколько дополнительных конфигурационных файлов: Printers.ini и Lang.ini. Эти файлы настраиваются по необходимости, в частности Printers.ini настраивается в случае использования нестандартных для TMS принтеров (т.е. тех для которых не подходят универсальные драйверы - Epson Roll 9x9 и Star Roll).

Далее, необходимо настроить основной конфигурационный файл (или его копии указанные для каждого экземпляра TMS, согласно настройкам TMS2.INI) используемый клиентскими приложениями (RkMobWaiter) - mwnsettings.xml.
Файл необходимо открыть на редактирование, либо простейшим блокнотом (Notepad.exe), либо, что более корректно, простейшим редактором XML-файлов (Например, - Notepad++). И указать адрес ПК, на котором запущен TMS (см.скрин), а так же порт, который будут использовать КПК для подключения к TMS (так же он указывается и в TMS2.INI, для каждого экземпляра TMS - свой.)

Рис. - Редактирование mwnsettings.xml.

Откорректировать IP-адрес нужно во всех трех местах. Параметры остальных тегов уже настроены и изменяются по мере необходимости. См. - "Описание тегов".

После выполнения всех настроек (Лицензирования в том числе - см. раздел "Лицензирование") запустить:

Кассовый сервер (NT-RKSERVER), если он еще не запущен.
Сервис MobilGuard2.exe, который запустит все экземпляры серверов TMS.

Если параметры лицензии и остальные настройки указаны верно, в трее, рядом со значком кассового сервера появится значок меню TMS, -

Рис. - Отображение меню Mobilguard со списком настроенных экземпляров TMS.

- зайдя в которое, можно увидеть весь список запущенных экземпляров TMS и открыть их по отдельности. В итоге, все запущенные приложения будут выглядить примерно так:

Рис. - Окно кассового сервера.

Рис. - Содержимое окон запущенных экземпляров TMS.

Клиентское приложение - RkMobWaiter

На последнем этапе, обычно выполняются настройки на самом мобильном устройстве (КПК) и в самом клиентском приложении - RkMobWaiter:

Подготовить КПК для работы - удалить все ненужные мультимедиа приложения. Это делается для того, что бы персонал использовал устройство исключительно для работы, а не для развлечений. Чем меньше вы оставите приложений на КПК, тем лучше.
Выставить (если не выставлены) корректную дату и время на мобильном устройстве.
Настроить связь КПК с ПК на котором запущен TMS. Если речь идет о IPOD, необходимо зайти в его системные настройки \ Wi-Fi, выбрать настроенную ранее точку доступа и назначить КПК статичный IP-адрес из того же сегмента сети что и ПК с TMS. Проверить наличие связи между КПК и ПК с TMS можно пингованием мобильного устройства с настольного компьютера. Если пинг идет, значит связь настроена корректно. Далее, два варианта:

Настройка КПК с ОС Win CE

В корневом каталоге КПК создать папку \UCS (принципиально и название каталога и его расположение в корне раздела), туда скопировать файлы клиентского ПО из дистрибутива взятого с ftp://.../r-keeper/WaiterNotepad/Current/WinCE/RK6/MobWaiterNP6.exe
Запустить приложение - MobWaiterNP6.EXE. Войти в его установки (пароль на вход - 051791), в установках вписать IP-адрес ПК с TMS и порт подключения к TMS указанный в TMS2.INI (а так же и в mwnsettings.xml). Так же, в заголовке окна с настройками будет отображаться номер, который необходимо считать и сделать запрос на код активации КПК в наш отдел лицензирования. Получить ответный код и ввести его там же, в "Установках".

Настройка КПК с ОС IOS

Подключить КПК к интернету и скачать с ресурса AppStore актуальную версию приложения RkMobWaiter. Запустить его, войти "Установки" (пароль - 051791). Указать IP-адрес ПК на котором запущен TMS и порт к его подключению. Само приложение на IOS (в отличие от Win CE) активировать нет необходимости.

Примечание: дополнительно можно проверить настройки работы Wi-Fi на КПК в разных режимах, т.е. в режиме ожидания, сна и т.п. Будет ли он отключаться или нет и т.п. А так же не забывать и о энергопотреблении устройства - эти настройки тоже желательно проверить и выставить оптимальные.

После всех настроек проверить работу всей системы. Запустить, сформировать заказ на КПК, сохранить, убедиться что вышел на сервис-печать и т.д.

Настройка КПК с ОС Android

Важно! С Rk6 не реализовано. Реализовано для RK7.

Лицензирование (до 2015 года)

Приложение сервера TMS защищено лицензионным USB-ключем Novex (Stelth II), как и большинство софта компании UCS. Необходимо:

Установить драйвер ключа. Актуальный дистрибутив драйвера можно взять с официального сайта - www.guardant.ru.
Подключить ключ. Дождаться окончания автоматической инициализации и установки драйвера в ОС (должна загореться зеленая лампочка на ключе).
Запустить утилиту лицензирования (LUpdater_NEW.EXE), которая идет в комплекте TMS. Считать код (короткий номер) - кнопка "Read", вписать полученный из Отдела Лицензирования ответ (длинный номер) и сохранить в ключ - кнопка "Write".

Рис. - Утилита лицензирования (до 2015-года).

Важно! в момент запуска утилиты лицензирования к ПК должен быть подключен только лицензируемый ключ TMS. Других ключей UCS подключено быть не должно. Иначе есть вероятность того, что будет считан/прописан другой ключ.

В записываемой лицензии ключа TMS два параметра:

Первый - дата до новой блокировки ключа. Т.е. закладывается период его работоспособности.
Второй - количество одновременных подключений клиентских приложений (RkMobWaiter) со статическими IP к серверу TMS.

Примечание: Если количество КПК в заведении работающих с TMS увеличивается, то ключ при помощи этой же утилиты можно перелицензировать после оплаты дополнительных лицензий и получения из отдела лицензирования нового кода активации на большее количество одновременных подключений (КПК) по IP к серверу(ам) TMS.

При настройке TMS в TMS2.INI, как правило, указываются дополнительные параметры лицензионного ключа, такие как его ID и количество подключений по IP.

При необходимости, количество подключений можно разделить на несколько TMS серверов. Например, ОДИН TMS-ключ прописан на 10 одновременных подключений с разных IP-адресов (т.е. с разных КПК). Это количество подключений можно разделить при запуске НЕСКОЛЬКИХ TMS одновременно на одном ПК указав дополнительные параметры в TMS2.INI.

Таким образом, например - 5 КПК будут подключаться и работать с сервером TMS №1, а 5 других будут привязаны и работать с сервером TMS №2. Дополнительная информация рассматривается в этой же статье, в разделе "Настройка сервера виртуальных станций - TMS".

Важно! Одновременно на одном ПК можно использовать для работы с TMS серверами только ОДИН ключ с лицензией на необходимое количество КПК-подключений.

Обновленное лицензирование (от 10.06.2015)

Статья по новому лицензированию.