iikoMobile_install_doc_0.2.1x

ARBUS
iikoMobileFront 0.02
21.09.2012
Оглавление
Общие сведения ...................................................................................................................................... 1
Функциональные возможности и ограничения.................................................................................... 2
Установка и настройка iikoMobileFront ................................................................................................. 3
Установка плагина ............................................................................................................................... 3
Установка службы iikoMobileServer (IMS).......................................................................................... 3
Установка мобильного приложения .................................................................................................. 4
Запуск и настройка мобильного приложения .................................................................................. 5
Использование iikoFrontMobile.............................................................................................................. 7
Общие сведения
Программный продукт iikoMobileFront предназначается для автоматизации работы официантов с
использованием мобильных устройства Apple iPod Touch 4 (версия iOS 5.1). Программный продукт
является расширением к базовому продукту – системе iikoRMS (www.iiko.ru) и взаимодействует
через предоставленное со стороны iikoFront API.
Архитектурно программный продукт iikoMobile разделен на программные модули:
1. Плагин для работы с iikoFront API
2. iikoMobileService (IMS)
3. Мобильный клиент под iOS
iikoFront API <> API Plugin <> iikoMobileService < > Мобильный клиент под iOS
Рисунок 1. Вариант настройки с выделенным сервером
Бэк-офис
Выделенный
сервер
iikoMobileServer
Группа станций
ГлКасса
ArbusFrontPlugin.dll
Resto.Front.Api.V1.dll
WiFi
зона
ARBUS
iikoMobileFront 0.02
21.09.2012
Функциональные возможности и ограничения
Решение iikoMobileFront позволяет осуществлять создание, просмотр и изменение данных в
единой базе гостевых заказов в режиме реального времени.
В текущей версии поддерживаются следующие возможности:
1. Авторизация официанта по ПИН-коду, в т.ч.: с проверкой на наличие открытой личной смены
официанта
2. Работа со списком открытых столов, в т.ч.:
2.1. поддержка нескольких Гостей в одном заказе
2.2. показ только "своих" заказов текущего официанта
2.3. псевдозакрытие заказов (заказы в статусе пречека невидны)
3. Работа со списком свободных столов (без графического плана зала)
4. Работа с иерархическим списком меню
5. Поддержка модификаторов, в т.ч.:
5.1. контроль минимального/максимального количества
5.2. групповых модификаторов (несколько групп у одного блюда)
5.3. возможность изменения значения модификатора для каждой строки неотпечатанного
блюда
6. Ведение заказа по гостям, в т.ч.:
6.1. перенос блюда/блюд между гостями
7. Операции со строками заказа, в т.ч.:
7.1. Групповые операции со строками заказа (выделение с последующим действием)
7.2. Изменение количества неотпечатанного блюда
7.3. Удаление неотпечатанного блюда
7.4. Отложенная печать (сохранение неотпечатанных строк заказа)
7.5. Печать блюд (без повторной печати)
8. Контекстный поиск блюда по названию
9. Добавление/удаление гостей из заказа
Не поддерживаются и не планируются в последующих версиях следующие возможности
стационарного фронта:
1.
2.
3.
4.
5.
6.
7.
8.
9.
Mix
Графический план зала
Переносы заказов, в т.ч.: на другой стол, на другого официанта, объединение заказов.
Переносы блюд: в новый заказ того же официанта, в существующий заказ того же официанта,
в новый заказ другого официанта.
Работа со списками банкетов/резервов. Активация банкетных/резервных заказов.
Удаление сохраненных блюд
Ножницы (разделение блюда по Гостям)
Автоматическое добавление позиций в заказ
Активация скидок, в т.ч.:
9.1. по карте
9.2. ручной
9.3. автоматической
ARBUS
iikoMobileFront 0.02
21.09.2012
Установка и настройка iikoMobileFront
Решение включает в себя следующие программные модули:
1. Плагин для iikoFront (\\FrontPlugin\ArbusFrontPlugin.dll)
2. Windows - cлужба iikoMobileServer (\\ims.exe)
3. Мобильный webapp клиент (устанавливается с сайта разработчика)
Модули используют возможности Windows Communication Foundation (WCF) и требуют
установленного фреймворка .NET 3.5.
! Поддерживается версия iiko не ниже 2.5.2
Установка плагина
(для версии 0.2.1)
Плагин устанавливается на терминал с Главной Кассой (ГК).
На главную кассу в папку "C:\Program Files\iikoRMS\Front.Net\Plugins\" скопировать файлы:
\\FrontPlugin\ArbusFrontPlugin.dll
\\FrontPlugin\ArbusFrontPlugin.cfg
В файле настроек ArbusFrontPlugin.cfg в строке
<add baseAddress="http://localhost:8787/ArbusFrontPluginService"/>
определен номер порта, по которому будет отвечать плагин. Значение по умолчанию 8787. Этот
порт должен быть открыт в брандмауэре.
Запустить фронт. Факт успешного запуска плагина можно проследить через лог-файл
для версии 2.5: %appdata%\iiko\CashServer\Logs\out-of-proc-host-X.log
для версии 2.6: %appdata%\iiko\CashServer\Logs\plugin- ArbusFrontPlugin.log
Пример лога:
[2012-03-27 15:36:38,458] DEBUG [ 4] [OutOfProcHost:LoadObject] - Try load type
'ArbusFrontPlugin.ArbusFrontPlugin' from assembly 'C:\Program
Files\iikoRMS\Front.Net\Plugins\ArbusFrontPlugin.dll'
[2012-03-27 15:37:02,989] INFO [ 4] [ArbusFrontPlugin:Init] - ArbusFrontPlugin has been started
! Если касса запускается на Windows7, то возможно потребуется запускать фронт с
правами администратора.
Установка службы iikoMobileServer (IMS)
Устанавливается в виде службы на выделенный сервер (если есть). Может устанавливаться
непосредственно на терминал главной кассы.
Скопировать папку IMS на нужный компьютер, например: C:\IMS.
Если плагин и IMS устанавливаются на разных компьютерах, то в файле конфигурации
ims.exe.config в разделе <client> необходимо прописать адрес и порт терминала главной кассы, где
был установлен плагин.
Например:
<endpoint address="http://192.168.0.228:8787/ArbusFrontPluginService"
! Установку службы необходимо выполнять с правами администратора
В строке
<add baseAddress="http://localhost:8732/IMSService/" />
определен номер порта, по которому будет отвечать IMS. Значение по умолчанию 8732. Этот порт
должен быть открыт в брандмауэре.
Для установки и старта службы необходимо выполнить install.bat
Для остановки и деинсталляции службы запустите uninstall.bat
ARBUS
iikoMobileFront 0.02
21.09.2012
Проверить факт запуска службы IMS через лог-файл \\IMS\ims.log
Пример лога
21.09.12 15:44:16.0 Старт iikoMobileServer v0.2.0.15053
21.09.12 15:44:16.0 Запуск WCF-службы...
21.09.12 15:44:16.3 WCF-служба успешно запущена
Установка мобильного приложения
Установка мобильного приложения на устройство осуществляется в режиме WebApp.
Преимуществом варианта WebApp перед распространением через AppStore является более
быстрая возможность внесения изменений в ПО и работа без наличия аккаунта Apple ID. При этом
WebApp приложение для пользователя выглядит аналогично установленному из AppStore.
Для выполнения установки выполните следующие действия.
На мобильном устройстве (iPod Touch4, iPhone 4) открываем браузер Safari и в командной строке
набираем адрес текущей версии приложения (см. http://redmine.arbus.biz/projects/prj166/wiki )
!Важно. Версия iOS на устройстве должна быть 5.1. В противном случае экран для
ввода ПИН кода будет отображаться некорректно.
Должна загрузится страница для ввода ПИН-кода сотрудника. Далее в строке функциональных
клавиш нажимаем на кнопку «Действие» и выбираем пункт «Добавить в «Домой»».
ARBUS
iikoMobileFront 0.02
21.09.2012
После добавления на домашнем экране должна появится иконка, при помощи которой
приложение можно запускать в дальнейшем.
Запуск и настройка мобильного приложения
Запуск установленного мобильного приложения осуществляется путем нажатия на иконку
приложения на домашнем экране устройства.
ARBUS
iikoMobileFront 0.02
21.09.2012
! В настоящий момент приложение при каждом запуске будет обращаться к серверу
разработчика посредством Интернет. В дальнейшем будет реализован режим «Stand
alone», при котором наличие интернет для запуска приложения не потребуется.
После запуска приложения необходимо настроить его доступ к службе iikoMobileServer. Для этого
введите PIN администратора (000000) и попадете в окно настройки.
Введите IP-адрес компьютера внутри сети ресторана, на котором работает служба iikoMobileServer
(обычно это или главная касса или выделенный сервер). При необходимости измените номер
порта (по умолчанию 8732). Нажмите Ок.
Если служба iikoMobileServer настроена и работает, то можно начинать работу по обработке
заказов.
Приложение предусматривает работу в портретной ориентации устройства. Рекомендуется
заблокировать повороты экрана. Это делается стандартными средствами iOs.
ARBUS
iikoMobileFront 0.02
21.09.2012
Использование iikoFrontMobile
Окно регистрации. Введите существующий ПИН-код сотрудника. Завершите ввод кнопкой [>].
Сотрудник должен иметь права официанта и открытую личную смену.
Окно выбора существующего заказа или свободного стола
Если при вводе ПИН кода сотрудника вы получаете ошибку: Ошибка загрузки меню. AJAX Get
Error, то нужно проверить настройки адреса и порта доступа к IMS службе мобильного клиента
ARBUS
iikoMobileFront 0.02
21.09.2012
ARBUS
iikoMobileFront 0.02
21.09.2012
Работа с заказом
В окне работы с заказом для работы с меню используется Селектор – слайдер. Он вызывается
свайпом (скользящее движение пальца справа – налево от правого края экрана) или кнопками
управления Селектором [Б | М].
Работа с модификаторами
ARBUS
Ввод дробного количества
Контекстный поиск
iikoMobileFront 0.02
21.09.2012
ARBUS
iikoMobileFront 0.02
21.09.2012