Круговые диаграммы (Pie)

Круговые и кольцевые диаграммы

Поддерживает как круговой (pie), так и кольцевой (donut) вид, а также иерархии с drill-down.

Поля

type · "pie" · required

Тип графика

display_type · enum · default: "pie"

Вид диаграммы

Show Значения

Значение	Описание
pie	Круговая диаграмма (заполненная)
donut	Кольцевая диаграмма (с отверстием)

measure · PieMeasure

Основная мера. Используйте либо measure, либо selectable_measure.

Show Структура PieMeasure

measure · string · required

Имя меры из куба

title · string

Заголовок

data_point_actions · DataPointActionDefinition[]

Действия при клике на сектор

Show Структура DataPointActionDefinition

id · string · required

UUID действия

key · string · required

Ключ: common:copy_value | common:view_raw_data | link:open | dashboard:drill_through | dashboard:another_dashboard_drill_through

title · string · required

Текст в меню

icon · IconReference

Иконка

placement · DataPointActionPlacement

Настройки размещения в меню

Show Структура DataPointActionPlacement

menu_path · string[]

Путь в подменю, например ["Team", "More..."]

group · DataPointActionPlacementGroup

Группа действия (разделители между группами)

order · int

Порядок в группе/подменю

target_page_id · string

UUID целевой страницы (для drill_through)

target_dashboard_id · string

UUID целевого дашборда (для another_dashboard_drill_through)

filter_mappings · DrillThroughFilterMapping[]

Маппинг фильтров

url · string

URL для link:open

open_in · enum

same_tab | new_tab (для link:open)

open_in_new_tab · boolean

Открыть в новой вкладке (для another_dashboard_drill_through)

measure:
  measure: sales.revenue
  title: Выручка

selectable_measure · SingleSelectableField[PieMeasure]

Выбираемая основная мера

Show Структура

selectable_measure:
  type: single
  hint: Выберите показатель
  options:
    - measure: sales.revenue
      title: Выручка
    - measure: sales.quantity
      title: Количество

dimension · PieDimension

Основное измерение (сегменты). Используйте либо dimension, либо selectable_dimension.

Show Типы PieDimension

Простое измерение (PieBasicDimension)

type · "dimension" · default: "dimension"

Тип

dimension · CubeDimension · required

Измерение из куба

Show Структура CubeDimension

Обычное измерение:

kind: basic
value: products.category

Временное измерение:

kind: time
value:
  dimension: sales.created_at
  granularity: quarter

title · string

Заголовок

---

Иерархия измерений (drill-down)

type · "dimension_hierarchy" · required

Тип

levels · Pie2DimensionHierarchyLevel[] · required

Уровни иерархии

Show Структура Pie2DimensionHierarchyLevel

member · CubeDimension · required

Измерение уровня

title · string

Заголовок уровня

levels:
  - member:
      kind: basic
      value: geography.region
    title: Регион
  - member:
      kind: basic
      value: geography.city
    title: Город

dimension:
  dimension:
    kind: basic
    value: products.category
  title: Категория

selectable_dimension · SingleSelectableField[PieBasicDimension]

Выбираемое основное измерение (только простые измерения, не иерархии)

Show Структура

selectable_dimension:
  type: single
  hint: Выберите разрез
  options:
    - dimension:
        kind: basic
        value: products.category
      title: По категориям
    - dimension:
        kind: basic
        value: products.brand
      title: По брендам

colors · PieColorOptions

Настройки цветов

Show Структура PieColorOptions

palette_name · string · required

Имя цветовой палитры

values · Dict[string, string]

HEX-цвета для конкретных значений измерения

colors:
  palette_name: custom
  values:
    "Электроника": "#3B82F6"
    "Одежда": "#10B981"
    "Продукты": "#F59E0B"

label · PieLabelOptions

Настройки меток на секторах

Show Структура PieLabelOptions

show · boolean · required

Показать метки

position · enum · required

Позиция меток: inside | outside

show_values · boolean

Показать значения меры

show_percentages · boolean

Показать процент от общего

show_dimension_values · boolean

Показать значение измерения (название категории)

percentage_threshold · float

Минимальный порог процента для отображения метки

label:
  show: true
  position: outside
  show_values: true
  show_percentages: true
  show_dimension_values: true
  percentage_threshold: 5.0

legend · PieLegendOptions

Настройки легенды

Show Структура PieLegendOptions

show · boolean · required

Показать легенду

type · enum · required

Тип легенды: compact | detailed

truncate_item_chars · int

Максимальное количество символов для обрезки названий элементов

legend:
  show: true
  type: detailed
  truncate_item_chars: 20

sorting · PieSorting

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

show_totals · boolean · default: "false"

Показать итоговое значение

compare_period_enabled · boolean · default: "false"

Сравнение периодов

Примеры

Простая круговая

type: pie
display_type: pie
dimension:
  dimension:
    kind: basic
    value: products.category
  title: Категория
measure:
  measure: sales.revenue
  title: Выручка

type: pie
display_type: donut
dimension:
  dimension:
    kind: basic
    value: products.category
  title: Категория
measure:
  measure: sales.revenue
  title: Выручка
colors:
  palette_name: categories
  values:
    "Электроника": "#3B82F6"
    "Одежда": "#10B981"
    "Продукты": "#F59E0B"
    "Прочее": "#9CA3AF"
label:
  show: true
  position: outside
  show_percentages: true
  show_dimension_values: true
legend:
  show: true
  type: detailed

type: pie
display_type: pie
dimension:
  type: dimension_hierarchy
  levels:
    - member:
        kind: basic
        value: geography.region
      title: Регион
    - member:
        kind: basic
        value: geography.city
      title: Город
    - member:
        kind: basic
        value: stores.name
      title: Магазин
measure:
  measure: sales.revenue
  title: Выручка
  data_point_actions:
    - id: "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      key: "common:view_raw_data"
      title: "Исходные данные"

type: pie
display_type: donut

selectable_dimension:
  type: single
  hint: Разрез
  options:
    - dimension:
        kind: basic
        value: products.category
      title: По категориям
    - dimension:
        kind: basic
        value: products.brand
      title: По брендам
    - dimension:
        kind: basic
        value: managers.name
      title: По менеджерам

selectable_measure:
  type: single
  hint: Показатель
  options:
    - measure: sales.revenue
      title: Выручка
    - measure: sales.quantity
      title: Количество
    - measure: orders.count
      title: Заказы

legend:
  show: true
  type: compact

type: pie
display_type: pie
dimension:
  dimension:
    kind: basic
    value: products.category
  title: Категория
measure:
  measure: sales.revenue
  title: Выручка
  data_point_actions:
    - id: "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      key: "dashboard:drill_through"
      title: "Товары категории"
      target_page_id: "a1b2c3d4-5678-90ab-cdef-1234567890ab"
      filter_mappings:
        - target_filter_id: "b2c3d4e5-6789-01bc-def0-234567890abc"
          sources:
            - type: data_point_dimension
              member_name: products.category

type: pie
display_type: donut
dimension:
  dimension:
    kind: basic
    value: products.category
  title: Категория
measure:
  measure: sales.revenue
  title: Выручка
show_totals: true
label:
  show: true
  position: inside
  show_values: true
  show_percentages: false
  percentage_threshold: 3.0
legend:
  show: true
  type: detailed
  truncate_item_chars: 15

---

См. также

Иерархии измерений

Drill-down в диаграммах

Действия с данными

Клики и drill-through

Выбираемые поля

Динамический выбор

---

← Столбчатые диаграммы | → Динамические графики