Версия от 10:31, 2 сентября 2025

Дополнительную информацию о разработке отчетов можно подчерпнуть в данной статье курса по разработке приложений.

Общая информация

Периодически возникает необходимость модифицировать базовый отчет, либо создать на его основе свою версию. Зачастую модификация необходима для решения следующих задач:

Добавление дополнительных фильтров данных
Вывод дополнительных данных
Предварительная обработка данных отчета
Изменение параметров визуализации

В рамках платформы Эра, задача модификации отчета решается с помощью создания собственного контрола и механизма подмен (shifts).

Общий алгоритм следующий:

Найти необходимый контрол базового отчета
Создать в своём пакете собственный контрол, скопировав в него все параметры базового
Внести необходимые изменения в параметры контрола
Заместить базовый контрол новым при помощи подмены*
Применить изменения пакета

Пункт 4 является опциональным, если нет необходимости замещать базовый отчет собственной версией. Свою версию отчета можно разместить в отдельном приложении, либо сделать подмену приложения Отчеты и внести в него свой отчет отдельной вкладкой.

Далее, на примере базового отчета "Звонки по суткам" разберем весь процесс.

Шаг 1. Поиск контрола базового отчета

Самый простой способ найти контрол отчета - это поиск по полному имени в пакете callcenter.

Для этого необходимо взять адрес страницы с отчетом:

https://[ERA_FQDN]/app/callcenter_reports/#/ui/callcenter/reports/seances/ArchiveSeancesByDateReport

Из него необходимо взять строку после /ui/:

callcenter/reports/seances/ArchiveSeancesByDateReport

Далее, в приложении Builder, в разделе Controls необходимо выбрать пакет callcenter (все базовые отчеты хранятся именно в этом пакете) и указать полученное ранее значение в строке поиска.

@@ Строка 1: / Строка 1: @@
   Дополнительную информацию о разработке отчетов можно подчерпнуть в [[Разработка отчётов|данной статье]] курса по разработке приложений.
+= Общая информация =
 Периодически возникает необходимость модифицировать базовый отчет, либо создать на его основе свою версию. Зачастую модификация необходима для решения следующих задач:
@@ Строка 9: / Строка 11: @@
 В рамках платформы Эра, задача модификации отчета решается с помощью создания [[Отображение данных. Таблицы и карточки|собственного контрола]] и механизма [[Подмены классов|подмен (shifts)]].
+Общий алгоритм следующий:
+# Найти необходимый контрол базового отчета
+# Создать в своём пакете собственный контрол, скопировав в него все параметры базового
+# Внести необходимые изменения в параметры контрола
+# Заместить базовый контрол новым при помощи подмены*
+# Применить изменения пакета
+Пункт 4 является опциональным, если нет необходимости замещать базовый отчет собственной версией. Свою версию отчета можно разместить в отдельном приложении, либо сделать подмену приложения Отчеты и внести в него свой отчет отдельной вкладкой.
+Далее, на примере базового отчета "Звонки по суткам" разберем весь процесс.
+= Шаг 1. Поиск контрола базового отчета =
+[[Файл:Отчет Звонки по суткам.png|мини|Отчет "Звонки по суткам"]]
+Самый простой способ найти контрол отчета - это поиск по полному имени в пакете callcenter.
+Для этого необходимо взять адрес страницы с отчетом:
+https://[ERA_FQDN]/app/callcenter_reports/#/ui/callcenter/reports/seances/ArchiveSeancesByDateReport
+Из него необходимо взять строку после /ui/:
+[[Файл:Поиск контрола в приложении Builder.png|мини|Поиск контрола в приложении Builder]]
+callcenter/reports/seances/ArchiveSeancesByDateReport
+Далее, в приложении Builder, в разделе Controls необходимо выбрать пакет callcenter (все базовые отчеты хранятся именно в этом пакете) и указать полученное ранее значение в строке поиска.
 [[Категория:Курс Разработка приложений]]
 [[Категория:Практика]]