> ## Documentation Index
> Fetch the complete documentation index at: https://iyree.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Сводные таблицы (Pivot Table)

> Сводные таблицы для многомерного анализа данных

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

### Поля

**type** `"pivot_table_v2"` *required*

Тип графика

**columns** `PivotTableColumn[]`

Измерения в колонках таблицы. Используйте либо `columns`, либо `selectable_columns`.

**Структура PivotTableColumn**

**type** `enum` (default: dimension)

Тип: `dimension`

**member** `CubeDimension` *required*

Измерение

**Структура CubeDimension**

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

```yaml theme={null}
kind: basic
value: products.category
```

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

```yaml theme={null}
kind: time
value:
  dimension: sales.created_at
  granularity: month
```

**title** `string`

Заголовок колонки

```yaml theme={null}
columns:
  - member:
      kind: time
      value:
        dimension: sales.created_at
        granularity: month
    title: Месяц
```

**selectable\_columns** `SelectableField`

Выбираемые измерения для колонок (вместо `columns`)

**Структура SelectableField**

**type** `enum` *required*

Тип выбора: `single` | `multiple`

**hint** `string`

Подсказка для пользователя

**options** `SelectableOption[]` *required*

Варианты для выбора

**Структура SelectableOption**

**member** `CubeDimension` *required*

Измерение

**title** `string`

Заголовок варианта

**selected** `boolean`

Выбрано по умолчанию (для multiple)

```yaml theme={null}
selectable_columns:
  type: single
  hint: Выберите период
  options:
    - member:
        kind: time
        value:
          dimension: sales.created_at
          granularity: week
      title: По неделям
    - member:
        kind: time
        value:
          dimension: sales.created_at
          granularity: month
      title: По месяцам
```

**rows** `PivotTableRow[]`

Измерения в строках таблицы. Используйте либо `rows`, либо `selectable_rows`.

**Типы строк**

### dimension — Простое измерение

**type** `"dimension"` (default: dimension)

Тип строки

**member** `CubeDimension` *required*

Измерение

**title** `string`

Заголовок

**column\_width** `number`

Ширина колонки

**conditional\_formatting** `DimensionConditionalFormatting`

Форматирование по значениям

```yaml theme={null}
conditional_formatting:
  type: text
  values:
    "Иванов": [33, 150, 243]
    "Петров": [76, 175, 80]
```

***

### dimension\_hierarchy — Иерархия с drill-down

**type** `"dimension_hierarchy"` *required*

Тип строки

**title** `string`

Общий заголовок

**levels** `HierarchyLevel[]` *required*

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

```yaml theme={null}
levels:
  - member:
      kind: basic
      value: geography.country
    title: Страна
  - member:
      kind: basic
      value: geography.region
    title: Регион
  - member:
      kind: basic
      value: geography.city
    title: Город
```

***

### dimension\_row\_grouping — Группировка строк

**type** `"dimension_row_grouping"` *required*

Тип строки

**title** `string`

Заголовок

**levels** `HierarchyLevel[]` *required*

Уровни группировки

**selectable\_rows** `SelectableField`

Выбираемые измерения для строк (структура аналогична `selectable_columns`)

**measures** `PivotTableMeasure[]`

Меры для отображения. Используйте либо `measures`, либо `selectable_measures`.

**Структура PivotTableMeasure**

**type** `"measure"` (default: measure)

Тип поля

**member** `string` *required*

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

**title** `string`

Заголовок

**column\_width** `number`

Ширина колонки (em)

**conditional\_formatting** `PivotTableMeasureConditionalFormatting`

Условное форматирование

**Структура**

**conditional\_formatting** `MeasureConditionalFormatting` *required*

Настройки форматирования (вложенный объект)

```yaml theme={null}
type: background
filling_type: gradient
gradient:
  type: three_colors
  palette: red_white_green
  thresholds:
    min_value: 0
    middle_value: 100
    max_value: 150
```

**display\_in\_totals** `boolean` (default: false)

Показывать форматирование в итоговых строках

```yaml theme={null}
conditional_formatting:
  conditional_formatting:
    type: background
    filling_type: gradient
    gradient:
      type: three_colors
      palette: red_yellow_green
  display_in_totals: true
```

**linear\_indicator** `PivotTableMeasureLinearIndicator`

Линейный индикатор

**Структура**

**main\_color** `RGBColor` *required*

Основной цвет `[R, G, B]`

**negative\_color** `RGBColor`

Цвет для отрицательных значений

**display\_in\_totals** `boolean` (default: false)

Показывать в итогах

**scope** `enum` (default: column)

Область расчёта: `column` | `table`

```yaml theme={null}
linear_indicator:
  main_color: [66, 133, 244]
  negative_color: [234, 67, 53]
  display_in_totals: false
  scope: column
```

