Установка и настройка iikoWaiter Pro

Данный документ содержит информацию по установке, настройке и сопровождению мобильного приложения iikoWaiter Pro.

Данный документ предназначен для технических специалистов, осуществляющих настройку и поддержку программных продуктов iiko.

История изменений

Дата

Версия

Автор

Комментарий

20.06.14

1.00

Мясников С.А.

Действительно c версии 2.1.6

20.10.14

1.01

Мясников С.А.

Ревизия, дополнения, исправления.

11.12.14

1.02

Мясников С.А.

+ Настройки для возможности оплат.

01.04.15

1.03

Мясников С.А.

+ Скриншоты с WiFi Analyser

Оглавление

Общие сведения

Совместимость

Требования к Wi-Fi и настройкам сети

Архитектура решения

Установка и настройка

Настройки iiko

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

Настройка главной кассы

Настройка маршрутизации печати пречеков

Настройка прав пользователей

Настройка типов внесения/изъятия

Установка плагина

Настройка Wi-Fi зоны

Установка мобильного приложения

Настройка ограничений доступа персонала и противокражи устройств

Обновление и сопровождение

Обновление плагина

Обновление мобильного приложения

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

Номенклатура лицензий iikoWaiter Pro

Запрос и активация лицензии

Проверка параметров лицензии

FAQ

Сообщение “Нет связи” на мобильном устройстве

Не стартует плагин

Периодически пропадает связь на айподах

Чек лист по настройке оплаты заказов с iikoWaiter

Общие сведения

iikoWaiter Pro – это вторая мажорная версия мобильного приложения для официантов, ранее известного как iikoMobileFront.

Совместимость

Требования к совместимости по версиям ПО и моделям оборудования.

Версия iiko

3.3.2 и выше

Версия iOS

6.1.3 и выше

iOS 8 - протестировано!

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

* в порядке увеличения размеров экрана

iPod Touch 4 (3,5”)

iPhone 4 / 4s (3,5”)

iPod Touch 5 (4”) - Рекомендуемая модель

iPhone 5 / 5c / 5s (4”)

iPhone 6 (4,7”) - ожидается тестирование

iPhone 6 Plus (5,5”) - ожидается тестирование

iPad Mini / Mini 2 (7,9”)

iPad Mini 3 - ожидается тестирование

iPad 2 / 3 / 4 / Air (9,7”)

iPad Air 2 - ожидается тестирование

Размер накопительной памяти устройства не имеет значения для производительности.

Требования к Wi-Fi и настройкам сети

Для стабильной работы решения требуется закрытая (не гостевая!) Wi-Fi зона с устойчивым покрытием радиосигнала на всей территории торговых залов.

Терминал ГК должен иметь постоянный (не динамический) IP-адрес.

Архитектура решения

Архитектурно программный продукт iikoWaiter Pro разделен на следующие программные модули:

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

iikoFront <API Front> iikoWaiter.dll <http 8100> iikoWaiter Pro

Плагин обеспечивает взаимодействие с основным фронтом посредством фронтового API iiko.

Служба ims.exe, использовавшаяся в предыдущей версии iikoMobileFront, больше не нужна.

К оглавлению

Установка и настройка

Настройки iiko

Убедитесь, что установленная версия iiko, соответствует минимальным требованиям  совместимости.

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

Для корректной работы с курсами необходимо в iikoOffice в разделе “Настройка торгового предприятия” для отделений с наличием столов (торговых залов) проставить галочки “Показывать панель курсов” и “Разрешать текстовые комментарии к позициям заказа”.

При отсутствии у отделений галочек введенная в заказ информация о Курсах и Комментариях не будет сохраняться с мобильных терминалов.

Настройка главной кассы

Для корректной работы iikoWaiter Pro рекомендуется включить галочку «Главная касса» в настройках точек продаж в iikoOffice (даже если у вас используется только одна стационарная станция).

Настройка маршрутизации печати пречеков

Маршрутизация печати пречеков с устройств выполнятся согласно настройкам печати, заданным в iikoOffice. Для того чтобы печать пречеков выполнялась на принтере, заданном в настройке для Отделения "Принтер пречеков", необходимо, чтобы была отключена жесткая привязка принтера к терминалу в разделе Мое торговое предприятие > Терминалы и устройства > Принтер пречека. В противном случае печать пречеков будет выполняться на принтере, привязанном к терминалу, а настройка "Принтер пречеков" для Отделения будет игнорироваться.

