Описание
Приложение 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). Приложение лицензируется по количеству подключений, т. е. по числу запущенных браузеров.
-
Загрузите приложение по ссылке
ftp://iikoarrivals:wjpfei35@ftp.iiko.ru
и скопируйте в любой удобный каталог.
-
Установите плагин Resto.Front.Api.WebServer для iikoFront. Для этого скопируйте папку плагина в каталог C:\Program Files\iiko\iikoRMS\Front.Net\Plugins. Настройте iikoArrivals для подключения к WebApi сервиса iiko в конфигурационном файле config.json, который расположен в каталоге приложения iikoArrivals. Подробнее параметрах конфигурации см. в разделе Настройка приложения, стр. 5.
Чтобы открыть 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
|
|
showStatus
|
Статус заказа, при котором начинает отображаться на экране. Указывается id статуса в KDS.
|
0
|
|
completeStatus
|
Статус заказа, при котором он прекращает отображаться на экране. Указывается id статуса в KDS.
|
5
|
|
hideStatus
|
Статус заказа, при котором он помечается как готовый. Указывается id статуса в KDS.
|
6
|
|
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
| Номера столов, заказы которых не отображаются на экране. Несколько столов перечислите через запятую. Пустая строка - показывать все столы.
|
|
|
Внимание! При настройке параметров 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-файла.
Вы можете использовать любой из готовых шаблонов, либо создать новый.
Чтобы создать новый, вы можете скопировать уже имеющийся каталог шаблона и переименовать его по своему усмотрению. Затем отредактируйте расположенные внутри каталога файлы в соответствии со своими корпоративными стандартами.