Действия с данными (Data Point Actions)

Data Point Actions позволяют добавлять интерактивные действия при клике на элементы графика.

Обзор

Действия привязываются к точкам данных (ячейкам таблицы, столбцам диаграммы, секторам круговой диаграммы). При клике появляется контекстное меню с доступными действиями.

Типы действий

Ключ	Описание
`link:open`	Открыть ссылку
`dashboard:drill_through`	Переход на страницу дашборда
`dashboard:another_dashboard_drill_through`	Переход на другой дашборд
`custom:*`	Кастомное действие (не поддерживается)

Поддержка в графиках

График	Где определяется
Tile	`data_point_actions` на уровне графика
Table v2	`data_point_actions` на уровне колонки
Pivot Table v2	`data_point_actions` на уровне меры
Bar v2	`data_point_actions` на уровне меры
Pie	`data_point_actions` на уровне меры

Структура действия

string

required

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

id: "f47ac10b-58cc-4372-a567-0e02b2c3d479"

string

required

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

Show Доступные ключи

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

string

required

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

IconReference

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

Show Структура IconReference

string

required

Библиотека иконок: lucide

string

required

Имя иконки

Имя	Описание
`copy`	Копировать
`external-link`	Внешняя ссылка
`arrow-right`	Стрелка вправо
`eye`	Просмотр
`table`	Таблица
`share`	Поделиться

RGBColor

Цвет иконки [R, G, B]

icon:
  library: lucide
  name: external-link
  color: [66, 133, 244]

DataPointActionPlacement

Позиционирование в контекстном меню

Show Структура DataPointActionPlacement

Путь в подменю

menu_path: ["Экспорт", "Подменю"]

ActionGroup

Группа действий

Show Структура ActionGroup

string

required

ID группы

string

Заголовок группы

number

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

number

Порядок внутри группы

placement:
  group:
    id: "navigation"
    label: "Навигация"
    order: 1
  order: 1

Типы действий

Copy Value — Копировать значение

Копирует значение ячейки в буфер обмена.

data_point_actions:
  - id: "f47ac10b-58cc-4372-a567-0e02b2c3d479"
    key: "common:copy_value"
    title: "Копировать значение"
    icon:
      library: lucide
      name: copy

View Raw Data — Исходные данные

Открывает модальное окно с исходными данными.

data_point_actions:
  - id: "a1b2c3d4-5678-90ab-cdef-1234567890ab"
    key: "common:view_raw_data"
    title: "Показать данные"
    icon:
      library: lucide
      name: table

Link Open — Открыть ссылку

Открывает URL с подстановкой значений.

string

required

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

url: "https://crm.example.com/order/{orders.order_id}"

enum

default:"new_tab"

Где открывать ссылку

Значение	Описание
`same_tab`	В текущей вкладке
`new_tab`	В новой вкладке

data_point_actions:
  - id: "b2c3d4e5-6789-01bc-def0-234567890abc"
    key: "link:open"
    title: "Открыть в CRM"
    icon:
      library: lucide
      name: external-link
    url: "https://crm.example.com/order/{orders.order_id}"
    open_in: new_tab

Используйте {cube.member} для подстановки значений из точки данных. Например, {orders.order_id} подставит ID заказа.

Drill Through — Переход на страницу дашборда

Переход на другую страницу текущего дашборда с передачей фильтров.

string

required

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

DrillThroughFilterMapping[]

Маппинг фильтров (см. раздел ниже)

data_point_actions:
  - id: "c3d4e5f6-7890-12cd-ef01-34567890abcd"
    key: "dashboard:drill_through"
    title: "Детали категории"
    target_page_id: "d4e5f6a7-8901-23de-f012-456789abcdef"
    filter_mappings:
      - target_filter_id: "e5f6a7b8-9012-34ef-0123-56789abcdef0"
        sources:
          - type: data_point_dimension
            member_name: products.category

Another Dashboard Drill Through — Переход на другой дашборд

Переход на страницу другого дашборда.

string

required

UUID целевого дашборда

string

required

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

boolean

default:"false"

Открывать в новой вкладке браузера

DrillThroughFilterMapping[]

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

data_point_actions:
  - id: "f6a7b8c9-0123-45f0-1234-6789abcdef01"
    key: "dashboard:another_dashboard_drill_through"
    title: "Открыть отчёт продаж"
    target_dashboard_id: "a7b8c9d0-1234-56a1-2345-789abcdef012"
    target_page_id: "b8c9d0e1-2345-67b2-3456-89abcdef0123"
    open_in_new_tab: true
    filter_mappings:
      - target_filter_id: "c9d0e1f2-3456-78c3-4567-9abcdef01234"
        sources:
          - type: source_dashboard_filter
            source_filter_id: "d0e1f2a3-4567-89d4-5678-abcdef012345"

Custom Action — Кастомное действие

Произвольное действие с дополнительной конфигурацией.

Dict

Дополнительные параметры для обработчика

data_point_actions:
  - id: "e1f2a3b4-5678-90e5-6789-bcdef0123456"
    key: "myapp:send_to_slack"
    title: "Отправить в Slack"
    icon:
      library: lucide
      name: share
    config:
      channel: "#sales-alerts"
      template: "Новый заказ: {orders.order_number}"

