Введение

Данное ПО позволяет осуществлять прием заказов непосредственно у столика гостя и передачу в систему в режиме онлайн. 
Переносной терминал официанта реализован на базе Apple iPod Touch 4G/5G, iPhone 4 и выше, совместим как с R-Keeper V6, так и  R-Keeper V7.
Терминал работает через WiFi.

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

Если вам требуется настроить совместное использование мобильного официанта и MCR-алгоритма, то обратитесь к статье обработка MCR-алгоритмов в мобильном официанте.

Состав дистрибутива

Данное ПО состоит из серверной части — TMS серверf, который необходимо лицензировать, и клиентского приложения, устанавливаемого на мобильное устройство.

1. ПО для мобильного устройства на базе iOS можно скачать с iTunesStore (https://itunes.apple.com/ru/app/rkmobwaiter/id478867072?mt=8), а сервер для него с ФТП UCS из папки ftp://ftp.ucs.ru/rk7/other/tms/
2. Во многих случаях различные версии TMS7 and MobileWaiter 7 не совместимы. В таких случаях следует обновить сервер и клиент одновременно.
3. Версию MobileWaiter 7 вы можете посмотреть в настройках приложения на мобильном устройстве.
4. В дистрибутиве с TMS сервером так же есть приложение LUpdater.exe. Позволяет считывать или записывать лицензию на ключ Guardant.

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

Важно!

Система лицензирования с 2016 года изменилась. Актуальная информация содержится в статье по лицензированию. Лицензирование до 2016 года описано ниже.

Защищается ключом только TMS-сервер и в нем прописывается количество подключений.

Примечание

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

Порядок действий при лицензировании сервера:

1. Если ключ не прописанный, то запустите приложение LUpdaterOld.exe (ftp://ftp.ucs.ru/r-keeper/WaiterNotepad/Current/TMS/RK7/LUpdaterOld.exe) и нажмите кнопку «Read». В верхней строке вы увидите код ключа.

Примечание

В настоящее время существует два типа лицензии - обычная и расширенная. Тип лицензии влияет на функциональные возможности клиентского приложения.

Расширенная лицензия дает следующие возможности (в отличии от обычной):

• Оплатить (закрыть заказ), но только одной валютой (обычно национальной). Возможно полная оплата или частичная;
• Редактировать сохраненный заказ (удалять  блюда, переносить блюда в другой заказ);
• Разбивать заказ по местам и производить оплату по местам;
• Активировать заказы из статуса черновик, инициализировать сервис печать;
• Редактировать метки гостей (названия мест), добавлять или удалять места/метки;
• Закрывать пустые заказы.

1. В зависимости от механизма лицензирования возможно два варианта:

• Старое лицензирование (без использования кода ресторана, без предупреждений об ограничении лицензии и доп. сообщений). Работает со ВСЕМИ версиями TMS7 (и до 7.4.16 и после) и с любой версией RK7. Для получения лицензий следует отправить код Татьяне Николаевой. Она пришлет код лицензии. 

Важно!

Код ресторана в tms7.ini прописывать не надо.

• Новое лицензирование (с использованием кода ресторана, с предупреждений об ограничении лицензии и доп. сообщениями) работает только с версии TMS7, начиная с 7.4.16. и MobWaiter 2.6.4, и с любой версией RK7. Лицензию можно получить на  l.ucs.ru. Используется для новых инсталляций. 

Важно!

Необходимо прописывать код ресторана в tms7.ini.

1. Лицензию, полученную вами на сайте l.ucs.ru, необходимо ввести в нижнюю строку в LUpdaterOld и нажать кнопку «Write». Затем нажать кнопку «Close».

Примечание

Обратите внимание, что существует множество различных версий приложения LUpdater и они функционально отличаются друг от друга (зависит от сервера, который лицензируется и даже от версии сервера). Необходимо выбирать только тот LUpdater, который лежит в той же папке, где и экзешник сервера. Если вы обновили сервер TMS7 до более новой версии, в которой изменился механизм лицензирования, то необходимо отправить новый запрос согласно пункту 2 с комментариями, что вы используете более свежую версию TMS.

Настройка ПО

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

Для использования MobileWaiter7 на мобильном устройстве (на платформе Windows CE или iOS) как станции официанта, необходимо использовать код реально существующей кассовой станции для данного устройства из РК7.

Примечание

Если у вас уже есть одна или более кассовая станция, то дополнительно заводить новую станцию для мобильного ПО не требуется.

Дополнительно в менеджерской станции необходимо сделать сделать следующее:

1. Для кассового сервера ("Сервис -> Станции и Устройства -> [ваш ресторан] -> [ваш кассовый сервер]") добавить новую кассовую станцию, выставить тип «Кассовая станция». Если у вас уже есть хотя бы одна кассовая станция, то можно использовать ее для интеграции с мобильным устройством. Главное, что требуется - это запомнить параметр "Код" в секции "Главное", в дальнейшем необходимо будет прописать в файле tms7.ini.
   
2. Добавьте “XML interface for windows” для соответствующего кассового сервера. Пропишите порт (любой, но свободный на данной машине) в секции "Опции" для параметра Port. В дальнейшем этот же порт необходимо будет прописать в файле tms7.ini у параметра "ServAddr="; Параметр CryptKey (ключ защиты) и OutputDir (каталог для входящих/исходящих запросов xml) можно не прописывать. Параметр CryptKey служит для шифрования подключения к XML-интерфейса. В дальнейшем это же значение необходимо будет прописать у параметра "ServPWD" в файле tms7.ini. 

Важно

Если в менеджерской прописан CryptKey, то в tms7.ini обязательно прописать такое же значение для ServPWD, иначе связь сервера TMS с кассовым сервером не установиться.

Убедитесь, что у вас нет других интерфейсов с таким же портом.

1. Проверьте, что интерфейс из п.2 привязан к логическому интерфейсу ("Сервис -> Интерфейсы"). Это может быть предустановленный XML-интерфейс или его копия (рекомендуется).
2. Проверьте, что параметр Карта на входе стоит в состоянии "без карты на входе". В противном случае при создании заказа из Мобильного официанта будет выдаваться ошибка child element "interface" not found.

Примечание

Не назначайте один и тот же драйвер интерфейса на несколько логических интерфейсов.

Настройка сервера TMS

Для запуска сервера TMS7 необходимы следующие файлы: MobilGuard7.exe, mwnsettings7.xml, TMS7.exe, tms7.ini – и две пустых папки: XMLs и TMP (создаются при запуске сервера автоматически).

Скачать дистрибутив сервера можно с FTP: ftp://ftp.ucs.ru/rk7/other/tms/

Сервер TMS7.exe слушает 3 порта:

• первый - основной (использует протокол TCP), прописывается в секции TMS у параметра port,
• второй (использует протокол UDP) = первый+1 - для проверки состояния сервера на клиенте (типа "пинг"),  
• третий (использует протокол UDP) = первый+2

Необходимо в TMS7.ini в обязательном порядке прописать следующие параметры:

• секция [LOG], параметр LogPath=D:\UCS\TMS\          ;; путь к каталогу с логом

• секция [TMS]

• Title=TMS7                                     ;; Название TMS

• ReadBufSize = 10000000           ;; Буфер для загрузки коллекций. При большом объёме справочников(коллекций), следует увеличить значение параметра вдвое более.

• KeyPublicNo=716919917           ;; указать ID лицензионного ключа (можно взять из LUpdater с конца 9 цифр, первые две цифры отбрасываются, можно посмотреть десятичный номер ключа в драйвере Guardant)

• UseLic=10                                      ;; указать количество подключений прописанных в ключе (в случае использования нескольких TMS)

• Index=0                                           ;; индексное число номера лицензий, по умолчанию = 0 (в случае настройки нескольких экземпляров, указывается для каждого конкретного сервера, см.ниже)

• Port=610                                         ;; порт подключения к экземпляру TMS-сервера по протоколу TCP. Это основной порт. Значение дублируется при указании порта в mwnsettings.xml

• RestCode=199990001                ;; полный код ресторана. используется для лицензирования

• WaitHallsRead=15                        ;; время в секундах задержки чтения панов зала (от 1 до 30). Если параметр не задали или указали значение больше 30, параметр принимает значение 1. Данный параметр работает только с версиями TMS сервера не ниже 7.4.111

• PackOnRecv=1                             ;; паковать заказ при получении от клиента, если параметр не задан, то принимает значение 0. Для версий 7.4.137 и выше.

• секция [RK7SERV]

• RestID="2"                                             ;; идентификатор ресторана. Если задан, то чтение персонала производится чтением списка ролей ресторана и по ролям чтением персонала. (Иначе говря: Если параметр не задан, то чтение ролей и работников программой Mobile идет по ВСЕМ ресторанам. Если задан - по одному, чей идентификатор указан.)

• StationCode=2                                        ;; код кассовой станции

• StationID=15664                                    ;; идентификатор кассовой станции, позволяет указать, от лица какой станции, TMS'у представляться в системе RK7(обязательное требование для блокировки заказа)

• PayStationCode=1                                 ;; код станции для оплаты. Он указан в свойствах кассовой станции менеджерской станции. 

• PayStationID=15001                              ;; идентификатор кассовой станции для оплаты. Не путать с сетевым ID, он указан в свойствах кассовой станции менеджерской станции. 

• ;RefUpdateTime=60                               ;; время в секундах устаревания загруженных данных справочников ;от 0 до суток без одной секунды ; если не задан 60 сек.

• ServAddr=172.22.3.109:14441           ;; IP-адрес и порт XML-интерфейса на кассовом сервере (см.рис.2)

• ServPWD=                                                ;; ключ шифрования. CryptKey в свойствах XML-интерфейса кассового сервера РК7   

• Locktime=                                                ;; параметр в секундах и отвечает за время блокировки заказа после создание/корректирования его в Mobile

Примечание

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

Необходимо в mwnsettings7.xml в обязательном порядке прописать следующие параметры:

•  <RK Ver="7"/>                                                                                                                ;; версия R-Keeper

• <PING IP="172.22.4.78" WaitTime="10" TryNumber="3"/>                                ;; IP-адрес машины, где установлен TMS сервер

• <SERV IP="172.22.4.78" PORT="610" SSID="" CanCloseConnect="1"/>      ;; IP-адрес машины, где установлен TMS сервер и его порт  = порт из tms7.ini

Выбор принтера печати пречека

Иногда требуется для печати пречека выбрать принтер, отличный от принтера по умолчанию. Чтобы это сделать, необходимо:

1. В файле TMS.ini, в разделе [PRECHECKINFO] убрать параметр MaketCode=
2. Сохраните изменения и перезапустите сервер TMS
3. Настройте схемы печати непосредственно в менеджерской станции r_keeper 7

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

Описание работы и пользовательских настроек описаны в документации ftp://ftp.ucs.ru/books/r-keeper_v7_mobwaiter_V2_8_0.pdf

Запустите приложение на мобильном устройстве. Зайдите в настройки (пароль=051791) и установите параметры сервера:

адрес, основной порт (TCP), тип версии (RK6 или RK7), тип лицензии (обычный или расширенный для RK7). Сохраните изменения и перезапустите приложение.

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

Работа аналогична работе клиента на базе iOS. Подробнее читайте в руководстве пользователя ftp://ftp.ucs.ru/books/r-keeper_v7_mobwaiter_iPod_ANDROID_user_manual.pdf.
Функционал полностью соответствует Мобильному официанту для Ipod.

Скачать дистрибутив можно на FTP сервере в разделе WaiterNotepad - ftp://ftp.ucs.ru/rk7/other/tms/ или в маркете - https://play.google.com/store/apps/details?id=ru.ucs.rkmobwaiter3&hl=ru#details-reviews

TMS-сервер универсален как для устройств на базе iOS, так и для устройств на базе Android. Работа с устройствами на Android поддержана в версии TMS-сервера не ниже 7.4.75. Клиентская часть -  3.0.4.

При выборе устройства необходимо учитывать следующее:

1. Версия ОС Android 4.4.x и выше, экран 5 дюймов или более и разрешениями:  FullHD, 1270*720, 1920*1080, 960*540;
2. Графика должна быть не ниже mali 400;
3. Программное обеспечение должно быть протестировано на указанных разрешениях и размерах экрана.
4. Использование на продвинутом устройстве (разрешение, параметры CPU и т.д.) необязательно даст прирост производительности;
5. При выборе устройства необходимо учитывать как частоту (рекомендуется не менее 1.2ГГц), так и размер кэша на процессоре (минимум 512кб). В настоящий момент времени появились устройства супер эконом класса, у которых кэш 256кб. На таких устройствах производительность может оказаться неприемлемо низкой;
6. При выборе устройства необходимо учитывать, какое на нем стоит ПО от производителя. Возможен вариант установки какой-нибудь продвинутой оболочки от производителя, которая "съест" производительность. Лучше всего использовать "чистый" Android".

После запуска приложения на мобильном устройстве, зайдите в настройки (пароль=051791) и установите параметры сервера: адрес, основной порт (TCP), тип лицензии (обычный или расширенный). Сохраните изменения и перезапустите приложение.

Описание конфигурационных файлов

Конфигурационные файлы

1. Необходимо отредактировать два файла (по умолчанию, только IP-адрес и код объекта RK7): tms7.ini (для TMS7.exe) и mwnsettings7.xml (для MobWaiterNP7.exe и RkMobWaiter.app).
2. Файл mwnsettings7.xml и  tms7.ini должен лежать рядом с TMS7.exe (если сеть защищена файерволом, то у вас могут быть проблемы с этим файлом, уже загруженным на PDA), затем так же поместите mwnsettings7.xml рядом с MobWaiterNP7.exe

Как эталон используйте поставляемый файл из дистрибутива. Описанное ниже содержание файла следует использовать лишь как пример:

Пример содержания TMS7.INI

[LOG]
; -- Параметры лога
;LogPath=f:\
; -- предельный размер файла (по достижении создается новый) значение измеряется в байтах --
TruncLogSize = 10000000
; -- время в часах сохранения файлов в каталоге TMP --
ClearTMPMin = 1
; -- сохранение логов за предыдущие периоды --
SaveTruncLog = 0
; -- параметры лог файла  --
QueryRequest = 1
MenuQuery = 1
ModQuery = 1
CommModQuery = 1
PersQuery = 1
TableCheck = 1
TableCheckLine = 1
PrinterConfig = 1
PrinterCommand23 = 1
PrinterCommand23Data = 1
PrinterDispatch = 1
PrecheckPrint = 1
Answer = 1
Socket = 1
NewTableDetaile = 0
NBCALLS = 0
SendRecv = 1
CardInfo = 1
RemovePreCheck = 1
RK7CommandLog = 1

VDU = 0
HallPlans = 1
Visibility = 1
FreeLicConnection = 1
Pager = 1
JSON = 1
CMDINFO = 1

[TMS]
; -- Заголовок --
Title=TMS7
; Буфер для загрузки коллекций.
ReadBufSize=20000000
; -- время обновления меню (сек) --
MUT=1000
PUT=3000
; -- число используемых лицензий  --
UseLic=2
; -- индекс номера лицензии (0 базовая) --
Index=2
; --прописать номер ключа для TMS, если к машине подключено несколько ключей --
; --номер можно считать программой LUpdater(начиная с 3 цифры), см.п.3.2.2 или с помощью утилиты "Драйвера гвардант" в панели управления
KeyPublicNo=716919917
; полный код ресторана
RestCode=199990015
; -- параметры соединения
; -- порт сервера TMS
Port=610
; -- разрешить официантам одновременное использование столов --
TableCommonUse=1
; -- удаление префиксных нулей из кода при логине
DelPrefZeros=1
; -- имя сервиса при установке как сервис
SVCNAME=TMS7

; -- паковать заказ при получении от клиента, если не задан, то 0

PackOnRecv=1

; --секция для перезапуска TMS  --
[Restart]
;Time=14:24:00
;WaitSeconds=72000
; --секция для закрытия TMS  --
[Close]
;Time=15:42:00
; -- файлы конфигурации для покета   --
[CFGXML]
7=mwnsettings7.xml
PG=pgsettings.xml
UseDig=3
; настройки соединения с кассовым сервером РК7
; обязательно задать параметры Addr и PWD

[RK7SERV]
;RestID="2"

RefUpdateTime = 4000
DoNotSendNullQnt=1
;DefOrderTypeID=1011458
;DefOrderTypeCode=2
; ------------------------------------------ RK7 ---------------------------------------------------------------
;; код кассовой станции
StationCode=11
;; идентификатор кассовой станции (не путать с сетевым ID)
StationID=15004
;; код кассовой станции для оплаты
PayStationCode=11
;; идентификатор кассовой станции для оплаты (не путать с сетевым ID)
PayStationID=15004
;время в секундах устаревания загруженных данных справочников
;от 0 до суток без одной секунды, если не задан 60 сек.
;RefUpdateTime=60
; IPадрес машины с кассовым сервером и порт XML-интерфейса, загруженного на кассовом сервере для TMS (рис.2)
ServAddr=172.22.3.109:14441
;ServPWD = CryptKey в свойствах XML-интерфейса кассового сервера РК7!
ServPWD=

; параметры необходимые для операции оплаты
[PAYOFF]
; используется ли данная функция
Active=1
; код представления документа для чека
ReceiptMaketCode=2164
; код валюты
PaymentCode=1
PaymentCode0=97
MaketCode0=88
PaymentCode1=89
MaketCode1=98
; Перевод из черновика в производство
[DRAFTTODO]
; курс черновика при чтении с кассы
DraftCourseCode=3
; курс активного заказа при сохранении с мобильного терминала
ActiveCourseCode=0
; курс черновика при сохранении с мобильного терминала
; если не задан, то приравнивается DraftCourseCode
CookLaterCourseCode=2
; Фиктивная схема общих модификаторов
[COMMONMOD]
; Идентификатор схемы, не должен совпадать с идентификаторами из БД
; = 1 если не задан ­
Ident=1
; ­настройки для печати пречека
[PRECHECKINFO]
; по местам или целым чеком
BySeats=1
; код представления документа для пречека
MaketCode=2160
; код станции печати пречека
PrecheckStationCode=13
;категории заказа
[ORDERCATEGORY]
Code=
;использование альтернативного имени как короткого
[ALTNAME]
Use=ShortName
;сортировать столы в планах по коду и планы по минимальному коду
[HALLPLANS]
SortPlansByCode=1 
;режим фастфуда
[EXTSAVE]
;Dir=F:\work\Mobile\TMS7\
[PRICESCALE]
;Scale=1000
[SORTMENU]
SortBy=2
[SOUNDS]
SaveNewOrder=64
;; специализированный режим для очень большого меню (10000 пунктов). В таком случае для ускорения идёт привязка к ценам станции. Сейчас не используется, т.к. справочники в любом случае передаются единым сжатым куском.
[BIGMENU]
Use=0
; параметры вызова VDU

[VDU]
VDUID      = 130
LocalPort  = 1111
RestCode   = 199999999
Waiter     = iPod
ShowComboTitle  = 1
; с версии 7.4.51 в группу VDU добавлен параметр UnitNum (61 если не задан) позволяет осуществлять фильтрацию выводимых заказов на VDU по номеру юнита.
UnitNum=1
; параметры вызова RTCPGATE.DLL
[RTGI] 
// ip-адрес машины, где запущен фаркардс и порт протокола [RTCP]
Addr=172.22.4.113:2044
// код ПДС интерфейса из РК7
Interface=100
Cashier=555

; ближайшее время RK7 сделают отдельный запрос, пока так

[ORDER]

DefCateg=10033

[SPEECH]
; использовать или нет голосовые сообщения
Use=1
; индекс используемого голоса
Voice=16
; скорость проговаривания
Rate=4
; префикс для идентификации источника голосового сообщения
Pref=Красный зал.

[CARDDATA]

// код ПДС интерфейса из РК7
Interface=100

Описание параметров в файле tms7.ini

1. Для активации платежей установите «Active=1» в секции [PAYOFF], для отключения установите соответственно «Active=0».
Если вы устанавливаете «Active=1», то убедитесь, что два параметра: «ReceiptMaketCode=» и «PaymentCode=» настроены правильно.
PaymentCode= это код валюты RK7 для оплаты.
Вы сможете сделать платеж на PDA только с одним временным набором для этого параметра.

В поле ReceiptMaketCode=  это схемы печати из настроек RK7. Схемы печати находятся в Настройки > Печать > Схемы печати:

2. Если вы используете обязательный тип гостей, установите DefGuestType=1 (или другой код типа гостя) в секции [RK7SERV] файла tms7.ini. Параметр в RK7 «Исп.тип гостей» не должен быть установлен в значение «Обязательное свойство», следует выбрать «неoбязательное свойство» или «не использовать». DefGuestType=0 означает, что в заказе не будет определятся тип гостя.

Примечание

Начиная с версии клиента Ipod 2.6.6 и TMS-сервера 7.4.32 реализован механизм выбора типа гостей.

В RK7 есть параметр [Все] - [Использование опций] - [Свойства визита] - [Исп. тип гостей], который может принимать 3 значения:

• Не использовать
• Обязательное свойство
• Необязательное свойство

1. Если выбран вариант - «не использовать», то никаких настроек в MobWaiter делать не надо. Тип гостей будет не доступен на кассе и также не доступен на Ipod.
2. Если выбран вариант - «необязательно», то на TMS-сервер будет передан список Типов гостей для выбора. Никаких настроек в MobWaiter делать не надо, типы гостей будут доступны для необязательного выбора.
3. Если выбран вариант - «обязательно», то на TMS-сервер будет передан список Типов гостей для выбора.

При этом в tms7.ini в секции [RK7SERV] надо задать параметр 
DefGuestsTypeID и/или DefGuestsTypeCode.

Примечание

Если задан DefGuestsTypeID, то DefGuestsTypeCode игнорируется.

[RK7SERV]
DefGuestsTypeID=Y 

где Y- идентификатор типа гостей, который будет использован для стартового назначения Типа гостей в заказ. Этот Тип гостей не будет выбран в заказ, а лишь «бронирует» обязательный выбор для Типа гостей.
В этом варианте без выбора Типа гостей невозможно выйти из заказа.

3. В секции [LOG] вы можете активировать или деактивировать сообщения, которые были записаны в файл TMS7.LOG.
4. Параметр «Title=» в секции [TMS] устанавливает имя сервера системы. Вы можете поменять этот параметр в случае запуска двух или более TMS7 серверов в одном окне операционной системы (серверы должны иметь различные системные имена). В данном случае вы должны поменять значение параметра «Port=» так, чтобы каждый из этих серверов имел уникальный порт (имеется ввиду изменение соответствующего параметра «Port» в файле mwnsettings7.xml).
5. Если два или более TMS7 сервера в одном окне операционной системы используют один ключ Guardant, то вам необходимо настроить параметры «UseLic=» и «Index=» в секции [TMS]. «UseLic=» является приоритетом данного экземпляра сервера при подсчете лицензий (т.е. определяет кол-во лицензий, которые будет задействовать сервер), «Index=» - это номер PDA, который соединяется с этой копией сервера.

Пример содержимого mwnsettings7.xml

<?xml version="1.0" standalone="yes"?>
<SETTINGS>
<RK Ver="7"/>
<PING IP="172.22.4.78" WaitTime="10" TryNumber="3"/>
<SERV IP="172.22.4.78" PORT="610" SSID="" CanCloseConnect="1"/>
<TIMES Sync="2" ST="20" Serv="60"/>
<CAN DD="0" CC="1" QOS="0" CLC="0"/>
<MENU Cash="1" UpTm="1" UseNameSearch="1" ClearSearch="1"/>
<ConPar CWT="50"/>
<LANG Use="0"/>
<!--<GUESTS DefNum="3" DefTabCode="212"/>-->
<MSGQ SMN="3"/>
<CHPACK Pack="0"/>
<COMMON6 QDN="3"/>
<FLASH Use="1" TickDuration="50" FlashTickNumber="8" DimTickNumber="4"/>
<READERS Use="7">
<Codes>
<Code Pref="778" Corp="13555" Rest="0001"/>
</Codes>
</READERS>

<MANCODEINPUT>
<Intervals>
<Interval Begin="100" End="1000"/>
</Intervals>
</MANCODEINPUT>

<!-- Type: 1 - Code, 2 - Name, 3 - Qnt, 4 - Price, 5 - Seat, 6 - Time, 7 - Summ, 8 - KDS state image -->
<!--
<ORDERFIELDS>
<VERT>
<Item Width="200" Type="2"/>
<Item Width="42" Type="4"/>
<Item Width="40" Type="3"/>
<Item Width="40" Type="5"/>
</VERT>
</ORDERFIELDS>
-->
<RK7 EditDraft="1" UseCodeNameChoice="0" UseCodeByDefault="0" UseHorzOrientation="0" 
StepByStepNewOrder="0" FastFoodScanNumber="0" FastFoodDigNumber="4" HideDefModifiers="1" BigMenu="0" NewDishNewString="1"
OrderComplete="1" Suggestions="1" CanSpeakSuggestions="1" DiscCardRegime="0" Plustek="0"/>
<SuggestionsView>
<iPod TopPanelHeight="40"  BottomPanelHeight="52"/>
<iPad TopPanelHeight="40"  BottomPanelHeight="60"/>
</SuggestionsView>
<Messages SoundInterval="5"  SoundFile="" ShowMsgInTablesWindow="0" SpeakMsg="0"/>


<!--
<PINPADS>
<PinPad ID="88" Name="Pin Pad #11 OOO"/>
<PinPad ID="89" Name="Pin Pad #12 IP"/>
</PINPADS>
-->

<!--<MenuPricesTableCode Code="206"/>-->

<WINCE>
<ORDFCL T="40" H="234" V="1" CW0="62" CW1="256" CW2="68" CW3="90" TFSZ="22" SFSZ="32" LFSZ="28" QDN="3"/>
<ORDMBTN W="155" H="52" DX="3" DY="3" BW="32" BH="32" BAL="1" TXTW="105" TXTH="22" TXTMH="15" TXTFW="400"/>
<ORDMSBT W="32" H="32" DX="5" DY="5" TH="16" TL="3" USE="1"/>
<BMPCASH SID="100" EID="5000"/>
<SBTS>
</SBTS>
<Plan Use="1" Scale="0.66666" TH="14" TW="700" TBW="50" TBH="50"/>
<PlanNR Use="1" Scale="0.33333" TH="10" TW="700" TBW="50" TBH="50"/>
<EXTDEV Use="0" CrdFmt="1" COM="8"/>
<KEYS K1="193" K2="0" K3="195" K4="196" K5="197" K6="13" K7="205"/>
<CHKFM PW="30" QRO="9" SW="7" SAD="3"/> 
<CRSS Use="0" TI1="384" TI2="386" TI3="387" TI4="388"/>
<COMBO CReg="2"/>
<FFOOD BegNo="300"/>
</WINCE>
<IPOD>

<!--<Messages SoundFile="VovkaZolotaiarybka.m4r"/>-->
<Use HallPlans="1"/>
<OrderSum Hide="0"/>
<TablesView CollButtonTitleHeight="20" CollButtonTitleWidth="46" CollButtonHeight="90" CollButtonWidth="90" CollCount="3" RowHeight="106"/>
<OrderView CourceItemColor="15845119" CourceBckgColor="16773098" ComboItemColor="13038079" ComboBckgColor="15728618" 
ModOffset="20" ComboOffset="10" NewBckgColor="16313310" PaidBckgColor="8355711" SavedBckgColor="5987327" DraftBckgColor="54741" 
SumWidth="100" DishTitlePriceWidth="60" DishTitleQNTWidth="40" DishTitleCodeWidth="40" DishListModyHeight="28" DishListDishHeight="28" 
DishTitleHeight="22" MenuHeight="204" ButtonLineHeight="44" DishListHeight="148"/>
<MenuView CurValMarkTextColor="16777215" CurValMarkBckgColor="255" LimitMinMarkTextColor="16777215" LimitMinMarkBckgColor="255" 
LimitMaxMarkTextColor="16777215" LimitMaxMarkBckgColor="255" BtnTxtHeight="16" BtnDY="3" BtnHeight="64" BtnDX="3" BtnWidth="103"/>
<MessagesView RowHeight="54" TextFontHeight="54" />
<OutgivingView OSO="5"/>
</IPOD>
<IPAD>

<!--<Messages SoundFile="VovkaZolotaiarybka.m4r"/>-->
<Use HallPlans="1"/>
<OrderSum Hide="0"/>

<!--<TablesView CollButtonTitleHeight="20" CollButtonTitleWidth="46" CollButtonHeight="90" CollButtonWidth="90" CollCount="3" RowHeight="106"/>-->
<!-- <OrderView CourceItemColor="15845119" CourceBckgColor="16773098" ComboItemColor="13038079" ComboBckgColor="15728618" 
ModOffset="20" ComboOffset="10" NewBckgColor="16313310" PaidBckgColor="8355711" SavedBckgColor="5987327" DraftBckgColor="54741" 
SumWidth="150" DishTitlePriceWidth="60" DishTitleQNTWidth="40" DishTitleCodeWidth="40" 
DishListModyHeight="38" DishListDishHeight="38" DishTitleHeight="22" MenuHeight="204" 
ButtonLineHeight="44" TopButtonLineHeight="64" MidButtonLineHeight="54" DishListHeight="348"
DishFontSize="24" ModyFontSize="20"/>

<MenuView CurValMarkTextColor="16777215" CurValMarkBckgColor="255" LimitMinMarkTextColor="16777215" LimitMinMarkBckgColor="255" 
LimitMaxMarkTextColor="16777215" LimitMaxMarkBckgColor="255" BtnTxtHeight="24" BtnDY="3" BtnHeight="104" BtnDX="3" BtnWidth="153"/>   -->


<!--<Messages SoundInterval="5"  SoundFile=""/>-->
<MessagesView RowHeight="54" TextFontHeight="54" />
<OutgivingView OSO="5"/>
</IPAD>
</SETTINGS>

Описание параметров в mwnsettings7.xml

1. Для работы offline (открытия столов и сохранения заказов) вы должны создать (если еще нет) стол с неким кодом (например: 666) и добавить тэг <MMPRCS TC="666"/> в файл mwnsettings7.xml внутри тега <SETTINGS> </SETTINGS> (если его еще нет здесь).

Это также означает, что если взять предустановленный файл mwnsettings7.xml из дистрибутива, то он не будет работать правильно, пока есть стол с номером 666 в вашей БД RK7 или пока вы не исправите код стола внутри тега, указанного в существующем файле.

2. Для работы только в режиме online удалите тег <MMPRCS/> из mwnsettings7.xml и добавьте вместо него <ZCFGTAG tag="TIACXWLN1"/>.

3. Внутри тега <CAN/> значение параметра CC=“0” отключает кнопку закрытия, исключая низшие настройки режима.

4. Для изменения языка программы измените в теге <LANG/> параметр Use="0":

0 Russian (Русский)
1 Bulgarian (Болгарский)
2 Spanish (Испанский)
3 Ukrainian (Украинский)
4 Lithuanian (Литовский)
5 Latvian (Латвийский)
6 Estonian (Эстонский)
7 Hungarian (Венгерский)
8 Czech (Чешский)
9 Polish (Польский)
10 Romanian (Румынский)
11 French (Французский)
12 English (Английский)
13 Serbian (Сербский)
14 German (Немецкий)
15 Vietnam (Вьетнамский)
16 Arabic (Арабский)
17 Georgian (Грузинский)
18 Macedonian (Македонский)
19 Thai (Тайский)

5. Для использования Bluetooth-принтера (например bixolon SPP-R201BGM) внутри тега <EXTDEV/> установите параметр Use="4".

Проверьте так же, что настроен правильно следующий параметр COM="7" (номер COM-порта на PDA). Имейте ввиду, что от настроек языка в теге <LANG/> зависят настройки для печати правильных символов в заказе.

6. Для настройки на Bluetooth-принтере формата счета измените в теге <CHKFM/> следующие параметры: PW="32" ширина столбца (в числовых символах); QRO="11" правая сторона колонки смещения "Quant"; SW="7" - ширина колонки "Sum"; SAD="2" количество чисел в секции Sum.

7. В теге <GUESTS/> есть параметр DefNum="1", который равен числу гостей по умолчанию. Если вы добавите этот тег в файл mwnsettings7.xml между тегами <MMPRCS/> и </SETTINGS>, то диалог "Количество гостей" не будет появляться на PDA. Если установить DefNum="0", то диалог «Количество гостей» будет появляться так же без тега <GUESTS/>.

8. В теге <GUESTS/> параметр DefTab="1" определяет по умолчанию код стола для сохранения заказа. Если присвоить этому параметру значение отличное от нуля, то диалог «Номер стола» не будет появляться и все заказы на PDA будут сохранены на этот номер стола. DefTab="0" включает диалог «Номер стола».

9. Для изменения стандартного набора колонок окна заказа и их размеров необходимо задействовать тег ORDERFIELDS и в нем для соответствующего типа задать ширину:

Возможные значения Type:

"1" - Code - код блюда,
"2" - Name - название блюда,
"3" - Qnt - количество блюд,
"4" - Price - цена блюда,
"5" - Seat - место/метка блюда,
"6" - Time - время добавления блюда,
"7" - Summ - кол-во * цена блюда,
"8" - KDS state image - статус блюда из системы KDS

<ORDERFIELDS>
<VERT>
<Item Width="240" Type="2"/>
<Item Width="40" Type="3"/>
<Item Width="40" Type="5"/>
<Item Width="20" Type="7"/>
</VERT>
</ORDERFIELDS>

10. Для выбора версии R-Keeper параметр тэга <RK Ver="7" />  должен быть в значении 6 или 7. Другие значения Ver приводят к неработоспособности ПО.

Запуск ПО

Порядок запуска одного экземпляра

1. Запустите кассовый сервер MIDSERV.exe (с ключом /desktop или /install как обычно)

2. Запустите сервер ТМС - TMS7.exe. Для запуска сервера ТМС в качестве приложения - используется обычный запуск, без параметров. Для установки в качестве службы используется параметр /INSTALL. Так же для запуска сервера можно использовать MobilGuard7.exe, который запускает TMS7.exe и в случае сбоев, перезапускает его. 

3. Запустите приложение MobWaiterNP7.exe на мобильном устройстве (IPod) или MobWaiterNP7.exe, если используется PDA.

4. Также необходимо запустить кассовую станцию и зарегистрироваться "мобильным" пользователем в смене, если этого еще не было сделано.

5. В свойствах кассового сервера после вы можете наблюдать соединение:
   

Запуск нескольких экземпляров сервера на одном компьютере

Предположим, что необходимо несколько мобильных официантов (например 9) распределить на несколько кассовых станций (например 3) в пределах одного кассового сервера.

Для этого необходимо cделать следующее:

1. Разделить TMS по разным каталогам. Создать столько каталогов, сколько кассовых станций используется в системе, т.е.3.
2. Отредактировать в каждом каталоге в tms7.ini параметры:

[TMS]
; -- Заголовок --
Title=TMS7 - уникальный заголовок для TMS
; -- время обновления меню (сек) --
MUT=1000
PUT=3000
; -- число используемых лицензий --
UseLic=3 - количество используемых подключений iPOD на один тмс сервер; 
Index=1 - не повторяющийся номер индекса, у первого тмс - 1, соответственно у второго - 2 и т.д.
; --прописать номер ключа для TMS, если к машине подключено несколько ключей -- 
; --номер можно считать программой LUpdater (начиная с 3 цифры) или с помощью утилиты "Драйвера гвардант" в панели управления 
KeyPublicNo=Указать код ключа, одинаков у всех сборок.
; -- порт для сервера TMS
Port=610 - уникальный порт экземпляра сервера

[CFGXML]
7=mwnsettings7.xml - изменить название у каждого сервера на уникальное и указать в параметре.
UseDig=3

Пример. Предположим, что мы хотим использовать 20 лицензий на подключение, разнесенных по 4 серверам. В этом случае настройки Index/UseLic будут выглядеть следующим образом:

        tms7.ini первого сервера:

        UseLic=5
        Index=0

        tms7.ini второго сервера:

        UseLic=5
        Index=1

        tms7.ini третьего сервера:

        UseLic=5
        Index=2

        tms7.ini четвертого сервера:

        UseLic=5
        Index=3

1. Не забудьте так же поправить файл mwnsettings7.xml у каждого сервера на требуемые настройки соединения.
2. Если необходимо сделать так, чтобы iPad'ы относящиеся к серверу - TMS1 при распечатке пречека использовали принтер, указанном как пречековый у станции с кодом 2 необходимо проверить следующие параметры:

[PRECHECKINFO]
BySeats=0
MaketCode=9
PrecheckStationCode=2

1. Для каждого TMS сервера в ini файле указать соответствующий код и идентификатор станции для параметров:

• StationCode=2   

• Station ID=15664 

• PayStationCode=4                           

• PayStationID=15004    

Внимание

Для работы TMS сервера необходимо три открытых порта: 610 TCP (в стандартной конфигурации), 611 UDP и 612 UDP. Первый прописывается в ini-файле, вторые два включаются автоматом по принципу "два следующих порта по порядку". Соответственно, если стоит задача запустить 4 TMS сервера, то указывать порты в ini-файлах нужно следующим образом - 610, 613, 616, 619 с расчетом на то, что между двумя указанными TCP будут автоматически подняты еще два UDP.            

Замечания

Получение дополнительной информации

Для ответов на оставшиеся вопросы, просьба воспользоваться пользовательской документацией под адресу ftp://ftp.ucs.ru/books/r-keeper_v7_mobwaiter_V2_8_0.pdf , б0льшая часть приведённых, в настоящей статьей, параметров и их предназначения так же освещена более развернуто там.

1. В настоящее время есть следующие ограничения функциональности:

1. PDA не будет работать корректно, если ваш кассовый сервер работает под DOS. В настоящее время правильная работа возможна только на кассовом сервере под Windows.
2. Операции с комбо-блюдами ограниченны. Если у вас есть комбо в вашем меню, MW7 показывает их, но вы не сможете сохранить заказ в некоторых случаях (в данный момент тестируется).
3. Система не будет правильно работать, пока вы не разместите ваши столы на плане зала.

2. Возможны несколько вариантов настройки mwnsettings7.xml:

первый позволяет вам работать только online, второй позволяет работать offline;

первый позволяет вам делать оплаты с помощью PDA, другие способны только для сохранения заказа. В режиме offline вы должны обязательно использовать только существующие коды столов. Так же вы можете распечатать чек и произвести оплату после этого.

3. Для запуска PDA (папка «UCS» должна лежать обязательно в корне его файловой системы) необходимы 2 файла: MobWaiterNP7.exe и mwnsettings7.xml (эти xml должны быть как обычно предварительно загружены). В течении этого времени загрузки создаются другие файлы в этой директории и также папке Temp на вашем PDA (в случае смены настроек лучше удалить все файлы, созданные этим приложением).

4. Это описание актуально для MW 7.1.01.

5. Программное обеспечение PDA работает правильно только с версией RK7.4.12.8. и старше. Так что, вам нужно брать самую последнюю версию RK7 для работы MW7.

6. Параметр UseHorzOrientation - устаревшая настройка для RkMobWaiter, которая ныне работает исключительно в RkMobWaiterTab (RkMobWaiter для планшетов)

Поиск и устранение неисправностей

Проблема отсутствия связи

1. Сделайте логирование xml interface. Для этого в станции менеджера RK7 в пункте: «Сервис > Станции и устройства > все > [ваш ресторан] > [ваш кассовый сервер]» на вкладке «драйвера» выберите xml interface, созданный для сервера TMS7 согласно п. 1.1. Настройте options > outputdir property (введите существующий путь для сохранения входящих и исходящих файлов xml interface).

2. Запустите сервер TMS7 и приложение MobileWaiter7. Если появится ошибка, остановите все эти приложения и удалите все xml-файлы из папки с логами.

3. Сравните .xml файл из папки логов с TMS7.LOG и временным файлом из папки TMP (которая упомянута в п. 2.1.). Найдите все записи с ошибками, связанными с проблемами этого файла и предположениями как решить их (если у вас нет предположений, спросите в тех. поддержке UCS).

При считывании QR-код из мобильного официанта ошибка: "Карта не была применена"

Карта сгенерирована из ПО виртуальная карта в виде QR-код. В базе CRM она активна.

Решение:

1. Обновите TMS7.exe до версии 7.3.09+ и MobWaiter до версии 2.5.5+.

2. В фал mwnsettings7.xml добавьте в секцию RK7 параметры DiscCardRegime="0" Plustek="0" 
3. В файл Tms7.ini добавьте

[RTGI] 
Addr=172.22.4.113:2044
Interface=100
[CARDDATA]
Interface=100

где

Interface=100 - это код ПДС интерфеqса из RK7 ,

Addr=172.22.4.113:2044 - ip-адрес машины, где запущен фаркардс, и порт протокола [RTCP]