Конструктор отчётов¶
Раздел «Отчёты» в веб-интерфейсе администратора. Здесь создаются отчёты, которые пользователи запускают по названию и получают одинаковый результат независимо от формулировки вопроса.
Для работы нужно право на управление отчётами.
Список отчётов¶
В списке видны название, домен данных, состояние и дата последнего изменения. Есть поиск по названию и тегам, фильтры по домену и состоянию.
| Действие | Что делает |
|---|---|
| Новый отчёт | Открывает конструктор с чистого листа |
| Изменить | Открывает существующий отчёт |
| Дублировать | Создаёт копию, удобно для однотипных отчётов |
| Экспорт | Выгружает определение отчёта файлом |
| Экспорт всех | Выгружает все отчёты сразу |
| Импорт из файла | Загружает отчёт из ранее выгруженного файла |
| Удалить | Убирает отчёт из системы |
Выключенный отчёт сохраняется, но пользователям не показывается. Это удобнее удаления, когда отчёт временно не нужен.
Создание отчёта¶
Шаг 1. Основное¶
Задайте название, которое увидит пользователь, техническое имя, описание и теги. По техническому имени отчёт опознаётся системой, поэтому менять его после публикации не стоит: это будет считаться созданием нового отчёта.
Шаг 2. Источник данных¶
Выберите домен и таблицы. Если таблиц несколько, укажите связи между ними: какое поле какому соответствует.
Шаг 3. Что посчитать¶
Добавьте показатели и выберите способ расчёта:
| Способ | Когда применяется |
|---|---|
| Сумма | Выручка, объём, количество за период |
| Количество | Число записей, заказов, обращений |
| Среднее | Средний чек, средний срок |
| Взвешенное среднее | Средняя цена с учётом объёма |
| Минимум и максимум | Границы диапазона |
| Как есть | Значение поля без расчёта |
Шаг 4. Разрезы и порядок¶
Укажите поля группировки, то есть в каком разрезе показывать данные: по филиалам, по категориям, по месяцам. Задайте сортировку: по алфавиту, по убыванию значения или свой порядок.
При необходимости включите сводную таблицу, тогда значения выбранной категории развернутся в отдельные колонки.
Шаг 5. Фильтры и параметры¶
Фильтры это то, что пользователь задаёт при запуске отчёта: период, подразделение, категория, порог.
Для каждого параметра задаются название, тип (дата, строка, число, категория, да или нет) и возможность выбрать несколько значений. Есть проверка параметров прямо в конструкторе.
Шаг 6. Колонки и формат¶
Настраивается внешний вид результата:
| Настройка | Что даёт |
|---|---|
| Порядок и состав колонок | Что и в какой последовательности видит пользователь |
| Наименование колонки | Понятная подпись вместо технического имени |
| Формат значения | Рубли, штуки, проценты, целое число, свой формат |
| Выравнивание | Слева, справа, по центру |
| Группы колонок | Объединение нескольких колонок общим заголовком |
Шаг 7. Итоги и оформление¶
| Настройка | Что даёт |
|---|---|
| Общий итог | Итоговая строка по всей выборке |
| Подытоги по группам | Промежуточные итоги в разрезах |
| Выделение итога | Итоговая строка жирным |
| Условное форматирование | Подсветка значений, удовлетворяющих условию |
| Чередование строк | Полосы для удобного чтения |
| Закрепление областей | Шапка остаётся на месте при прокрутке |
| Печатная шапка и дата формирования | Оформление для печати и передачи |
Живое превью¶
Конструктор показывает результат по мере настройки. Если запрос собрать не удаётся, превью выводит причину. Это позволяет проверить отчёт до того, как его увидит пользователь.
Работа с SQL напрямую¶
Конструктор собирает запрос сам, но его можно посмотреть и при необходимости править вручную. Полезно, когда нужна логика, которой нет в конструкторе.
После ручной правки конструктор можно синхронизировать обратно кнопкой сборки запроса заново. Учтите, что при этом ручные изменения будут потеряны.
Проверка перед публикацией¶
- Превью показывает ожидаемые цифры на известном примере.
- Все обязательные параметры заданы и проверены.
- Названия колонок и форматы понятны пользователю, технических имён не осталось.
- Итоги считаются правильно, моментальные показатели не суммируются по датам.
- Отчёт включён и виден пользователю с нужной ролью.
Отчёты в системе контроля версий¶
Определения отчётов выгружаются файлами и загружаются обратно, поэтому их можно вести в системе контроля версий и переносить со стенда на промышленный контур. Порядок работы описан в разделе Подключение данных.
Такой способ и конструктор совместимы: отчёт, созданный в интерфейсе, выгружается файлом, а загруженный файл дальше правится в конструкторе.