1. Откройте основной дистрибутив подходящей версии, пример ..\GK\ReportSystem.

2. Найдите папку ReportSystem в комплекте поставки и скопируйте её на сервер объекта.

2.1 Для работы киоска требуется установить dotnet 5.0.

По ссылке: https://dotnet.microsoft.com/en-us/download/dotnet/5.0 скачайте и установите версию dotnet 5.0 соответствующей разрядности Windows. После скачивания запустите и разрешите доступ.

3. В папке ReportSystem откройте для редактирования файл appsettings.json в блокноте (см. Рис. 1). Пропишите следующие параметры:

  • "DataDB" - строка подключения к базе данных Game-Keeper.
  • "ReportDB" - строка подключения к базе данных отчётов (предварительная настройка, БД создаётся при первом запуске).


Рис.1 Файл appsettings.json

4. Для настройки путей к dll файлам в файле ReportSystem.runtimeconfig.dev укажите путь к папке lib из комплекта поставки (см. Рис. 2).


Рис. 2 файл ReportSystem.runtimeconfig.dev

5. Создайте службу отчётов, запустив файл createReportSystemService.bat (см. Рис. 3).

  1. Убедитесь, что в файле createReportSystemService.bat в строке set BinPath=  указан правильный путь к файлу ReportSystem.exe. Если необходимо, внесите соответствующие изменения и сохраните файл.
  2. Запустите файл createReportSystemService.bat от имени администратора.
  3. В окне служб Windows появится новая служба с названием  Game-Keeper ReportSystem. Запустите эту службу (см. Рис. 4).
  4. В SQL появится база данных webReportsNew.


Рис. 3 Файл createReportSystemService.bat


Рис. 4 службы Windows

6. Создайте ярлык для быстрого доступа к отчётам.

  1. Откройте файл appsettings.json и найдите строку "Urls": "http://:5200".
  2. Скопируйте указанный URL, заменив * на 127.0.0.1 или localhost. Например, "Urls": "http://127.0.0.1:5200" или "Urls": "http://localhost:5200". 
  3. Создайте ярлык на рабочем столе или в нужной папке, в поле "Адрес" вставьте скопированный URL.

7. Запустите отчёты в браузере. Введите свой логин и пароль с соответствующими правами доступа (Управление пользователями/Права/WEB-report GK (ReportSystem)/Администратор Web-отчётов (ReportSystem) и Вход в Web-отчётов (ReportSystem)). 

8. На стартовой странице со списком отчётов, в правом верхнем углу, есть выпадающий список "Администратор", нажмите на него и установите чекбокс напротив строки "Показывать настройки" (см. Рис. 5).


Рис. 5 Страница Список отчётов

9. В левом верхнем углу, рядом с кнопкой "Список отчётов", появится кнопка "Настройки", нажмите её (см. Рис. 6).

10. Откройте вкладку "Шаблоны отчетов" (см. Рис. 5).

11. Нажмите на кнопку "Обновить отчёты" и подгрузите файл reports_all.json из сборки (см. Рис. 6, Рис. 7). Нажмите на кнопку "Список отчётов" и обновите страницу. На странице должен появиться список всех доступных отчётов (см. Рис. 5).

* На вкладке Настройки->Шаблоны новая кнопка "Отчеты -> в права доступа"
При нажатии на эту кнопку отчеты добавляются в UserManager в узел "WEB-report GK (ReportSystem)" (как и при загрузки программы)

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


Рис. 6 Страница Настройки отчётов


Рис. 7

Настройка прав доступа.

После запуска ReportSystem в базе gkArcade, на которую настроен ReportSystem, происходят следующие изменения, которые отражаются в UserManager.exe

1. Добавляется группа прав "WEB-report GK (ReportSystem)"

2. В неё добавляются подгруппы прав, названия которых совпадают с названиями групп отчетов в ReportSystem

3. В подгруппы добавляются права, названия которых совпадают с названиями отчетов в ReportSystem
Таким образом Иерархическая структура в UserManager в узле "WEB-report GK (ReportSystem)" повторяет иерархическую структуру отчетов в ReportSystem

4. Кроме вышеперечисленного, в группу прав "WEB-report GK (ReportSystem)" добавляются права управления доступом к системе ReportSystem в целом:

  • Право "Администратор WEB-отчетов (ReportSystem)"
  • Право "Вход в WEB-отчеты (ReportSystem)"

Как все это работает.

1. Чтобы залогинится и войти в систему отчетов ReportSystem у пользователя должно быть право

1.1 "Вход в WEB-отчеты (ReportSystem)" (см. п. 4.2)

или

1.2. "WEB-отчеты" > "Вход в программу" . Сделано для совместимости с предыдущими версиями

2. Администратор ReportSystem имеет право создавать и модифицировать отчёты, а также имеет доступ ко всем отчетам, независимо от прав доступа в конкретному отчёту.
Чтобы быть администратором системы отчётов ReportSystem у пользователя должно быть право

2.1 "Администратор WEB-отчетов (ReportSystem)" (см. п. 4.1)

или

2.2. "WEB-отчеты" > "Основные" > "Создать отчеты" . Сделано для совместимости с предыдущими версиями

3. Залогинившийся пользователь видит список отчетов в соответствии со следующими правилами

3.1. Доступ к отдельным отчетам ограничивается, если в системе включен параметр "Контролировать доступ к отчетам в зависимости от прав и ролей".

Это параметр "CheckUserRightsForReportRun" в файле appsettings.json

По умолчанию "CheckUserRightsForReportRun": false - НЕ контролируется

3.2. Если включен п.3.1 , то пользователи имеют доступ (видят) только те отчеты, доступ к которым им дан в программе "Управление пользователями"

3.3. Администратор отчетов ReportSystem имеет доступ ко всем отчетам, независимо от прав доступа в конкретному отчёту

  • Нет меток