Настройка прав пользователей

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

Для возможности добавления и удаления оплат к заказу

PS_ADM - Проводить административные операции с платежными системами

D_DEP - Удалять внешние платежи

Для возможности оплачивать заказы

F_CASH - Принимать платежи

Для возможности проводить наличные оплаты (для учета задолженности официантов)

F_APIO - Авторизовывать кассовые внесения и изъятия

Настройка типов внесения/изъятия

Для возможности оплачивать и закрывать заказы непосредственно с мобильного терминала необходимо настроить типы внесения/изъятия.

Далее указать созданные типы на закладке “Настройки учета” в разделе администрирования настроек Торгового предприятия.

Установка плагина

Плагин устанавливается на терминал главной кассы (ГК).

Для корректной работы плагина на терминале ГК необходимо выполнить следующие общесистемные настройки:

  1. В брэндмауэре Windows открыть порт 8100
  2. Для Windows версий 7 и старше выполнить настройку резервирования пространства имен (http://msdn.microsoft.com/ru-ru/library/ms733768(v=vs.110).aspx).

для русской версии Windows:

netsh http add urlacl url=http://+:8100/ user=Все

для английской версии Windows:

netsh http add urlacl url=http://+:8100/ user=Everyone

Вариант сценария выполнения настройки:

  1. Нажмите Пуск
  2. В строке поиска наберите cmd
  3. При помощи правой клавиши кнопки мыши запустите cmd.exe от имени Администратора
  4. В окне командной строки наберите и выполнить команду, описанную выше.

Проверить список зарезеирвированных имен можно командой

netsh http show urlacl

 

Для установки на главную кассу скопируйте файл плагина iikoWaiter.dll в папки:

Плагин запускается автоматически при старте iikoFront.

Для проверки успешного запуска и работоспособности плагина выполните диагностический запрос в любом интернет-браузере на главной кассе http://localhost:8100 или в интернет браузере любого другого компьютера или мобильного устройства в локальной сети с указанием IP главной кассы. Например, http://192.168.0.11:8100.

В случае успешного запуска должна появится страничка следующего содержания

 

Факт успешного запуска плагина можно также проследить через лог-файл плагина

%appdata%\iiko\CashServer\Logs\plugin-iikoWaiter.log

О факте успешного запуска должна свидетельствовать строка

[2014-10-20 08:57:34,779]  INFO [ 9] [Plugin:Init] - iikoWaiter plugin started.

К оглавлению

Настройка Wi-Fi зоны

Закрытая Wi-Fi зона для работы iikoWaiter Pro должна быть в одной подсети с подсетью, в которой находится главная касса с iikoFront.

iPod’ы должны получать настройки сетевых адресов по DHCP. На сервере DHCP должен быть выделен диапазон динамически выдаваемых адресов.

Для проверки сетевых настроек непосредственно с мобильных устройств можно использовать бесплатное приложение Network Analyzer Lite. https://itunes.apple.com/ru/app/network-analyzer-lite-wifi/id562315041?mt=8

Для стабильной работы решения необходимо, чтобы индикатор уровня сигнала Wi-Fi на устройствах показывал все 3 деления на всей территории передвижения официантов. Опытным путем было установлено, что уже при двух делениях индикатора время задержки при передаче пакетов данных резко увеличивается и пакеты начинают теряться.

Установка мобильного приложения

Мобильное приложение устанавливается путем скачивания из Apple App Store. Для установки потребуется зарегистрированный Apple ID. Для регистрации Apple ID потребуется любой адрес электронной почты и пароль. Для целей распространения и сопровождения iikoWaiter Pro привязывать к Apple ID банковскую карту не требуется (в App Store приложение бесплатно). Для установки приложения на несколько устройств можно использовать один и тот же Apple ID. Рекомендуется зарегистрировать единый сервисный Apple ID на каждый отдельный ресторан и все работы производить с его использованием. При этом не рекомендуется использовать iCloud.

Не сообщайте реквизиты созданной Apple ID линейным сотрудникам ресторана! При необходимости можно сообщить реквизиты управляющему или системному администратору ресторана.

После установки iOS приложение по умолчанию запускается в демострационном режиме. При этом режим ввода ПИН-кода недоступен (это необходимо для удовлетворения требований ревьюеров Apple). Для подключения приложения к предварительно настроенной кассовой системе ресторана и переключения его в рабочий режим необходимо выполнить следующие действия:

  1. Нажать кнопку “Подключить”.
  2. В открывшемся окне в разделе “Сетевые настройки” ввести IP-адрес терминала ГК и нажать “Применить”.
  3. При удачном результате на экране должно появится окно ввода ПИН-кода.

Для изменения в дальнейшем настроенных реквизитов доступа к ГК, а также для настроек языка приложения и принтера печати пречеков необходимо зайти в раздел Домашний экран > Настройки > iikoWaiter Pro.

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

К оглавлению

Настройка ограничений доступа персонала и противокражи устройств

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

Для этого выполните настройку ограничений iOS при помощи следующих действий:

 

  1. Зайдите в Домашний экран > Настройки > Основные > Ограничения.
  2. Нажмите “Включить Ограничения” и задайте пароль.

    ВНИМАНИЕ! Используйте единый сервисный пароль для всех клиентов и сообщайте его руководящим сотрудникам ресторана только с случае крайней необходимости.
  3. Включите запрет на все пункты меню ограничений кроме пунктов:
  1. Установка програм. Необходимо для возможности самостоятельного обновления iikoWaiter Pro без выезда сервисного специалиста на объект. При этом установить любые новые приложения линейный персонал самостоятельно не сможет из-за незнания реквизитов Apple ID.
  2. AirDrop. Для возможности удаленного подключения и передачи скриншотов.
  3. В настройках службах геолокации разрешите использование и включите функцию “Найти iPod”. При этом сами изменения службы геолокации необходимо запретить. Это позволит использовать функцию поиска и блокировки утерянного или украденного устройства.
  4. Доступ к Bluetooth.
  5. Микрофон.
  6. Ограничение громкости.
  7. Настройки доступности разрешенного контента значения не имеют.  

К оглавлению

Обновление и сопровождение

Обновление плагина

Осуществляется простым копированием с заменой файла iikoWaiter.dll из дистрибутива сборки новой версии. iikoFront при этом должен быть остановлен.

Обновление мобильного приложения

Уведомление о наличии новых версий (любых установленных на устройство програм) отражается на иконке App Store.

Чтобы выполнить обновление, необходимо:

  1. Зайти в App Store, через соответствующую иконку на домашнем экране.
  2. Внутри App Store выбрать раздел “Обновления”.
  3. Найти в списке приложение iikoWaiter Pro.
  4. Проверить информацию в разделе “Что нового”.
  5. Нажать кнопку “Обновить”. Дождаться завершения обновления и проверить работоспособность новой версии приложения.

 

Для обновления уже установленного приложения авторизация Apple ID не требуется.

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

К оглавлению

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

Для версии iikoWaiter Pro проверка лицензий осуществляется непосредственно плагином. Средством активации лицензии является зашифрованный программный ключ активации iikowaiter.lic.

Правила работы лицензатора:

  1. Лицензирование является конкурентным и контролирует количество одновременных клиентских подключений.

    Количество необходимых для продажи лицензий iikoWaiter Pro рекомендуется рассчитывать исходя из максимально возможного количества официантов в одной смене, работающих с использованием мобильных блокнотов.

    Использование количества приобретенных лицензий меньше количества одновременно используемых устройств на практике будет приводить к постоянному возникновению сообщений о лицензионных ограничениях и мешать работе официантов!

  1. Лицензии при активации привязываются к оборудованию ГК ресторана и не могут быть использованы на другом оборудовании.

Номенклатура лицензий iikoWaiter Pro

Код лицензии

Наименование лицензии

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

Лицензии для продажи (боевые)

96011000

iikoWaiter Pro LifeTime

Бессрочная LifeTime лицензия

96011001

iikoWaiter Pro SaaS1M

Срочная SaaS на 1 месяц

96011002

iikoWaiter Pro SaaS3M

Срочная SaaS на 3 месяца

96011003

iikoWaiter Pro SaaS12М

Срочная SaaS на 12 месяцев

Лицензии не для продажи

96011008

iikoWaiter Pro Test

Тестовая полнофункциональная лицензия.

Срочная на 1 месяц.

Привязывается к Hardware ID.

Для полноценного тестирования на объектах потенциальных Клиентов.

96011009

iikoWaiter Pro Demo

Демонстрационная лицензия с функциональными ограничениями (на текущий момент полнофункциональная).

Для  демонстрационных, тестовых и обучающих целей.

Не привязывается к Hardware ID.

Срочная.

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

Запрос и активация лицензии

Для получения и активации лицензии необходимо выполнить следующие действия:

  1. После запуска плагина выполнить диагностический запрос типа http://192.168.0.11:8100, где 192.168.0.11 - IP-адрес ГК и с полученной по запросу страницы скопировать HWID.
  2. На странице http://arbus.biz/Produkty/iikoMobileFront/lickey заполнить форму на получение лицензионного ключа.

    Или о
    тправить по электронной почте запрос на почтовые адреса:
    - lic
    @arbus.biz
    -
    partners@iiko.ru

    с указанием следующих реквизитов:
    - Название ресторана: (торговая вывеска);
    - Адрес ресторана: Город, Улица, Дом;
    - Название группы станций (если в ресторане несколько ГК);
    - Hardware ID;
    - Номер и дату счета в ООО “Рестософтвер”;
    - Спецификацию заказа: Вид лицензии, Количество, Дата начала, Дата окончания;
    - Причина генерации ключа: новая продажа / продление / доп. продажа / замена оборудования.
  3. Полученный файл ключа переименовать строго в iikowaiter.lic и скопировать на ГК в папку %appdata%\Roaming\iiko\CashServer\PluginConfigs\iikoWaiter.
  4. Перезапустить фронт.

К оглавлению    

Проверка параметров лицензии

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

Пример, 

[2014-10-20 08:57:33,890]  INFO [ 9] [Plugin:LoadLicense] - ProductId: 96011000 FULL Connections: 10. Active from 25.07.2014 to 01.01.2100, blocked at: 25.10.2014 HWID: [48CC-A59D-FA90-0613-94FB-AB1D-8E49-DF5E]

[2014-10-20 08:57:33,892]  INFO [ 9] [Plugin:LoadLicense] - Found 10 available iikoWaiter connections.

Где

ProductId: 96011000 FULL // Вид лицензии

Connections: 10 // Количество подключений

Active from 25.07.2014 to 01.01.2100 // Необходимые сроки действия лицензии

blocked at: 25.10.2014 // Срок временного ограничения лицензии

HWID: [48CC-A59D-FA90-0613-94FB-AB1D-8E49-DF5E] // HWID, на который выдана лицензия

Если у Клиента приобретены LifeTime и SaaS лицензии, то последняя строчка показывает количество активных подключений на данный момент, действующих одновременно.

К оглавлению

FAQ

В данном разделе описаны типовые проблемы при настройке и использовании решения, способы их диагностики и устранения. Если ваша проблема выходит за рамки описанных ситуаций и требуется помощь разработчиков, то необходимо отправить запрос на e-mail support@arbus.biz с обязательным приложением файла лога плагина %appdata%\iiko\CashServer\Logs\plugin-iikowaiter.log и кратким описанием проблемы.

Сообщение “Нет связи” на мобильном устройстве

  1. Проверьте запущен ли фронт на ГК.
  2. Через браузер Safari на мобильном устройстве или через любой браузер на любом компьютере в подсети проверьте работу плагина при помощи диагностического запроса http://192.168.0.11:8100. Если не помогло:
  1. Откройте лог плагина %appdata%\iiko\CashServer\Logs\plugin-iikowaiter.log и проверьте успешно ли он стартовал. Если плагин не стартовал:
  1. Проверьте нет ли сообщений о лицензионных ограничениях.
  2. Проверьте не заблокирован ли плагин через свойства файла.
  3. Выполните настройку резервирования пространства имен для порта 8100 или попробуйте загрузить фронт от имени Администратора.
  1. Проверьте открыт ли порт 8100 в брэндмауере Windows.
  2. Проверьте ping с мобильного устройства до ГК при помощи приложения Net Analyzer Lite.

Не стартует плагин

В логе плагина сообщение следующего содержания:

для русскоязычной Windows

System.NotSupportedException: Предпринята попытка загрузить сборку из сетевого ресурса, что в предыдущих версиях .NET Framework могло привести к помещению сборки в "песочницу". Этот выпуск .NET Framework не включает политику CAS по умолчанию, поэтому данная загрузка может быть опасной. Если эта нагрузка не предназначена для изоляции сборки, включите переключатель loadFromRemoteSources. Дополнительные сведения см. на странице http://go.microsoft.com/fwlink/?LinkId=155569.

для англоязычной Windows

System.NotSupportedException: An attempt was made to load an assembly from a network location which would have caused the assembly to be sandboxed in previous versions of the .NET Framework. This release of the .NET Framework does not enable CAS policy by default, so this load may be dangerous. If this load is not intended to sandbox the assembly, please enable the loadFromRemoteSources switch. See http://go.microsoft.com/fwlink/?LinkId=155569 for more information.

Решение:

Открываем свойства dll-файла плагина и на вкладке “Общие” проверяем наличие следующего сообщения (см. картинку ниже). Нажимаем “Разблокировать” и “Применить”.

Внимание! После разблокирования нужно проверить результат повторным вызовом свойств и отсутствием предупреждающей надписи. Разблокировка может не сработать при отсутствии прав или если фронт запущен. Как вариант файл можно перенести в любую другую папку, разблокировать его там и вернуть обратно в Program Files.

К оглавлению

Периодически пропадает связь на айподах

Вопрос:

Очень неприятно, когда при клиентах начинает пропадать связь и возникают трудности с сохранением заказа.

Подскажите в чем может быть дело.

Решение:

Причины могут быть следующие:

1. Плагин работает нестабильно и отвечает не всегда. Для анализа причины нужны логи плагина. Брать здесь: %appdata%\iiko\CashServer\Logs\plugin-iikoWaiter.log.

2. Проблема с сетью. Более вероятная.

Для анализа работы беспроводной сети рекомендую воспользоваться бесплатным приложением для Android:

https://play.google.com/store/apps/details?id=com.farproc.wifi.analyzer&hl=ru

Для нормальной работы уровень сигнала на всей территории покрытия не должен быть ниже -70. Оптимально -60 и выше.

Измерения желательно проводить какой-нибудь боле менее современной моделью Android оборудования известных производителей.

         

Также можно посмотреть скорость ответов по пингам непосрдественно с айподов через

Network Analyzer Lite. https://itunes.apple.com/ru/app/network-analyzer-lite-wifi/id562315041?mt=8

Нормально если задержки идут стабильно на уровне 30 милисекунд в разных точках помещения в разное время по нагруженности сети.

Опять же нужно понимать какое wi-fi оборудование вы используете (производитель, модель), какой размер помещения, какой уровень зашумленности эфира, сколько пользователей максимально сидит на одной точке.

Если есть возможность, то можно на время поменять точки доступа на ubiquity или mikrotik и посмотреть на резельтат. Или вообще перейти на частоту в 5ГГц.

Чек лист по настройке оплаты заказов с iikoWaiter

Оплата поддерживается только для конфигураций без разделения на 2 ФР.

Для настройки функции оплаты необходимо:

- Обновить само приложение из App Store до версии 2.3.2 (или поставить с нуля).

- Обновить плагин iikoWaiter.dll до 2.3.5.

- Минимально необходимая версия iiko 3.7. Мы тестировали начиная с 3.8.5 - все хорошо.

- Перегенерировать и активировать в iikoOffice ключ лицензии iiko, убедившись, что туда добавился модуль iikoWaiterPayment Front.

- Настроить типы внесения/изъятия.

- Настроить права соотвествующих пользователей.

- Включить в настройках iikoWaiter Pro опцию “ORDER PAYMENTS”.

Если вы все сделали правильно, то в списке открытых заказов справа от поля суммы заказа станет доступна кнопка с кошельком.

С точки зрения контроля и учета кассовой дисциплины внешние наличные платежи через iikoWaiter будут попадать на подотчет официантам, закрывшим заказы.