Столбиковая диаграммаLTS

В этой статье

Столбиковая диаграмма

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

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

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

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

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

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

Заметка

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

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

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

Совет

Если в столбиковой диаграмме используется 2 разреза, то сортировка по итоговому значению может отображаться некорректно. Для корректного отображения сортировки по итоговому значению используйте формулу any(process(count("разрез_2"), "разрез_1")). Формула рассчитывает весь диапазон значений и позволяет вывести результат как по возрастанию, так и по убыванию.

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

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

Регулирует размер текста в виджете, кроме значений меток для мер.

Лимит разреза и лимит второго разреза

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

Скрыть пустые значения

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

Подсказка

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

Тип

Регулирует отображение столбиков: с накоплением (по умолчанию) или с группировкой. При отображении с накоплением можно дополнительно включить метки итоговых значений для столбиков и настроить размер текста для этих меток.

Ориентация

Регулирует направление, в котором отображаются столбики:

Авто (по умолчанию)
По вертикали
По левому краю
По правому краю

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

Ширина столбиков

По умолчанию — Авто (20 пикселей при горизонтальной ориентации и 36 — при вертикальной). Допустимые значения — от 12 до 100 пикселей. Введенное значение устанавливается в качестве максимальной ширины столбика, если на диаграмме достаточно места (промежутки между столбиками не меньше ширины самого столбика). Если места недостаточно, для столбиков устанавливается максимально возможная в каждом отдельном случае ширина.

Заметка

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

Легенда

Подробности работы с легендой описаны на странице Виджеты.

Ось X

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

Ось Y

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

Заметка

Отображение обеих осей можно включить или отключить.

Опорные линии

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

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

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

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

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

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

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

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

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

Разрез 1 (ключ dimensionsFirstGroup)

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

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

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

Разрез 2 (ключ dimensionsSecondGroup)

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

Иерархический разрез для Разреза 2 (ключ 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` — базовый - `GRADIENT` — по градиенту - `RULE` — по правилу - `FORMULA` — по формуле He задается, если разрезы добавлены в обе группы
displayCondition	—	Отображать (условие отображения)

Показывать метки значений (ключ showLabels)

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

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

Ключ	Тип	Определение
paddings	string	Отступы по сторонам
titleSize	number	Размер заголовка
titleColor	—	Цвет заголовка: - `AUTO` — авто - `BASE` — базовый
titleWeight	enum	Толщина заголовка: - `NORMAL` — обычная - `BOLD` — большая
markdownTextSize	number	Текст описания В параметре указывается размер текста описания в Markdown. Параметр доступен, если активен переключатель Описание
textSize	number	Размер текста
firstDimensionLimit	number	Лимит Разреза 1
secondDimensionLimit	number	Лимит Разреза 2
hideEmptyValues	boolean	Скрыть пустые значения
showHint	boolean	Подсказка
chartType	enum	Тип: - `STACK` — с накоплением - `GROUP` — с группировкой
orientation	enum	Ориентация: - `AUTO` — авто - `HORIZONTAL` — по горизонтали - `VERTICAL-LEFT` — по вертикали слева - `VERTICAL-RIGHT` — по вертикали справа
legend	—	Легенда
showTotalLabels	—	Метки итоговых значений Только для типа `STACK`
xAxis	—	Настройки оси X
yAxis	—	Настройки оси Y
barWidth	number	Ширина столбиков

Метки итоговых значений (ключ showTotalLabels)

Ключ	Тип	Определение
enabled	boolean	Итоговые метки вкл/выкл
size	number	Размер меток

Настройки оси X (ключ xAxis)

Ключ	Тип	Определение
enabled	boolean	Ось X вкл/выкл
rotation	number	Поворот меток
height	number	Высота меток
showTitle	boolean	Заголовок

Настройки оси Y (ключ yAxis)

Ключ	Тип	Определение
enabled	boolean	Ось Y вкл/выкл
width	number	Ширина меток
showTitle	boolean	Заголовок

Опорные линии (ключ referenceLines)

Чтобы добавить на ось Y опорные линии, используйте ключ referenceLinesEnabled.

Ключ	Тип	Определение
referenceLinesEnabled	boolean	Переключатель Опорные линии

В блоке с ключом referenceLines используются ключи из таблицы ниже.

Ключ	Тип	Определение
name	string	Название
color	—	Блок для настройки цвета опорной линии. В ключе `mode` указывается режим: - `AUTO` — авто - `BASE` — базовый Если указан режим `BASE`, то в ключе `value` в двойных кавычках указывается HEX-код цвета, например `"#e51320"`
type	enum	Тип линии - `SOLID` — сплошная - `DOTTER` — пунктирная
dashLength	number	Длина тире. Ключ настраивается только при использовании пунктирной опорной линии (`DOTTER`)
thickness	number	Толщина опорной линии. Минимальное значение — `0`, максимальное — `20`
formula	string	Формула. Указывается в двойных кавычках, например `"400"`

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

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

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

widgets:
  - key: bar-chart
    apiVersion: "17"
    type: BAR_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
      showTotalLabels:
        enabled: false
        size: 12
      xAxis:
        enabled: true
        showTitle: true
        referenceLinesEnabled: false
      yAxis:
        enabled: true
        showTitle: true
        referenceLinesEnabled: false
      firstDimensionLimit: 15
      secondDimensionLimit: 50
      dimensionsFirstGroup:
        - name: trimmed_name
          value:
            mode: FORMULA
            formula: '"phases"."trimmed_name"'
          dbDataType: String
          formatting:
            value: AUTO
            mode: BASE
          hideEmptyValues: false
          format:
            value: STRING
            mode: BASE
          onClick: []
          displayCondition:
            mode: DISABLED
          color:
            mode: DISABLED
      dimensionsSecondGroup:
        - name: action_type
          value:
            mode: FORMULA
            formula: '"phases"."action_type"'
          dbDataType: String
          formatting:
            value: AUTO
            mode: BASE
          hideEmptyValues: false
          format:
            value: STRING
            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
            size: 12
          color:
            mode: AUTO
          displayCondition:
            mode: DISABLED
      chartType: STACK
      orientation: AUTO
      legend:
        position: BOTTOM
        align: CENTER
        verticalAlign: TOP
        width:
          mode: PIXEL
          value: null
      filters: []
      barWidth: null

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

Да

Нет

Комбинированная диаграмма

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