**data\_point\_actions** `DataPointActionDefinition[]`

Действия при клике на ячейку.

**Структура 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*

Текст в меню

**target\_page\_id** `string`

UUID целевой страницы

**filter\_mappings** `DrillThroughFilterMapping[]`

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

```yaml theme={null}
measures:
  - member: sales.revenue
    title: Выручка
  - member: sales.quantity
    title: Количество
```

**selectable\_measures** `SelectableMeasureField`

Выбираемые меры

**Структура SelectableMeasureField**

**type** `enum` *required*

Тип: `single` | `multiple`

**hint** `string`

Подсказка

**options** `SelectableMeasureOption[]` *required*

Варианты

**Структура опции**

**member** `string` *required*

Имя меры

**title** `string`

Заголовок

**selected** `boolean`

Выбрано по умолчанию

```yaml theme={null}
selectable_measures:
  type: multiple
  hint: Выберите показатели
  options:
    - member: sales.revenue
      title: Выручка
      selected: true
    - member: sales.quantity
      title: Количество
      selected: true
    - member: sales.margin
      title: Маржа
      selected: false
```

**compare\_period\_enabled** `boolean` (default: false)

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

**fixed\_dimension\_columns** `boolean` (default: true)

Зафиксировать колонки измерений при горизонтальном скролле

**include\_rows\_totals** `boolean` (default: false)

Показать итоги по строкам

**include\_columns\_totals** `boolean` (default: false)

Показать итоги по колонкам

**toned** `boolean` (default: false)

Чередование цвета строк (зебра)

**period\_diff** `boolean` (default: false)

Добавить колонку разницы периодов

**sorting** `PivotTableSorting[]`

Сортировка данных

**Структура PivotTableSorting**

**member** `string` *required*

Имя меры или измерения для сортировки

**direction** `enum` *required*

Направление: `asc` | `desc`

```yaml theme={null}
sorting:
  - member: sales.revenue
    direction: desc
```

### Примеры

```yaml Базовая сводная таблица theme={null}
type: pivot_table_v2
columns:
  - member:
      kind: time
      value:
        dimension: sales.created_at
        granularity: month
    title: Месяц
rows:
  - member:
      kind: basic
      value: products.category
    title: Категория
measures:
  - member: sales.revenue
    title: Выручка
  - member: sales.quantity
    title: Количество
include_rows_totals: true
include_columns_totals: true
```

```yaml С иерархией и форматированием theme={null}
type: pivot_table_v2
columns:
  - member:
      kind: time
      value:
        dimension: sales.created_at
        granularity: quarter
    title: Квартал
rows:
  - type: dimension_hierarchy
    title: Расположение
    levels:
      - member:
          kind: basic
          value: stores.region
        title: Регион
      - member:
          kind: basic
          value: stores.city
        title: Город
      - member:
          kind: basic
          value: stores.name
        title: Магазин
measures:
  - member: sales.revenue
    title: Выручка
    linear_indicator:
      main_color: [76, 175, 80]
      scope: column
  - member: sales.plan_completion
    title: Выполнение плана %
    conditional_formatting:
      conditional_formatting:
        type: background
        filling_type: gradient
        gradient:
          type: three_colors
          palette: red_yellow_green
          thresholds:
            min_value: 0
            middle_value: 100
            max_value: 150
      display_in_totals: true
fixed_dimension_columns: true
toned: true
include_rows_totals: true
sorting:
  - member: sales.revenue
    direction: desc
```

```yaml С выбираемыми полями theme={null}
type: pivot_table_v2

selectable_columns:
  type: single
  hint: Период
  options:
    - member:
        kind: time
        value:
          dimension: sales.created_at
          granularity: week
      title: Неделя
    - member:
        kind: time
        value:
          dimension: sales.created_at
          granularity: month
      title: Месяц

selectable_rows:
  type: single
  hint: Разрез
  options:
    - member:
        kind: basic
        value: products.category
      title: Категория
    - member:
        kind: basic
        value: managers.name
      title: Менеджер

selectable_measures:
  type: multiple
  hint: Показатели
  options:
    - member: sales.revenue
      title: Выручка
      selected: true
    - member: sales.orders_count
      title: Заказы
      selected: true
    - member: sales.average_check
      title: Средний чек
      selected: false

include_rows_totals: true
```

***

## См. также

> [card] [Иерархии измерений](../features/dimension-hierarchy)
>
> Drill-down и группировка

> [card] [Условное форматирование](../features/conditional-formatting)
>
> Цвета и градиенты

> [card] [Выбираемые поля](../features/selectable-fields)
>
> Динамический выбор полей

> [card] [Сортировка](../features/sorting)
>
> Настройка порядка данных

***

← [Таблицы](./table) | → [Столбчатые диаграммы](./bar)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.