Виджет «Графическая статистика»

Примечание

Доступно только в enterprise версии.

Ключ charts

Виджет позволяет пользователям наглядно представлять и анализировать данные, повышая эффективность принятия решений и улучшая понимание текущего состояния бизнес-процессов.

../../../_images/chart_1.png ../../../_images/chart_1_1.png

При разработке использована библиотека Chart.js

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

Графики конфигурируемые - пользователи могут настраивать оси, масштабирование и т.д.

../../../_images/chart_2.png

Для столбчатого, линейного, кругового тира по нажатию на пункт легенды данные пункта легенды убираются из представления графика:

../../../_images/chart_3.png

Общая конфигурация

Для всех типов графиков:

../../../_images/chart_4.png

Название виджета

Укажите наименование представления.

Тип графика

Выберите тип из списка:
- Столбчатый
- Круговой
- Линейный
- Воронка

Настройки журнала

Журнал

Выберите журнал, по данным которого необходимо построить график.
В выбранном журнале должны быть заранее настроены колонки для группировки. Действие доступно для администратора.
Для разрешения группировки перейдите в журнале к необходимому столбцу, нажмите Дополнительно:
Выставите чекбокс Можно ли группировать:

Шаблон журнала

Выберите шаблон журнала.

Атрибуты группировки

Группировка - операция объединения данных в группы таким образом, чтобы у элементов в каждой группе был общий атрибут.
Нажмите «Добавить» и выберите из списка атрибуты, по которым производить группировку данных.
В списке представлены атрибуты, у которых в настройках разрешена группировка.

Атрибут агрегации

Выберите атрибут из представленых в списке, по которому возвращать сводные данные.

Столбчатый

../../../_images/chart_8.png

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

Настройка:

../../../_images/chart_5.png

Минимальное вертикальное значение

Минимальное значение, отображаемое на вертикальной шкале

Максимальное вертикальное значение

Максимальное значение, отображаемое на вертикальной шкале

Соотношение сторон x/y

Дробное. Масштабирования оси - отношение единицы X к единице Y. По умолчанию 2.

С помощью параметра Соотношение сторон x/y и подбора пропорций график можно выровнять по высоте. Примеры различных величин соотношений сторон:

2:


4:


Линейный

../../../_images/chart_10.png

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

Настройка:

../../../_images/chart_9.png

Минимальное вертикальное значение

Минимальное значение, отображаемое на вертикальной шкале

Максимальное вертикальное значение

Максимальное значение, отображаемое на вертикальной шкале

Соотношение сторон x/y

Дробное. Масштабирования оси - отношение единицы X к единице Y. По умолчанию 2.

Растяжение

Уровень плавности линии графика. По умолчанию 0.

Круговой

../../../_images/chart_12.png

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

Настройка:

../../../_images/chart_11.png

Радиус середины

Радиус центрального круга, в процентах от радиуса основного. По умолчанию 50 %.

Воронка

../../../_images/chart_13.png

Воронка используется для визуализации последовательных этапов процесса, где количество элементов уменьшается на каждом шаге. На каждом уровне указывается количество элементов и процент от общего количества.

При клике на любой из уровней графика открывается журнал со списком элементов, относящихся к признаку группировки.

Настройка:

../../../_images/chart_14.png

Стадии воронки

Выбор стадий и цветов отображения на воронке.

Для воронки доступны:

Выбор ответственного с функцией поиска:

../../../_images/chart_15.png

Выбор периода дат:

../../../_images/chart_16.png

Что полезно знать при настройке

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

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

Ссылка на дашборд с графиками. Дашборд открывается адресом /v2/dashboard?dashboardId=<идентификатор дашборда>. Такую ссылку можно добавить в меню пунктом типа Произвольный, чтобы график открывался из любого раздела.

Настройка виджета в артефакте дашборда

Дашборд можно не только собрать в интерфейсе, но и поставить артефактом ui/dashboard. В этом случае настройки виджета задаются в конфигурации вручную, а значения, которые в интерфейсе выбираются списком, приходится указывать точными идентификаторами.

Виджет описывается элементом с именем charts; в props.config задаются:

Свойство

Значение

graphicTypeId

Тип графика: vertical-bar (столбчатый), doughnut (круговой), line (линейный), funnel (воронка)

journalId

Ссылка на журнал, например uiserv/journal@deals-journal

typeRef

Тип данных, записи которого показывает журнал

groupByParams

Список атрибутов группировки; у атрибута с датой указываются isDateColumn: true и период в dateParam

aggregationParam

Выражение агрегации, например count(*) или сумма числового поля

selectedPreset

Шаблон журнала, по которому отбираются записи

Важно

Идентификатор типа графика должен в точности совпадать с одним из четырёх значений выше. При другом значении виджет отображается пустым — заголовок есть, графика нет, сообщения об ошибке тоже.

Примечание

Собственный идентификатор дашборда задаётся именно в артефакте: при создании записи через API идентификатор назначает платформа, а попытка указать свой приводит к ошибке Dashboard with id … is not found.

Настройка графиков через AI-ассистента

Если пользователь явно просит дашборд с графиками, AI-ассистент добавляет на него один или несколько виджетов «Графическая статистика». Для каждого графика ассистент задаёт заголовок, вид графика, группировку и агрегат. Примеры запросов:

  • «Сделай дашборд для типа Сделка с графиком количества записей по статусам».

  • «Добавь на дашборд линейный график суммы договоров по месяцам даты заключения».

  • «На одной вкладке покажи два графика: количество по статусам и сумму по ответственным».

Ассистент соблюдает следующие правила:

  • Вид графика — одно из четырёх значений graphicTypeId, перечисленных выше: столбчатый, круговой, линейный или воронка.

  • Агрегат — количество записей, сумма или среднее. Для количества числовое поле не требуется, а сумма и среднее строятся только по числовому атрибуту.

  • Группировка — по часу, дню, неделе, месяцу, кварталу или году допускается только для атрибута с датой. Для такой группировки можно дополнительно ограничить диапазон дат.

  • Ссылки на тип данных (typeRef) и журнал (journalId) — ассистент не указывает: их подставляет сам AI-сервис при сборке артефакта.

Если в графике указан несуществующий атрибут или атрибут неподходящего типа, такая конфигурация отклоняется до развёртывания дашборда.

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