Конструктор отчётов

Все отчёты, выводимые в Статистике и Панели приборов (кроме отчётов по умолчанию) являются настраиваемыми (то есть, могут быть настроены в зависимости от ваших нужд, в том числе отчёты могут быть созданы и удалены). Создание и редактирование отчётов и метрик реализовано в Конструкторе отчётов (Настройки -> Отчёты).

Конструктор отчётов состоит из двух разделов - Отчёты и Панель приборов. Переключиться на нужный раздел можно путём выбора соответствующего в шапке в верхнем правом углу. Окно раздела поделено на 2 части - список доступных отчётов, расположенный слева, и меню редактирования выбранного отчёта, занимающее большую часть экрана.

Перед созданием отчёта необходимо определиться с метриками, которые будут в нём отображаться. Метрикой называется числовой показатель, характеризующий некий параметр работы системы (например, количество обработанных диалогов, количество пропущенных диалогов и т.д.). Можно выбрать как из уже доступных метрик, так и создать новую, если требуется (создание новых метрик в версиях Webim до 10.5 включительно осуществляется по обращению в техническую поддержку Webim).

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

В Конструкторе отчётов перейдите в раздел Отчёты и нажмите Добавить новый отчёт.

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

Название - название отчёта, которое будет отражаться в статистике.
Описание - краткое содержание, какие данные показывает отчёт. Видно только в меню редактирования.
Группировать по - выбор группировки данных отчёта из списка. Всего можно выбрать до 3 группировок, каждая из которых будет произведена последовательно в порядке слева направо. Ниже приведён пример отчёта с тройной группировкой в конфигурации.

Добавить метрику - выбор метрик (метрикой называется числовой показатель, характеризующий некий параметр работы системы), которые будут отображаться в отчёте, а также настройка параметров их отображения:

Параметр	Описание
Название	Название метрики. Выбирается из списка метрик, относящихся к выбранным Источникам данных.
Формат выводимых данных	В зависимости от того, какие данные отражает метрика, выбирается нужный формат отображения (из списка).
Группировать по	Один или несколько выпадающих списков, соответствующих выбранным для отчёта группировкам.

Добавить вычисляемое значение - выбор или создание вычисляемого значения. Вычисляемым значением называется выражение с некоторыми переменными различных типов. Для вычисляемых значений можно задать следующие параметры:

Параметр	Описание
Название	Название метрики. Выбирается из списка метрик, относящихся к выбранным Источникам данных.
Формат выводимых данных	В зависимости от того, какие данные отражает метрика, выбирается нужный формат отображения (из списка).
Выражение	Выражение для вычисления значения. Принимает стандартную арифметику, переменные одного из трёх представленных ниже типов, а также функцию `if` с синтаксисом вида: `if(<условие>, <значение, если верно>, <значение, если неверно>)`

Переменные в выражении могут быть трёх типов:

* **Опция account config**: одна из заданных в выпадающем списке опций [account config](../../../devops/account-config-editor.html).

* **Скалярное значение**: именованное числовое значение.

* **Метрика**: метрика, которая будет использована в выражении для расчёта вычисляемого значения, и её группировки.

У каждой переменной есть собственный идентификатор, являющийся единственным способом указать данную переменную в выражении.

Чекбокс Выводить сумму задаёт, будет ли в отчёте выведена сумма для данной метрики или вычисляемого значения.

При нажатии на иконку в правом верхнем углу метрики или вычисляемого значения снизу откроется дополнительное меню Граничные значения. В нём вы можете задать диапазоны значений для метрики и цвета, в которые будут окрашены соответствующие этим диапазонам ячейки таблицы отчёта. Все граничные значения должны быть целыми числами, диапазоны не должны пересекаться, а цвета задаются через цветовой селектор, либо же в форматах RGBA, HSLA или HEX.

Для удаления из отчёта метрики или вычисляемого значения нажмите на соответствующую подлежащему удалению объекту иконку .

После заполнения всех полей/пунктов для отчёта, нажмите кнопку Сохранить - новый отчёт отобразится в списке доступных слева от меню редактирования и также станет доступен в Статистике. Если вы передумаете создавать отчёт, то нажмите кнопку Отменить. Если же потребуется удалить ранее созданный отчёт, то в списке доступных отчётов найдите нужный и нажмите на крестик.

Внимание!

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