> ## 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.

# Плитка (Tile)

> График для отображения ключевых показателей (KPI)

![Пример Tile графика](https://mintcdn.com/iyree/FQ4T7mYKeF5sFfiR/assets/img/charts/tile/tile_example.png?fit=max\&auto=format\&n=FQ4T7mYKeF5sFfiR\&q=85\&s=b6ff4c211f08b313030484b7a69d0d94)

График типа Tile предназначены для отображения ключевых показателей (KPI) — одиночных числовых значений с опциональными дополнениями.

***

### Поля

**type** `"tile"` *required*

Тип графика

**main\_measure** `string` *required*

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

```yaml Пример theme={null}
main_measure: sales.total_revenue
```

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

Включить сравнение с предыдущим периодом. При включении отображает разницу (абсолютную и процентную) между текущим и предыдущим периодом. Работает, только если у фильтра периода на странице задано compare\_period\_enabled: true.

**compare\_formatting\_direction** `enum` (default: more\_better)

Определяет цветовое форматирование изменения значения при сравнении периодов.

**Значения**

| Значение | Описание | Рост | Падение |
| - | - | - | - |
| `more_better` | Больше — лучше | 🟢 Зелёный | 🔴 Красный |
| `less_better` | Меньше — лучше | 🔴 Красный | 🟢 Зелёный |
| `none` | Без цветовой индикации | — | — |

```yaml Пример theme={null}
compare_formatting_direction: more_better
```

**data\_point\_actions\_placement** `enum`

Определяет, где появляется меню действий при клике.

**Значения**

| Значение | Описание |
| - | - |
| `data_point` | Меню появляется при клике на значение |
| `tile` | Меню появляется при клике на всю плитку |

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

Список действий, доступных при клике на плитку.

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

**id** `string` *required*

Уникальный идентификатор действия (UUID)

**key** `string` *required*

Ключ действия в формате `namespace:action`

| Ключ | Описание |
| - | - |
| `common:copy_value` | Копировать значение |
| `common:view_raw_data` | Просмотр исходных данных |
| `link:open` | Открыть ссылку |
| `dashboard:drill_through` | Переход на страницу дашборда |
| `dashboard:another_dashboard_drill_through` | Переход на другой дашборд |

**title** `string` *required*

Текст, отображаемый в меню

**icon** `IconReference`

Иконка действия

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

**library** `string` *required*

Библиотека иконок. Поддерживается: `lucide`

**name** `string` *required*

Имя иконки (например: `arrow-up`, `trending-down`, `copy`)

**color** `RGBColor`

Цвет иконки `[R, G, B]` (0-255)

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

ID целевой страницы (для `dashboard:drill_through`)

**target\_dashboard\_id** `string`

ID целевого дашборда (для `dashboard:another_dashboard_drill_through`)

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

Маппинг фильтров для drill-through

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

**target\_filter\_id** `string` *required*

ID фильтра на целевой странице

**sources** `FilterSource[]` *required*

Источники данных для фильтра

**Типы источников**

**source\_dashboard\_filter** — значение фильтра текущего дашборда:

```yaml Пример theme={null}
type: source_dashboard_filter
source_filter_id: "c3d4e5f6-7890-12cd-ef01-34567890abcd"
```

**data\_point\_dimension** — значение измерения из точки клика:

```yaml Пример theme={null}
type: data_point_dimension
member_name: products.category
```

**data\_point\_time\_dimension** — временное измерение:

```yaml Пример theme={null}
type: data_point_time_dimension
member_name: sales.created_at
granularity: month
```

**url** `string`

URL для открытия (для `link:open`). Поддерживает подстановку `{cube.member}`.

**open\_in** `enum`

Где открывать ссылку: `same_tab` | `new_tab`

```yaml Пример theme={null}
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: source_dashboard_filter
            source_filter_id: "c3d4e5f6-7890-12cd-ef01-34567890abcd"
```

**trendline** `TileTrendlineOptions`

Настройки линии тренда (спарклайн) под основным значением.

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

**color** `string`

HEX-цвет линии тренда

```yaml Пример theme={null}
color: "#3B82F6"
```

**time\_dimension** `TimeDimension` *required*

Временное измерение для построения тренда

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

**dimension** `string` *required*

Имя временного измерения из куба

**granularity** `enum` *required*

Гранулярность временного ряда

| Значение | Описание |
| - | - |
| `second` | Секунды |
| `minute` | Минуты |
| `hour` | Часы |
| `day` | Дни |
| `week` | Недели |
| `month` | Месяцы |
| `quarter` | Кварталы |
| `year` | Годы |

```yaml Пример theme={null}
time_dimension:
  dimension: sales.created_at
  granularity: day
```

```yaml Пример theme={null}
trendline:
  color: "#3B82F6"
  time_dimension:
    dimension: sales.created_at
    granularity: day
```

### Примеры

```yaml Простая плитка theme={null}
type: tile
main_measure: sales.total_revenue
```

```yaml Со сравнением периодов theme={null}
type: tile
main_measure: sales.total_revenue
compare_period_enabled: true
compare_formatting_direction: more_better
```

```yaml С линией тренда theme={null}
type: tile
main_measure: sales.total_revenue
trendline:
  color: "#3B82F6"
  time_dimension:
    dimension: sales.created_at
    granularity: day
```

```yaml С действиями theme={null}
type: tile
main_measure: sales.total_revenue
data_point_actions_placement: tile
data_point_actions:
  - id: "d4e5f6a7-8901-23de-f012-456789abcdef"
    key: "dashboard:drill_through"
    title: "Детализация продаж"
    icon:
      library: lucide
      name: arrow-right
    target_page_id: "e5f6a7b8-9012-34ef-0123-56789abcdef0"
    filter_mappings:
      - target_filter_id: "f6a7b8c9-0123-45f0-1234-6789abcdef01"
        sources:
          - type: source_dashboard_filter
            source_filter_id: "a7b8c9d0-1234-56a1-2345-789abcdef012"
```

***

## См. также

> [card] [Действия с данными](../features/data-point-actions)
>
> Подробнее о Data Point Actions и drill-through

> [card] [Измерения](../features/dimensions)
>
> Типы измерений и временные гранулярности

***

← [Обзор графиков](https://iyree.mintlify.site/bi/charts/index.md) | → [Таблицы](./table)


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