Кольцевая диаграммаLTS

В этой статье

Кольцевая диаграмма

На кольцевой диаграмме данные представлены в виде секторов круга, где каждый сектор представляет собой часть целого. Сумма всех секторов равна 100 %.

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

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

Настройка данных

В виджет можно добавить один разрез и несколько мер. На странице Разрезы и меры описывается работа с локальными показателями.

Для меры дополнительно можно включить отображение абсолютного значения. Для разреза можно включить вложенность массива, скрыть пустые значения, добавить действия по клику и настроить параметр Отображать (Всегда/По переменной/По формуле).

Разрезам и мерам можно задать цвет. Правила отображения, которые можно применить к виджету, задаются на уровне пространства в Модели данных или во вкладке показателей в дашборде.

Заметка

Отображение режимов настройки цвета в разрезах и мерах зависит от конфигурации виджета.

Без разреза	С разрезом
Для меры доступны правила с режимом: 1. Базовый	Для разреза доступны режимы: 1. Отключено 2. По значениям (для значений доступны правила с базовым режимом) 3. По правилу (для значений доступны правила по разрезу, который добавлен в виджет) Для меры доступны режимы: 1. Авто (по умолчанию) 2. По градиенту (чтобы избежать появления большого количества промежуточных цветов, настройте количество классов — от 3 до 10) 3. По правилу (для значений доступны правила с режимом По градиенту или Настроить) 4. Настроить (по формуле)

Без разреза

С разрезом

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

1. Базовый

Для разреза доступны режимы:

1. Отключено
2. По значениям (для значений доступны правила с базовым режимом)
3. По правилу (для значений доступны правила по разрезу, который добавлен в виджет)

Для меры доступны режимы:

1. Авто (по умолчанию)
2. По градиенту (чтобы избежать появления большого количества промежуточных цветов, настройте количество классов — от 3 до 10)
3. По правилу (для значений доступны правила с режимом По градиенту или Настроить)
4. Настроить (по формуле)

Настройка отображения

Размер текста

Регулирует размер текста в строках виджета.

Лимит разреза

Регулирует количество отображаемых на диаграмме сегментов.

Подсказка

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

Тип

Для диаграммы можно настроить тип отображения: кольцевая (с вырезом по центру) или круговая (целый круг). На скриншоте ниже — пример отображения диаграммы в виде целого круга.

Дополнительные настройки отображения

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

Настройка фильтрации

Для виджета доступны стандартные настройки фильтрации.

Фильтр, настроенный в виджете, невозможно удалить в режиме просмотра.

Заметка

В кольцевой диаграмме значения отображаются в долях.
Другое вычисляется как 100 % — сумма всех сегментов.
Сегмент Другое недоступен для клика.

Подробнее о виджете Кольцевая диаграмма в видеокурсе.

Настройка виджета в YAML

Виджет можно редактировать не только в образе, но и в YAML-редакторе. В таблице ниже представлены ключи и значения, которые можно использовать для настройки. Подробнее о том, как работать с ключом value, описано на странице Значения разрезов и мер в YAML. Форматы данных, которые можно использовать, описаны на соответствующей странице. Общие параметры для виджетов описаны на странице Настройка виджетов в YAML.

Настройки данных в YAML

Ключ	Тип	Определение
title	string	Заголовок
showMarkdown	boolean	Описание
markdownText	string	Текст описания
markdownMeasures	—	Меры в описании
dimensions	—	Разрезы
measures	—	Меры
sorting	—	Сортировка

Разрезы в YAML (ключ dimensions)

Ключ	Тип	Определение
name	string	Название разреза
value	—	Формула разреза
dbDataType	enum	Тип данных разреза
format	enum	Формат
formatting	enum	Форматирование
formattingTemplate	string	Собственное форматирование Только для форматирования `CUSTOM` (Настроить)
hideEmptyValues	boolean	Скрыть пустые значения
hierarchyDimensions	—	Разрезы иерархии Если добавлен этот параметр, то показатель определяется как иерархия
onClick	—	Действия по клику Если показатель иерархический, параметр не применяется
color	—	Цвет: - `DISABLED` — отключено - `VALUES` — по значениям - `RULE` — по правилу Если разрез иерархический, параметр не применяется
displayCondition	—	Отображать (условие отображения)
arrayNesting	boolean	Вложенность массива

