Описание
Приложение iikoArrivals позволяет автоматизировать электронную очередь в заведениях общепита. Оно представляет собой электронное табло, на котором посетитель вашего заведения сможет увидеть статус своего заказа и время его готовности.
Автоматизация электронной очереди с iikoArrivals выглядит следующим образом:
- Клиент делает заказ и получает чек с его номером.
|
Чтобы номер заказа клиента печатался на чеке крупным шрифтом, необходимо выбрать соответствующий шаблон из Галереи шаблонов чеков. Подробнее читайте в статье руководства классического офисного приложения Галерея шаблонов. |
- Заказ передается на кухню и на табло отображается его номер.
-
После приготовления на кухне отмечают, что заказ готов, и статус заказа на табло меняется.
-
Гость видит на экране информацию о готовности заказа и забирает его.
-
Менеджер отмечает, что заказ подан, и он перестает отображаться на табло.
На экране может быть доступна, например, следующая информация о заказе: номер, статус, время получения заказа, время ожидания, имя клиента, его телефон.
Приложение представляет собой веб-страницу, из которой вы можете перейти к определенному шаблону электронного табло. Шаблон определяет внешний вид экрана: расположение информации на странице и цветовую схему. Основные настройки приложения выполняются в специальном конфигурационном файле.
Минимальные требования
Перед установкой и использованием iikoArrivals убедитесь в следующем:
-
Установлена система iiko версии 4.3.2 и выше.
-
В составе системы iiko используется модуль «Кухонный экран» (KDS) или iikoDelivery. Использование iikoArrivals возможно только при наличии хотя бы одного из этих модулей.
-
Установлен Net. Framework версии 4.5 и выше (работа с Windows XP и POS Ready 2009 не поддерживается).
Устройства, на которых будет запускаться iikoArrivals и терминалы с iikoFront должны находиться в одной сети.
Установка и запуск приложения
Чтобы установить приложение iikoArrivals:
-
В iikoOffice проверьте, установлена ли лицензии на модуль iikoArrivals_v3 (Web FrontApi). Приложение лицензируется по количеству подключений, т. е. по числу запущенных браузеров.
-
Скачайте iikoArrivals и скопируйте в любой удобный каталог.
Найти iikoArrivals можно на партнерском ftp-сервере в папке последней версии iiko: <версия iiko>\Plugins\External.
-
Установите плагин Resto.Front.Api.WebServer для iikoFront. Для этого скопируйте папку плагина в каталог C:\Program Files\iiko\iikoRMS\Front.Net\Plugins.
- Настройте iikoArrivals для подключения к WebApi сервиса iiko в конфигурационном файле config.json, который расположен в каталоге приложения iikoArrivals.
- Чтобы открыть iikoArrivals, запустите файл mongoose-windows.exe из каталога с приложением. Откроется стартовая страница iikoArrivals в браузере, с которой вы можете перейти к конкретному шаблону.
Настройка приложения
Основные настройки iikoArrivals расположены в файле config.json, который расположен в каталоге с приложением.
В таблице ниже привеждено описание используемых параметров. См. также файл documentation.json.
Параметр
|
Описание
|
Значение по умолчанию
|
webServiceUrl
|
Адрес WebApi сервиса
|
http://localhost:9042
|
deliveryScheme
|
Схема работы с доставочным заказом. Параметр определяет, какие статусы будет проверять приложение. Вы можете указать:
-
Delivery, тогда будут использоваться статусы доставки.
-
KDS, в этом случае будут использоваться статусы кухонного экрана.
|
Delivery
|
orderType
|
Типы заказов, которые будут отображаться в iikoArrivals. Возможные значения:
-
Ordinary – обычный заказ.
-
Pickup – доставка самовывоз.
-
Courier – доставка курьером.
|
Ordinary, Pickup, Courier
|
orderTypeNames
| Названия типов заказов, которые будут отображаться в iikoArrivals. Хранятся в iikoOffice - Розничные продажи - Типы заказов
|
|
showOrderWithTab | Параметр работает при использовании Табов Если true и заказа заполнен Таб, то заказ не будет отображаться на экране
Если false, то боудут отображаться все заказы с заполнеными и пустыми Табами
| false
|
showStatus
|
Статус заказа, при котором начинает отображаться на экране. Указывается id статуса в KDS.
|
0
|
completeStatus
| Статус заказа, при котором он помечается как готовый. Указывается id статуса в KDS.
|
6
|
hideStatus
| Статус заказа, при котором он прекращает отображаться на экране. Указывается id статуса в KDS. |
5
|
inProgressStatusName
|
Формат отображения статуса, когда заказ еще находится на приготовлении. Включает в себя два параметра: type и format.
|
|
type
|
Тип формата вывода статуса. Возможны следующие значения:
-
ServeTime – Время получения заказа.
-
CookingTime – Время готовки.
-
RemainingTime – Время ожидания.
-
DeliverTime – Время доставки.
-
SpecialText – Стандартное слово.
|
ServeTime
|
format
|
Формат вывода статуса. Зависит от типа формата (параметр type). Например, для типов с выводом времени используйте [HH:mm], а для типа со стандартным словом (SpecialText) – укажите это слово.
|
HH:mm
|
completeStatusName
|
Слово, отображаемое когда заказ готов.
|
«Готов»
|
orderNumberLength
|
Количество символов в номере заказа.
|
2
|
leadOrderNumberSymbol
|
Символ, который дописывается в начало номера заказа, если количество символов в номере меньше, чем orderNumberLength.
|
0
|
ordersRefreshTimeout
|
Промежуток времени в секундах, через который табло периодически обновляется.
|
15
|
imageChangeTimeout
|
Промежуток времени в секундах, через который меняются изображения на табло.
|
30
|
notResponseTimeout
|
Время ожидания ответа кассы в секундах.
|
30
|
splashChangeTimeout
|
Промежуток времени в секундах, через который меняются всплывающие окна с готовыми заказами.
|
4
|
splashShowTimeout
|
Время отображения всплывающего окна с готовым заказом в секундах.
|
3
|
completeStatusImage
|
Изображение готового заказа. Если задан файл, то выводится указанное изображение. Если оставить значение пустым, то подставляется значение из настройки completeStatusName.
|
complete.png
|
notResponseImage
|
Изображение с ошибкой ответа кассы.
|
error.png
|
licenseLimitImage
|
Изображение с ошибкой количества лицензий.
|
license-error.png
|
logoImage
|
Изображение с логотипом.
|
logo.png
|
backgroundImage
|
Фоновое изображение.
|
Значение пустое
|
orderCompleteSound
|
Звук, который проигрывается, когда заказ отмечается приготовленным. Укажите файл в формате .mp3.
|
sound.mp3
|
showTables
| Номера столов, заказы которых отображаются на экране. Несколько столов перечислите через запятую. Пустая строка - показывать все столы.
|
|
hideTables
| Номера столов, заказы которых не отображаются на экране. Несколько столов перечислите через запятую. Пустая строка - показывать все столы.
|
|
showOrderSources
| Список источников заказов, которые отображаются на экране. Несколько источников перечислите через запятую. Пустая строка - показывать все источник. |
|
hideOrderSources
| Список источников заказов, которые не отображаются на экране. Несколько источников перечислите через запятую. Пустая строка - показывать все источник |
|
logConsole
| Если true - выводит в консоль логи приложения. Нужно для определения места ошибки. Поскольку консоль потребляет память, раз в 5 минут происходит её очистка. | false
|
showKitchenOrderFromTerminalGroup
| Показывать заказы из другой группы. В случае значения true - может некорректно работать отображение и фильтрация полей ExternalNumber и OriginName
| false
|
useOrderStatus
| false - приложение использует статусы приготовления блюд true - используются виртуальный статус, который проставляется и меняется только специальным плагином-балансировщиком. | false
|
showOrderStatus
| Статус заказа, при котором начинает отображаться на экране в обсласти "Готовится" Используется при useOrderStatus: true | 0
|
completeOrderStatus
| Статус заказа, при котором начинает отображаться на экране в обсласти "Готов" Используется при useOrderStatus: true |
|
hideOrderStatus
| Статус заказа, при котором он прекращает отображаться на экране Используется при useOrderStatus: true |
|
cookingColumnSortType
| Параметр определяющий способ сортировки заказов в области "Готовится" Возможные варианты: 0 - по номеру заказа 1 - сортировать заказы по времени перехода в статус для отображения в этой зоне по возрастанию ("новый" заказ отображается в конце списка) 2 - сортировать заказы по времени перехода в статус для отображения в этой зоне по убыванию (("новый" заказ отображается в начале списка) | 0
|
completedColumnSortType
| Параметр определяющий способ сортировки заказов в области "Готов" Возможные варианты: 0 - по номеру заказа 1 - сортировать заказы по времени перехода в статус для отображения в этой зоне по возрастанию ("новый" заказ отображается в конце списка) 2 - сортировать заказы по времени перехода в статус для отображения в этой зоне по убыванию (("новый" заказ отображается в начале списка)
| 0 |
|
При настройке параметров showTables и hideTables во всех отделениях номера столов должны быть уникальные, т.к. ikoArrivals не может определить, из какого отделения поступил заказ. Например, если в Зале и в Баре есть столы с номером 101, то ни один заказ с этих столов не отобразится на экране. |
Коды (id) статусов заказов, которые используются в настройке:
- 0 — Ожидает.
- 1 — Пора готовить.
- 2 — Готовится.
- 3 — Готовится2.
- 4 — Готовится3.
- 5 — Готовится4.
- 6 — Приготовлено.
- 7 — Подано.
- 8 — Удалено.
Все изображения, которые используются в конфигурационном файле iikoArrivals, находятся в папке content. Здесь располагаются логотипы, фоновое изображения, звук и прочие файлы, которые могут использоваться не зависимо от шаблона. Не используйте внешние источники файлов, они не поддерживаются.
В каталоге content\images расположены рекламные изображения, которые сменяют друг друга на табло. Не размещайте здесь другие изображения, например, логотип, фоновый рисунок и т. д.
В каталоге content\images-fullscreen расположены изображения, которые сменяют друг друга и отображаются на весь экран при отсутствии заказов.
Для упорядочивания файлов внутри каталога content вы можете создать другие папки с изображениями. Тогда в конфигурационном файле config.json указывайте директорию, в которой оно расположено. Например, в каталоге content вы создали подкаталог logo и разместили там файл logo.png. Тогда прописывая это изображение в любом из параметров, укажите "logo\logo.png".
Настройка шаблонов
В iikoArrivals прилагается несколько готовых шаблонов. Они располагаются в каталоге templates, каждый в своем подкаталоге, название которого совпадает с названием шаблона. Внутри этого каталога содержится:
-
Html-файл. В нем задается структура страницы, которая отображается на табло при выборе шаблона.
-
CSS-файл с описанием внешнего вида html-файла.
Вы можете использовать любой из готовых шаблонов, либо создать новый.
Чтобы создать новый, вы можете скопировать уже имеющийся каталог шаблона и переименовать его по своему усмотрению. Затем отредактируйте расположенные внутри каталога файлы в соответствии со своими корпоративными стандартами.