Для запуска сервера отчетности необходимо выполнение следующих условий:
Для запуска докер-образа сервера отчетности необходимо задать следующие переменные
DB_EXIST | true/false - подключение к новой или существующей БД |
DB_TYPE | тип БД: postgres / mysql |
DB_HOST | имя или адрес хоста БД |
DB_PORT | порт СУБД |
DB_USER | пользователь БД default postgres |
DB_PASSWORD | пароль пользователя к БД default postgres |
DB_NAME | имя БД (БД должна быть предварительно создана) |
SMTP_HOST | почтовый хост для отсылки отчетов и уведомлений |
SMTP_USERNAME | пользователь для подключения к почтовому серверу |
SMTP_PASSWORD | пароль пользователя |
SMTP_PROTOCOL | протокол default smtp |
SMTP_PORT | порт почтовой отправки default 25 |
SMTP_FROM | адрес от имени которого будут приходить письма default example@domain.com |
CROSS_BUCKET | ? |
TIMEOUT_SESSION | ? |
Пуск докер сервера осуществляется следующим образом:
docker login registry.infsys.ru
docker pull registry.infsys.ru/iss/jasperserver71:2.0
docker run -d --name jasperserver --restart=always --env-file env.list -p 8989:8080 registry.infsys.ru/iss/jasperserver71:2.0
Файл env.list
содержит все необходимые переменные
DB_EXIST=false
DB_NAME=jasperserver
DB_TYPE=postgresql
DB_HOST=10.3.2.203
DB_PORT=5432
DB_USER=postgres
DB_PASSWORD=postgres
SMTP_HOST=mail.example.ru
SMTP_USERNAME=support@example.ru
SMTP_PASSWORD=password
SMTP_PROTOCOL=smtp
SMTP_PORT=25
SMTP_FROM=support@example.ru
CROSS_BUCKET=600000
TIMEOUT_SESSION=0
Если в файле
env.list
указаноDB_EXIST=false
- контейнер самостоятельно создаст базу данных для сервера отчетности.
URL: http://localhost:8989/jasperserver
Лгогин: jasperadmin
Пароль: jasperadmin
helm repo add sem-next http://registry.infsys.ru/stable/
helm repo update
helm install <имя инстанса> [-f <имя файла yaml >] sem-next/jasper -n <имя namespace>
, где
Пример:
helm install report sem-next/jasper -n inspark
При изменении начальных значений необхдимо провести upgrade инстанса:
helm upgrade <имя инстанса> [-f <имя файла yaml >] sem-next/jasper -n <имя namespace>
Удаление инстанса выполняется командой:
helm uninstall <имя инстанса> -n <имя namespace>
<SSOToken description="Создание SSO токена semona для доверительной авторизации пользователей semona
в своих системах">
<enabled description="Если true - токен sso создается">
true
</enabled>
location /jasperserver {
proxy_pass http://localhost:8989;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real_IP $remote_addr;
}
underscores_in_headers on;
Manage-Server Settings – Server Attributes
создать атрибуты (для подключения к postgresql сервера платформы):Manage-Server Settings - Import
*в работе *
Зайти в веб-консоль управления JasperServer, администратором сервера отчетов jasperadmin, перейдя по адресу:
http://HOSTNAME/jasperserver
Для удобства рекомендуется заранее создать папку в которой будут хранится уже сформированные отчеты для рассылки. Для этого делаем правый клик на папке с отчетами и «Добавить папку»
Задать имя папки, например «Рассылка»
Выбрать интересующий отчет. Отчеты, позволяющие задавать смещение от даты запуска (для гибкого определения той даты, на которую будет строится выбранный отчет), находятся в папке Admin. К данной папке доступ есть только у jasperadmin. Необходимо выполнять настройку запуска имеющихся в ней отчетов по расписанию под этим логином.
Правым кликом переходим в раздел расписание
Создать расписание
Определить дату и время рассылки отчета
В поле «Рецидив: Тип повторения: Календарь» или «Простой» (вместо «ни какой»)для выбрать интересующей частоты рассылки по дням, месяцам и времени
Перейти на вкладку «Параметры»
Задать «Задание параметров пользователем?» - в значение false, «Название компании для отчетов по расписанию» установить имя компании для которой создается расписание, «Рубрика для расписания» или «Объект для расписания» - установить параметр из списка с учетом того, что система при установке параметров в данном поле не контролирует принадлежность объекта или рубрики к компании (если установить параметр не пренадлежайщий компании отчет будет пустым), «Смещение от текущей даты». В поле «Смещение от текущей даты» необходимо определить дату, на которую будет строится выбранный отчет (указанная дата в отчет не включается). Вместо конкретной даты нужно указать смещение от текущей даты (в случае запуска по расписанию - текущая дата будет установленное время запуска отчета по расписанию) в виде DAY-N, WEEK-N, MONTH-N, QUARTER-N, SEMI-N, YEAR-N -N (где - это смещение назад, + смещение вперед, N количество периодов на которое необходимо сместить период отчета, например DAY-1, окончание периода отчета вчера), также должны быть заданы специальные параметры отчета например «Потребление» и «Число расчетного периода», их задание аналогична параметризации отчета пользователем в ручном режиме.
Например, 15.09.2020 формируется отчет. В поле «Смещение от текущей даты» введено DAY-15. В итоге будет построен отчет за август (с 1 по 31 августа, 2020г.)
Интеграция обеспечивает SSO между Inspark IoT и Superset по протоколу OAuth.
Полное описание интеграции представлено в разделе Настройка аналитического модуля.