Схема взаимодействия
Внешняя система посылает запрос согласно протоколу обмена на WEB-сервер IIS webMon2. WEB-сервер обрабатывает запрос и самостоятельно обращается в базу данных, осуществляя чтение или изменение данных. Полученная информация передается обратно внешней системе. Обращение к кассовому серверу используется для служебных нужд.
Состав дистрибутива.
Папка с WEB-сервером webMon2 находится в основном дистрибутиве версии GK в папке ..\GK\gkAPI\api.int\ webMon2\.
Начиная с версии 418 вспомогательный gkExtServer больше не используется!
Для удобства дальнейшей настройки и навигации необходимо скопировать webMon2 в папку WEB в корне папки GK.
Настройка подключения web-сервиса webMon2
Настройка заключается в конфигурировании файла appsettings.json.
Содержимое файла appsettings.json:
Установка платформы .Net Core
Для работы gkApi и сервиса webMon2 с версии GK 418 необходимо установить Net Core 5-го поколения!
Установка и настройка Microsoft Web Server IIS
Установка и настройка Microsoft Web Server IIS
В главном окне Диспетчера IIS выбираем элемент дерева «сайты», правой клавишей мыши – Добавить веб-сайт.
{
"Logging": {
"LogLevel": {
"Default": "Warning"
}
},
"AllowedHosts": "*",
"GKPosServer": {
//"useExtServer": true,
"Url": https://127.0.0.1:50301 – ip-адрес, где запущен gkPosServer, 50301 – PortH из gkPosServer.ini
},
"ConnectionStrings": {
"GKDB": "Data Source=127.0.0.1;Initial Catalog=gkArcade;Persist Security Info=True;User ID=sa;Password= 1q2w3e777! " – строка подключения к БД gkArcade.
}
}
Вводим имя сайта, в нашем случае это WebMon2, указываем физический путь к папке WebMon2, задаем порт для веб-сервиса и нажимаем кнопку «ОК». При вводе имени сайта автоматически будет создан пул приложений для этого сайта с одноименным названием, необходимо в Диспетчере служб IIS перейти в меню дерева «Пулы приложений» и проверить, что пул создался с версией среды CLR.NET v4.0. Также в Дополнительных параметрах пула приложений необходимо включить параметр «Разрешены 32-разрядные приложения».
Настройки в файле default.html
| darkMode: (тема страницы) | false - светлая тема. | true - тёмная тема. | Х |
|---|---|---|---|
| logoClient: (логотип клиента) | false - установлен логотип GK. | true - установлен логотип клиента | Х |
| reportTitle: | – заголовок страницы. По умолчанию 'Монитор тарификаций'. | ||
| fontSizeTitle: | – размер шрифта для заголовка страницы. | ||
| fontSizeNumbGuest: | – размер шрифта для количества гостей (рекомендуем задавать размер как в заголовке). | ||
| maxTableRows: | – максимальное кол-во строк в таблице отчёта для посетителей. Если данных больше, чем максимальное кол-во строк, то будет пролистывание страниц по таймауту (refreshPages). | ||
| fontSizeTable: | – размер шрифта в таблице. | ||
| changeColorMiddleTime: (время в минутах для изменения цвета заливки оставшегося времени) | 0 – не использовать | Параметр >0 – цвет ячейки в таблице с оставшимся временем изменится с зеленого на желтый, если времени до окончания пребывания осталось меньше, чем указано. | Х |
| zoneFilter: (id зоны для отображения на экране) | 0 – все зоны | Для вывода на экран тарификаций только одной из зон необходимо указать соответствующий id, который был присвоен в Редакторе. Позволяет настроить свой экран для каждой зоны. | Х |
| forStaff: (тип отчёта) | false – для посетителей. | true – для сотрудников. | Х |
| refreshPages: (таймаут после которого будет выполнено обновление данных на странице) | – время в секундах, задается для пролистывания страниц и обновления данных из БД GK | ||
| showRefreshAnimation: (отображать анимацию до следующего обновления данных на странице) | 0 - никогда | 1 - только для посетителей для пролистывания страниц | 2 - всегда отображать (для пролистывания страниц и для обновления данных из БД ГК) |
showCopyright: | false – не отображает Copyright в отчёте для посетителей. | true – отображает Copyright в отчёте для посетителей. | Х |
Описание столбцов. | |||
| header: | – наименование столбца. | ||
| cssClass: | – значение "Внешний вид" регулируется в /style/style.css | ||
| Видимость столбца (зависит от enabled и forStaff) | |||
| enabled: | false – не отображается ни в отчёте для посетителей, ни в отчёте для сотрудников (например, когда содержимое столбца никак не используется в бизнес-процессе). | true – столбец отображается и в отчёте для посетителей, и в отчёте для сотрудников (только при forStaffOnly:false (см. ниже)) | Х |
| forStaffOnly: | false – столбец отображается в любом отчёте. | true – столбец отображается только в отчёте для сотрудников. | Х |
| Изменить расположение столбцов в таблице | – для этого достаточно поменять местами наборы данных в теле. Последовательность столбцов в таблице столбцов=последовательность наборов в теле. При перемещении наборов данных важно соблюдать структуру тела. | ||
Проверка работоспособности технологии
Вводим в браузере http://localhost:8083/default.html и попадаем в рабочее окно WEB мониторинга. Пример одного из шаблонов приведен на рисунке ниже.
Подробнее про отчёты можно прочитать в статье Web-мониторинг тарифных зон.
Пример отчёта для сотрудников.