Отчёты

Отчёты (/reports) — конструктор табличных выгрузок по данным сущностей: колонки (включая поля связанных сущностей), фильтры, группировка с промежуточными итогами, сортировка. Готовый отчёт можно смотреть в интерфейсе, выгружать в CSV / XLSX / PDF и рассылать по расписанию на email.

Отчёты дополняют дашборды и графики: график отвечает на вопрос «сколько и как меняется», отчёт — «какие именно записи и с какими значениями», в форме, пригодной для передачи руководителю или клиенту.

Кто что может

Право / роль	Возможности
reports.view	Видеть и выполнять отчёты, к которым дан доступ
reports.build	Создавать и редактировать собственные отчёты
Роль Конструктор отчётов (report_builder)	Готовый набор: reports.build + reports.view
Роль Администратор отчётов (report_administrator)	То же + право раздела admin.reports — администрирование всех отчётов
Роль Администратор (admin)	Полный доступ ко всем отчётам без ограничений

Данные фильтруются правами

Отчёт показывает только те записи, которые доступны выполняющему его пользователю по правилам доступа к записям. Отчёты по расписанию выполняются от имени владельца отчёта — получатели письма увидят данные в объёме прав владельца.

Создание отчёта

1. Откройте раздел Отчёты
2. Нажмите Создать отчёт
3. На вкладке Основное укажите название, описание и сущность — источник данных

TIP

Сущность нельзя изменить после создания отчёта: колонки, фильтры и группировки привязаны к её схеме. Для другой сущности создайте новый отчёт.

Дальше отчёт настраивается по вкладкам.

Колонки

Кнопка Добавить колонку открывает дерево полей:

• поля самой сущности — любое поле из конструктора;
• поля связанных сущностей — через ссылочные поля можно «дотянуться» до полей связанной записи (до 2 переходов), например Заявка → Клиент → Название компании;
• у каждой колонки можно задать свой Заголовок колонки вместо автоматического.

Кнопка Добавить агрегат по связанным создаёт вычисляемую колонку по дочерним записям: количество, сумма, среднее, минимум или максимум по числовому полю связанной сущности, при необходимости — с условиями отбора дочерних записей. Пример: колонка «Открытых сделок» в отчёте по клиентам.

Фильтры

Каждый фильтр — это поле (своё или связанной сущности), оператор и значение. Доступные операторы: равно / не равно, содержит, сравнения (>, <, >=, <=), «одно из», диапазон дат, относительный период (Сегодня, Вчера, Текущая/Прошлая неделя, Последние N часов/дней и т.п.), между, пусто / не пусто, по категории, наличие связанных записей.

У фильтра есть переключатель Параметр пользователя — такой фильтр становится изменяемым при просмотре: зритель отчёта может подставить своё значение (например, выбрать период), не имея прав на редактирование самого отчёта. Флаг Обязательный не даст выполнить отчёт, пока параметр не заполнен.

Группировка и итоги

До 3 уровней группировки, каждый со своим направлением сортировки. Для сгруппированного отчёта настраиваются итоги — агрегатные значения по группам и по отчёту в целом:

• count — количество записей;
• sum, avg, min, max — по числовым полям;
• перцентили p50, p90, p95, p99 … — по числовым полям (например, «90 % заявок решаются быстрее X часов»).

Итог выводится в той колонке, где показано агрегируемое поле, поэтому поле должно присутствовать среди колонок отчёта.

Сортировка

Список полей с направлением (по возрастанию/убыванию) — применяется внутри групп или ко всему отчёту, если группировки нет.

Доступ

По умолчанию отчёт видит только владелец (и администраторы). На вкладке Доступ его можно выдать:

• конкретным пользователям;
• ролям;
• группам.

Получатели доступа видят отчёт в списке и могут выполнять его (с собственными значениями параметров), но не редактировать.

Расписания

Вкладка Расписания автоматизирует рассылку:

Поле	Описание
Cron-выражение	Периодичность в формате cron, например 0 8 * * 1 — по понедельникам в 08:00
Часовой пояс	В каком поясе трактовать cron-выражение
Формат	CSV, XLSX или PDF
Получатели	Email-адреса и/или пользователи системы (можно вперемешку)
Параметры	Значения параметров-фильтров для этого расписания
Активно	Выключенное расписание сохраняется, но не выполняется

Кнопка Запустить сейчас выполняет расписание немедленно — удобно проверить письмо, не дожидаясь cron.

Файл до 10 МБ приходит вложением в письмо; более крупный — ссылкой на скачивание (ссылка действует 7 дней).

Просмотр и экспорт

Открытый отчёт (/reports/view/…) показывает данные прямо в интерфейсе — с группами, итогами и панелью параметров, если они настроены. Синхронный просмотр ограничен 10 000 строк; если данных больше, используйте экспорт.

Экспорт выполняется в фоне: нажмите кнопку нужного формата — задача уходит в очередь, а готовый файл появляется в списке выгрузок отчёта, откуда его можно скачать. Ограничения форматов:

Формат	Лимит строк	Комментарий
CSV	без практического лимита	Самый быстрый и лёгкий формат
XLSX	50 000	Готов для Excel: заголовки, группы, итоги
PDF	1 000	Для печати/подписи; при больших объёмах выгружайте XLSX/CSV

Сгенерированные файлы хранятся 30 дней, после чего удаляются автоматически. Историю выгрузок можно чистить вручную.

Примеры бизнес-кейсов

Еженедельная сводка для руководителя поддержки

Сущность Заявки:

• Колонки: номер, тема, статус, исполнитель, дата создания;
• Фильтр: «Дата создания» → относительный период → Прошлая неделя;
• Группировка: по исполнителю; итог — count (сколько заявок обработал каждый);
• Расписание: 0 8 * * 1, формат XLSX, получатель — руководитель отдела.

Каждый понедельник в 08:00 руководитель получает письмо с готовой таблицей за прошедшую неделю.

Контроль SLA через перцентили

Сущность Заявки, при условии что автоматизация или процесс записывает в запись числовое поле «Время решения, ч»:

• Колонки: категория, время решения;
• Фильтр-параметр: «Дата закрытия» → диапазон дат (зритель выбирает период сам);
• Группировка: по категории; итоги — avg и p90 по времени решения.

Отчёт отвечает на вопрос «90 % заявок какой категории мы решаем быстрее чем за N часов» — это честнее среднего, которое маскирует выбросы.

Клиенты с открытыми сделками (агрегат по связанным)

Сущность Клиенты из CRM-пресета:

• Колонки: название, менеджер + агрегат по связанным: count сделок с условием «статус = Открыта» и sum по полю «Сумма» тех же сделок;
• Сортировка: по сумме открытых сделок по убыванию;
• Доступ: роль менеджеров продаж.

Получается живой «пайплайн по клиентам», который каждый менеджер открывает со своими правами — правила доступа к записям автоматически ограничат список его клиентами.

Смотрите также

• Дашборды и графики — визуальная аналитика в реальном времени
• Доступ к записям — как права влияют на содержимое отчёта
• Пользователи, группы, роли — назначение ролей report_builder / report_administrator