Маппинг фильтров (Filter Mappings)

Определяет, как данные из точки клика передаются в фильтры целевой страницы.

Структура

string

required

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

FilterSource[]

required

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

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

data_point_dimension

Берёт значение измерения из точки клика.

"data_point_dimension"

required

Тип источника

string

required

Имя измерения

sources:
  - type: data_point_dimension
    member_name: products.category

data_point_time_dimension

Берёт значение временного измерения с учётом гранулярности.

"data_point_time_dimension"

required

Тип источника

string

required

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

enum

Гранулярность (опционально)

sources:
  - type: data_point_time_dimension
    member_name: sales.created_at
    granularity: month

source_dashboard_filter

Передаёт значение фильтра с текущей страницы.

"source_dashboard_filter"

required

Тип источника

string

required

UUID фильтра на текущей странице

sources:
  - type: source_dashboard_filter
    source_filter_id: "f2a3b4c5-6789-01f6-7890-cdef01234567"

Пример комплексного маппинга

filter_mappings:
  # Передать категорию из точки клика
  - target_filter_id: "a3b4c5d6-7890-12a7-8901-def012345678"
    sources:
      - type: data_point_dimension
        member_name: products.category
  
  # Передать период из текущего фильтра
  - target_filter_id: "b4c5d6e7-8901-23b8-9012-ef0123456789"
    sources:
      - type: source_dashboard_filter
        source_filter_id: "c5d6e7f8-9012-34c9-0123-f01234567890"
  
  # Передать месяц из точки клика
  - target_filter_id: "d6e7f8a9-0123-45d0-1234-012345678901"
    sources:
      - type: data_point_time_dimension
        member_name: sales.created_at
        granularity: month

Полные примеры

type: table_v2
columns:
  - type: dimension
    member:
      kind: basic
      value: orders.order_number
    title: Номер заказа
    data_point_actions:
      - id: "e7f8a9b0-1234-56e1-2345-123456789012"
        key: "common:copy_value"
        title: "Копировать номер"
        icon:
          library: lucide
          name: copy
        placement:
          order: 1
      
      - id: "f8a9b0c1-2345-67f2-3456-234567890123"
        key: "link:open"
        title: "Открыть в CRM"
        icon:
          library: lucide
          name: external-link
        url: "https://crm.example.com/orders/{orders.order_id}"
        open_in: new_tab
        placement:
          order: 2
      
      - id: "a9b0c1d2-3456-78a3-4567-345678901234"
        key: "dashboard:drill_through"
        title: "Детали заказа"
        icon:
          library: lucide
          name: arrow-right
        target_page_id: "b0c1d2e3-4567-89b4-5678-456789012345"
        filter_mappings:
          - target_filter_id: "c1d2e3f4-5678-90c5-6789-567890123456"
            sources:
              - type: data_point_dimension
                member_name: orders.order_id
        placement:
          group:
            id: "navigation"
            label: "Навигация"
          order: 1
  
  - type: measure
    member: orders.total
    title: Сумма

type: tile
main_measure: sales.total_revenue
data_point_actions_placement: tile
data_point_actions:
  - id: "d2e3f4a5-6789-01d6-7890-678901234567"
    key: "dashboard:drill_through"
    title: "Детализация продаж"
    icon:
      library: lucide
      name: arrow-right
    target_page_id: "e3f4a5b6-7890-12e7-8901-789012345678"
    filter_mappings:
      - target_filter_id: "f4a5b6c7-8901-23f8-9012-890123456789"
        sources:
          - type: source_dashboard_filter
            source_filter_id: "a5b6c7d8-9012-34a9-0123-901234567890"

type: bar_v2
main_dimension:
  dimension:
    kind: basic
    value: products.category
  title: Категория
main_measure:
  measure: sales.revenue
  title: Выручка
  data_point_actions:
    - id: "b6c7d8e9-0123-45b0-1234-012345678901"
      key: "common:view_raw_data"
      title: "Исходные данные"
      icon:
        library: lucide
        name: table
    
    - id: "c7d8e9f0-1234-56c1-2345-123456789012"
      key: "dashboard:drill_through"
      title: "Товары категории"
      icon:
        library: lucide
        name: arrow-right
      target_page_id: "d8e9f0a1-2345-67d2-3456-234567890123"
      filter_mappings:
        - target_filter_id: "e9f0a1b2-3456-78e3-4567-345678901234"
          sources:
            - type: data_point_dimension
              member_name: products.category

См. также

Базовые типы

IconReference и другие типы

Таблицы

Действия в таблицах

Сводные таблицы

Действия в сводных таблицах

← Иерархии измерений | → Условное форматирование

Начало работы

Аналитика для ресторанов

BI функционал

Интеграции

Обзор

Типы действий

Поддержка в графиках

Структура действия

Типы действий

Copy Value — Копировать значение

View Raw Data — Исходные данные

Link Open — Открыть ссылку

Drill Through — Переход на страницу дашборда

Another Dashboard Drill Through — Переход на другой дашборд

Custom Action — Кастомное действие

Маппинг фильтров (Filter Mappings)

Структура

data_point_dimension

data_point_time_dimension

source_dashboard_filter

Пример комплексного маппинга

Полные примеры

Рекомендации

См. также

Базовые типы

Таблицы

Сводные таблицы