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

В этой статье

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

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

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

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

Принимать положительные и отрицательные значения
Принимать значения больше 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

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

Настройка фильтрации в 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

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

Да

Нет

Показатель

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