Иерархический разрез (ключ hierarchyDimensions)

Ключ	Тип	Определение
name	string	Название разреза
value	—	Формула разреза
dbDataType	enum	Тип данных разреза
format	enum	Формат
formatting	enum	Форматирование
formattingTemplate	string	Собственное форматирование Только для форматирования `CUSTOM` (Настроить)
hideEmptyValues	boolean	Скрыть пустые значения
onClick	—	Действия по клику
color	—	Цвет: - `DISABLED` — отключено - `VALUES` — по значениям - `RULE` — по правилу
displayCondition	—	Отображать (условие отображения)
arrayNesting	boolean	Вложенность массива

Меры в YAML (ключ measures)

Ключ	Тип	Определение
name	string	Название меры
value	—	Формула меры
dbDataType	enum	Тип данных формулы
format	enum	Формат
formatting	enum	Форматирование
formattingTemplate	string	Собственное форматирование Только для форматирования `CUSTOM` (Настроить)
showLabels	—	Метки значений
color	—	Цвет Доступные режимы без разреза: - `AUTO` — авто - `BASE` — базовый - `RULE` — по правилу Доступные режимы с разрезом: - `AUTO` — авто - `GRADIENT` — по градиенту - `RULE` — по правилу - `FORMULA` — по формуле
displayCondition	—	Отображать (условие отображения)

Метки значений (ключ showLabels)

Ключ	Тип	Определение
enabled	boolean	Метки вкл/выкл
absolute	boolean	Абсолютные значения
size	number	Размер меток

Настройки отображения в YAML

Ключ	Тип	Определение
paddings	string	Отступы по сторонам
titleSize	number	Размер заголовка
titleColor	—	Цвет заголовка: - `AUTO` — авто - `BASE` — базовый
titleWeight	enum	Толщина заголовка: - `NORMAL` — обычная - `BOLD` — большая
markdownTextSize	number	Текст описания В параметре указывается размер текста описания в Markdown. Параметр доступен, если активен переключатель Описание
textSize	number	Размер текста
dimensionLimit	number	Лимит разреза
hideEmptyValues	boolean	Скрыть пустые значения
showHint	boolean	Подсказка
legend	—	Легенда
chartType	enum	Тип диаграммы: - `PIE` — кольцевая (с вырезом по центру) - `DONUT` — круговая (целый круг)

Настройки фильтрации в YAML

Ключ	Тип	Определение
filterMode	enum	Режим фильтрации: - `DEFAULT` — базовый - `SINGLE` — единичный выбор - `DISABLED` — отключено
ignoreFilters	boolean	Игнорировать фильтры
filters	—	Фильтры
aggregateFilters	—	Агрегатные фильтры
stateName	string	Состояние

Пример настроенного виджета в YAML-редакторе

widgets:
  - key: donut-chart
    apiVersion: "17"
    type: DONUT_CHART
    settings:
      titleColor:
        mode: AUTO
      titleSize: 14
      paddings: 8
      titleWeight: NORMAL
      textSize: 12
      filterMode: DEFAULT
      ignoreFilters: false
      stateName: null
      title: ""
      showMarkdown: false
      markdownMeasures: []
      markdownText: ""
      markdownTextSize: 14
      dimensions:
        - name: Континент
          value:
            mode: FORMULA
            formula: '"store"."Континент"'
          dbDataType: String
          hideEmptyValues: false
          format:
            value: STRING
            mode: BASE
          formatting:
            value: AUTO
            mode: BASE
          onClick: []
          displayCondition:
            mode: DISABLED
          color:
            mode: DISABLED
      measures:
        - name: Количество
          value:
            mode: FORMULA
            formula: count()
          dbDataType: UInt64
          formatting:
            value: AUTO
            mode: BASE
          format:
            value: NUMBER
            mode: BASE
          showLabels:
            enabled: true
            absolute: false
            size: 12
          displayCondition:
            mode: DISABLED
          color:
            mode: AUTO
      chartType: PIE
      legend:
        position: RIGHT
        verticalAlign: TOP
        width:
          value: null
          mode: PIXEL
      dimensionLimit: 10
      filters: []

Была ли статья полезна?

Да

Нет

Линейный график

Гистограмма