Виджет позволяет выводить информацию об объектах DDP в виде одного из следующих типов графиков:

  • Столбчатая диаграмма;
  • Кольцевая диаграмма;
  • Круговая диаграмма;
  • Полярная диаграмма;
  • Радарная диаграмма.

Конфигурация

НазваниеОбязательностьОписаниеЗначение по умолчанию
Тип графикаДаТип визуализации графика
Название таблицыДаНазвание таблицы в базе данных, из которой будут браться записи для визуализации
Название поляДаНазвание поля, по которому будет происходить агрегация записей
ФильтрыНетПоля, по которым будут фильтроваться полученные записи, и их значения
Тип агрегацииДаПринцип, по которому будут группироваться полученные записи
Параметры агрегацииНетВыбор временного периода и шага группировки при агрегации записей по дате

При настройке виджета учитывайте, что названия полей в базе данных могут отличаться от названий полей в спецификации объектов. Общий принцип таков: формат camelCase в спецификации объектов при сохранении структур в базу данных преобразуется в snake_case. Например:

  • Укажите поле createdAt в конфигурации виджета как created_at.
  • Укажите поле resourceUuid в конфигурации виджета как resource_uuid.

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

Название таблицыНазвание поля
entitieshealth.status

Типы агрегации

Дата

Данные на графике будут отсортированы и сгруппированы по выбранным временным интервалам.

В параметрах агрегации можно задать параметры:

  • «Единица измерения шага» — например: секунды, минуты, часы, дни и т. д.
  • «Количество единиц в одном шаге» — например: 5 минут, 2 часа, 1 день и т. п.

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

Значение

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

  • Выполняется подсчёт количества вхождений.
  • На графике отображается пара: значение — количество.

Это позволяет быстро увидеть распределение и частоту повторения различных значений.

Разбивка по интервалам

Тип агрегации «Разбивка по интервалам» позволяет гибко настроить отображение данных на графике, разделяя значения по заданным числовым диапазонам (интервалам). Это удобно для построения гистограмм и анализа распределения данных.

Доступны два режима настройки интервалов:

  1. «Автоматическая разбивка по количеству интервалов».

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

  2. «Ручное задание границ интервалов».

    Укажите массив числовых границ интервалов. Например: 0, 10, 20, 50

    В этом случае:

    • Числа будут автоматически отсортированы по возрастанию.
    • Интервалы сформируются на основе отсортированных значений:
      [0, 10), [10, 20), [20, 50]

Укажите хотя бы один из двух параметров агрегации:

  • Количество — количество интервалов;
  • Границы — границы интервалов.

Примеры:

  • Количество = 5 — построится 5 равных интервалов на основании данных.
  • Границы = 100, 0, 50 — после сортировки: [0, 50, 100], график будет построен по интервалам [0, 50), [50, 100].