Иерархии, фильтры и параметры

Три вкладки окна Настройка полей датасета, кроме основной. Сама вкладка «Поля» — в разделе Настройка полей.

Иерархии

Иерархия — упорядоченный набор полей от общего уровня к детальному, например «Страна → Город → Адрес». Она задаёт порядок перехода к более подробным данным.

Вкладка Иерархии → Добавить иерархию. В окне слева список полей датасета: щёлкайте их в нужном порядке, от общего уровня к детальному. Справа задаются название, описание и тип:

Тип	Когда подходит
Уровни	Уровни лежат в разных полях: страна, город, адрес
Ссылочная (parent-child)	Дерево хранится ссылками на родителя в тех же строках — например, оргструктура

Как иерархия работает в виджете

Готовая иерархия кладётся на полку Категория как обычное поле — виджет строится по её верхнему уровню. Дальше работает проваливание:

1. Щелчок по строке или элементу графика опускает виджет на уровень ниже — по стране на её города, по категории на товары.
2. Над виджетом появляется путь: значок дома и пройденные значения через стрелки. Щелчок по любому шагу возвращает на этот уровень, дом — к самому верхнему.
3. Виджет запрашивает данные заново: измерением берётся поле нужного уровня, а пройденные значения превращаются в условия отбора. Поэтому цифры на каждом уровне сходятся с фильтрами, которые вы видите.

Путь не сохраняется в виджете

Проваливание живёт только в текущем просмотре: виджет от этого не меняется и «грязным» не становится. Смена виджета или самой иерархии сбрасывает путь на верхний уровень.

Не у всех типов

Иерархию нельзя положить в сводную таблицу и в гистограмму — типы виджетов. У остальных типов проваливание доступно, пока текущий уровень не последний: на самом глубоком уровне щелчок уже ничего не делает.

У ссылочной иерархии вместо списка уровней указываются три поля: Ключ — что идентифицирует запись, Родитель — ссылка на вышестоящую, Подпись — что показывать (по умолчанию совпадает с ключом). В списке иерархий такая помечена значком parent-child.

Название и описание иерархии правятся по месту, как у полей.

Фильтры датасета

Условия отбора строк, заданные один раз на весь датасет: они действуют во всех виджетах, построенных на нём, и накладываются до соединения таблиц.

Вкладка Фильтры → Добавить условие открывает список полей датасета с поиском; выбранное поле добавляется строкой, где видно само поле, таблицу-источник и условие. Типичные примеры — только оплаченные заказы или только текущий год. Пока условий нет, виджеты видят датасет целиком.

Условие задаётся так же, как на полке фильтров виджета: оператор выбирается по типу поля, а форма ввода зависит от оператора — набор операторов. Разница только в области действия: фильтр датасета применяется к любой выборке из него, и снять его в отдельном виджете нельзя.

Не путайте с фильтрами виджета: те действуют на одну визуализацию, эти — на весь датасет.

Параметры

Параметр — именованное значение, вынесенное из формулы в отдельную настройку датасета. Формула подставляет его по ссылке в фигурных скобках:

SUM([Выручка]) * (1 - {Скидка})

Здесь {Скидка} — параметр. Скобки различаются: в квадратных пишутся поля, в фигурных — параметры.

Параметр нужен там, где одна и та же величина повторяется в нескольких формулах и время от времени пересматривается: ставка, курс, порог, размер скидки. Она хранится в одном месте, и менять её достаточно там — вместо правки каждой формулы.

Вкладка Параметры → Добавить параметр. В форме задаются:

Поле	Что указать
Имя	Под ним параметр подставляется в формулу: {Имя}
Описание	Для чего он нужен, необязательно
Тип значения	Число, строка, дата, дата и время или логический
Допустимые значения	Любое — поле ввода; Список — выпадающий список из заданных значений с подписями; Диапазон — число с минимумом, максимумом и шагом
Значение по умолчанию	Обязательно: с ним считается виджет, пока пользователь не задал своё

Больше 50 параметров у датасета быть не может — кнопка добавления становится неактивной.

Как параметр действует при просмотре

Читатель значение параметра не меняет

В текущей версии виджеты и дашборды всегда считаются со значением по умолчанию: элемента, где читатель задал бы своё значение, в интерфейсе нет — ни в виджете, ни в его редакторе, ни среди объектов дашборда. Чтобы величина изменилась для всех, её правят в самом датасете, в этой же форме.

Например, полю с формулой [orders.amount] * (1 - {Скидка} / 100) при значении по умолчанию 10 виджет показывает 121 215 150 из 134 683 500: параметр применился, но задать вместо него 50 при просмотре нечем.

Это не сбой, а незаконченная возможность: значение параметра платформа считает правильно, не хватает элемента, которым читатель задал бы своё. Команде разработки это передано — до появления такого элемента считайте параметр способом хранить величину в одном месте, а не инструментом «что если» для читателя.

Другое значение при чтении данных принимает REST API: в теле запроса POST /api/widget/{id}/data рядом с описанием полок передаётся объект parameters, где ключ — имя параметра:

curl -s -X POST -H "Authorization: Bearer $T" -H "Content-Type: application/json" \
  -d '{
        "type": "table",
        "rows": [],
        "columns": [{ "id": "c1", "field": "amount_disc", "table": null,
                      "sql": "SUM([amount_disc])", "alias": "Со скидкой", "settings": {} }],
        "series": [], "filters": [], "sorts": [],
        "parameters": { "Скидка": 50 }
      }' \
  http://<адрес>/api/widget/1589/data

Тот же запрос без блока parameters вернул 121 215 150 — расчёт со значением по умолчанию 10, а с ним 67 341 750. Виджет при этом не меняется: значение действует только на этот запрос.

Через MCP так значение не подставить

Инструменты AI-помощника меняют у параметра значение по умолчанию (dataset_parameter_update) — то есть сразу для всех, кто откроет виджет. Разовая подстановка на один запрос есть только в REST API, показанном выше — AI-помощник и MCP.

Поэтому область допустимых значений — «Любое», «Список», «Диапазон» — сейчас работает как подсказка и проверка для того, кто редактирует датасет: она ограничивает, какое значение по умолчанию можно ввести в форме.

Прав на датасет читателю при этом не нужно: параметр подставляется в формулу на сервере при расчёте виджета, поэтому наблюдатель, который датасет не открывает, видит то же число, что и его автор.

Что дальше

Формулы, которые считают новые значения, — в разделе Вычисляемые поля.