Процентный показатель

В этой статье

Процентный показатель

Процентный показатель — это виджет, который отображает ключевое значение в процентах для акцента на важных метриках.

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

Процентный показатель может:

Принимать положительные и отрицательные значения
Принимать значения больше 100 % (если значение не умещается в рамках круговой шкалы, появляется многоточие)

Заметка

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

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

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

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

Для виджета применимы общие настройки данных.

Дополнительно для меры доступны следующие настройки:

Размер шрифта
Толщина шрифта
Название (переключатель отображения названия меры)
Положение (отображение названия меры над показателем)
Размер названия
Цвет:
- Авто
- Базовый
- По градиенту (если значение показателя превышает 100 %, полосе значения присваивается конечный цвет. Настройка количества классов не влияет на это поведение)
- По правилу (подходят правила с режимами Базовый, По мере и Настроить)
- Настроить
Отображать (условие отображения)

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

По умолчанию виджет отображается в формате Процент, когда значение меры дополнительно умножается на 100. Также для виджета доступен формат Число.

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

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

Заметка

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

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

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

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

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

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

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

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

Ключ	Тип	Определение
name	string	Название меры
value	—	Формула меры
dbDataType	enum	Тип данных формулы
format	enum	Формат
formatting	enum	Форматирование
showTitle	boolean	Показывать название меры
position	enum	Визуальное отображение названия меры: - `TOP` — сверху - `BOTTOM` — снизу
fontSize	number	Размер шрифта Чтобы размер шрифта настраивался автоматически, в значении укажите `null`
fontWeight	enum	Толщина шрифта меры: - `NORMAL` — обычная - `BOLD` — большая
color	—	Цвет Доступные режимы: - `DISABLED` — отключено - `AUTO` — авто - `GRADIENT` — по градиенту - `FORMULA` — по формуле - `RULE` — по правилу
displayCondition	—	Отображать (условие отображения)

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

Ключ	Тип	Определение
paddings	string	Отступы по сторонам
width	number	Ширина
height	number	Высота
titleSize	number	Размер заголовка
titleColor	—	Цвет заголовка: - `AUTO` — авто - `BASE` — базовый
titleWeight	enum	Толщина шрифта: - `NORMAL` — обычная - `BOLD` — большая
alignment	enum	Выравнивание: - `LEFT` — по левому краю - `CENTER` — по правому краю - `RIGHT` — по правому краю
markdownTextSize	number	Текст описания В параметре указывается размер текста описания в Markdown. Параметр доступен, если активен переключатель Описание

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

Ключ	Тип	Определение
ignoreFilters	boolean	Игнорировать фильтры
filters	—	Фильтры
stateName	string	Состояние

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

widgets:
  - key: percentage-kpi
    apiVersion: "10"
    type: PERCENTAGE_KPI
    settings:
      appearance:
        enabled: false
      titleSize: 14
      titleColor:
        mode: AUTO
      titleWeight: NORMAL
      ignoreFilters: false
      stateName: null
      title: ""
      showMarkdown: false
      markdownMeasures: []
      markdownText: ""
      filters: []
      alignment: CENTER
      measures:
        - name: Количество
          value:
            mode: FORMULA
            formula: count()
          dbDataType: UInt64
          format: NUMBER
          formatting: AUTO
          showTitle: true
          position: BOTTOM
          fontWeight: BOLD
          titleSize: 14
          color:
            mode: AUTO
          displayCondition:
            mode: DISABLED

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

Да

Нет

Показатель

Панель с показателями