Внимание! Данный функционал реализован для версий GK 4.16 и более поздних.
1. Установка SH5_WebAPI
Для установки необходимо скачать дистрибутив SH5_WebAPI с официального FTP компании UCS:
Установку рекомендуется производить там же, где и установлена серверная часть SH5.
Распаковываем архив и запускаем Setup.SH5_WebAPI_II.v1.10.exe, выбираем язык установки:
Принимаем условия лицензионного соглашения:
Выставляем параметры подключения к серверу SH5:
Нажимаем кнопку «Установить»:
Далее «Завершить»:
После установки автоматически запустится утилита теста API, она нам не понадобится, можно просто закрыть.
Также после установки необходимо проверить в службах Windows запущена ли служба SH5_WebAPI, если не запущена, то запустить.
2. Состав дистрибутива
Папка с WEB-сервером A-editor находится в основном дистрибутиве версии GK в папке WEB.
3. Настройка подключения WEB-сервиса A-editor
Настройка заключается в конфигурировании файла appsettings.json.
Содержимое файла:
{
"ConnectionStrings": { // Подключение к MSSQL Server
"DefaultConnection": "Server=GKSERVER;Database=gkArcade;MultipleActiveResultSets=true;User=sa;Password=1q2w3e777!"
}, - строка подключения к БД gkArcade
"SHouseImportSettings": { // Экспорт в Store House 5
"Address": "127.0.0.1:9797", // - Адрес WebApi Store House 5 – адрес и порт, где крутится служба SH5_WebAPI
"User": "Admin", // Логин – пользователь из SH5
"Password": "", // Пароль – пароль пользователя из SH5
//"SUnitName": "Место", // Место реализации раскомментировать и задать, если в SH 5 больше одного места реализации
"MenuRoot": 2 // Код товарной группы, куда производить экспорт товаров и услуг – смотреть в самом SH5
},
"JWT": {
"Issuer": "GkMServer",
"Audience": "GkEditor",
"ExpiresAccessToken": "10",
"Key": "vve1&&z{{]f`gHllllLff"
},
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft": "Information",
"Microsoft.Hosting.Lifetime": "Information"
}
},
"AllowedHosts": "*"
}
Корневую вершину Game-Keeper в SH5 создаем самостоятельно (новую или переименовываем вершину Меню ресторана).
Параметр "MenuRoot": 2.
4. Установка платформы .Net Core
Устанавливать стоит всегда актуальную версию с сайта разработчика Microsoft.com
Возможно, что на объекте уже установлены эти компоненты, например для работы отчетов SSRS или других web-сервисов GK, тогда установка не требуется.
5. Установка и настройка Microsoft Web Server IIS
Установка и настройка Microsoft Web Server IIS
Возможно, что на объекте уже установлены эти компоненты для работы web-сервисов GK, тогда установка не требуется.
В главном окне Диспетчера IIS выбираем элемент дерева «сайты», правой клавишей мыши – Добавить веб-сайт.
Вводим имя сайта, в нашем случае это A-editor, указываем физический путь к папке A-editor, задаем порт для веб-сервиса и нажимаем кнопку «ОК». При вводе имени сайта автоматически будет создан пул приложений для этого сайта с одноименным названием, необходимо в Диспетчере служб IIS перейти в меню дерева «Пулы приложений» и проверить, что пул создался с версией среды CLR.NET v4.0. Также в Дополнительных параметрах пула приложений необходимо включить параметр «Разрешены 32-разрядные приложения».
6. Проверка работоспособности технологии
Для работы с A-editor рекомендуется использовать браузер Google Chrome. В браузере вводим адрес http://127.0.0.1:8089/ (8089 – порт WEB-сервиса A-editor).
В открывшемся окне необходимо ввести Пользователя GK и его пароль, после чего попадаем в рабочее пространство программы (выгрузка из GK в SH5 находится на вкладке Экспорт в SHouse).
Вынести ярлык-ссылку на страницу в папку GK на рабочем столе, назвать ярлык A-Editor.
